Rancher v1.x 使用手册之四—离线安装

离线安装

不可对外访问的网络环境(内网)也是可以启动 Rancher 服务的。在这种拓扑下，可以通过内网提供的IP或者域名来访问Rancher的操作界面(UI界面)。另外，也可以用HTTP代理或者私有镜像库来配置 Rancher。

需要注意的是，在内网中启动一个 Rancher 服务会导致一些特性无效，比如:

• 使用操作界面来启动云公有云提供商(例如AWS，DigitalOcean，阿里云，vSphere等)提供的主机。只能添加自定义主机 来初始化Rancher；
• Github 授权认证。

前提条件

为了支持这种拓扑，有些 前提条件 是必须要满足的。

Rancher Server标签

Rancher Server当前版本中有2个不同的标签。对于每一个主要的release标签，我们都会提供对应版本的文档。

• rancher/server:latest 此标签是我们的最新一次开发的构建版本。这些构建已经被我们的CI框架自动验证测试。但这些release并不代表可以在生产环境部署。
• rancher/server:stable 此标签是我们最新一个稳定的release构建。这个标签代表我们推荐在生产环境中使用的版本。请不要使用任何带有 rc{n} 前缀的release。这些构建都是Rancher团队的测试构建。

使用私有镜像仓库

假设内网已经存在私有镜像仓库，或类似的支持分布式 Docker 镜像管理的服务。如果还没有，可以浏览 Docker 官网提供的 私有镜像仓库 文档来搭建，再此不再累述.

将镜像上传到镜像仓库仓库

在安装或升级Rancher服务之前，必须保证对应版本号的所有镜像(例如: rancher/server，rancher/agent，以及任何 基础服务 涉及的镜像) 都必须上传到私有仓库或者类似的服务中。如果这些镜像不存在或者版本信息不对，Rancher服务将无法正常完成安装或升级。

对于每次发布的 Rancher 服务(rancher/server)和对应的 Rancher 代理(rancher/agent)的镜像版本信息，都在发布记录中摘记。而针对其他基础服务用到的镜像版本信息，就需要查看 官方模板 的infra-templates目录和 社区模板 来获取所关联的镜像。如果用到 应用商店，还需要关注具体应用使用的docker-compose.yml来获取镜像版本信息。

使用命令行将镜像上传到镜像仓库仓库

在这个例子中，假设某台机器可以同时访问私有镜像仓库和 DockerHub。首先从 DockerHub 中拉取 rancher/server 和 rancher/agent 的镜像，然后对拉取下来的镜像做标签私仓化处理，最后再推送到私有镜像仓库。一种推荐的做法是，私有镜像仓库的镜像的版本信息对照于 DockerHub 的版本信息。

# rancher/server
$ docker pull rancher/server:v1.6.0
$ docker tag rancher/server:v1.6.0 localhost:5000/<NAME_OF_LOCAL_RANCHER_SERVER_IMAGE>:v1.6.0
$ docker push localhost:5000/<NAME_OF_LOCAL_RANCHER_SERVER_IMAGE>:v1.6.0
# rancher/agent
$ docker pull rancher/agent:v1.1.3
$ docker tag rancher/agent:v1.1.3 localhost:5000/<NAME_OF_LOCAL_RANCHER_AGENT_IMAGE>:v1.1.3
$ docker push localhost:5000/<NAME_OF_LOCAL_RANCHER_AGENT_IMAGE>:v1.1.3

注意: 对于任何基础服务镜像, 可以按照以下的步骤来获取

通过私有镜像仓库启动Rancher服务

在主机上启动Rancher Server并且使用指定的Rancher Agent镜像。我们建议使用特定的版本号来代替latest，这样可以保证您使用了正确的版本。

例如:

$ sudo docker run -d --restart=unless-stopped -p 8080:8080 \
    -e CATTLE_BOOTSTRAP_REQUIRED_IMAGE=<Private_Registry_Domain>:5000/<NAME_OF_LOCAL_RANCHER_AGENT_IMAGE>:v1.1.3 \
    <Private_Registry_Domain>:5000/<NAME_OF_LOCAL_RANCHER_SERVER_IMAGE>:v1.6.0

Rancher操作界面

默认情况下，操作界面访问(含接口API)是通过8080端口暴露的，可以用以下这个地址访问:http://<SERVER_IP>:8080。

添加主机

在操作界面，点击 添加主机后，如果是第一次添加主机会进入到主机注册地址配置界面。点击保存后即可添加主机。

由于不能使用公有云提供商的主机服务，所以请点击 自定义图标来增加主机。

操作界面上生成的主机注册命令将会使用私有镜像仓库中的Rancher Agent镜像。

一个由操作界面生成的主机注册命令例子

sudo docker run -d --privileged -v /var/run/docker.sock:/var/run/docker.sock <Private_Registry_Domain>:5000/<NAME_OF_LOCAL_RANCHER_AGENT_IMAGE>:v1.1.3 http://<SERVER_IP>:8080/v1/scripts/<security_credentials>

为基础设施服务配置默认仓库

默认在 Rancher 中, 所有 基础服务 都默认从 DockerHub上拉取镜像。可以通过 API settings(接口设置)改变默认的的仓库，比如改成私有的镜像仓库。

• 添加一个私有镜像仓库: 在 基础架构 中选择 镜像库，添加可以为基础设施服务提供镜像的仓库服务。
• 更新默认的仓库: 在 系统管理 -> 系统设置 -> 高级设置里，点击 我确认已经知道修改高级设置可能导致问题。找到 registry.default 的设置项并点击修改按钮，修改为私有镜像仓库的地址，点击 保存。一旦 registry.default 的值被更新了，基础设施服务将从这个地址上获取镜像。
• 创建一个新环境: 当默认的镜像仓库地址被改变后，需要重新创建环境以便于基础设施服务可以使用这个新的镜像仓库地址。原来旧的环境中，基础设施服务仍然指向DockerHub。

注意: 原来旧的环境中的基础设施服务，仍然使用原来默认的镜像仓库地址(例如，在出厂设置中就是 DockerHub，那就一直都是 DockerHub)。只有把应用删除，然后重新部署才能使用新的镜像仓库地址。可以通过 应用商店 中的 官方认证进行部署。

使用HTTP代理

提醒，在启动了Rancher服务以后，浏览器只要能访问内网就可以访问Rancher UI了。

通过HTTP代理来配置Docker

可以通过修改Rancher Server和Rancher Agent所在的Docker daemon的配置文件/etc/default/docker，使其指向对应的HTTP代理地址，重启Docker daemon之后，即可启用HTTP代理。

sudo vi /etc/default/docker

打开配置文件后，修改或增加 export http_proxy="http://${YOUR_PESONAL_REGISTYR_ADDRESS}/"。然后保存它并重启Docker deamon。不同的操作系统重启Docker deamon(也就是重启 Docker )的方法是不一样的，请自行了解，不再累述。

注意: 如果Docker是通过systemd来运行的，那么可以参考这篇文章来了解更多。

启动Rancher Server

使用HTTP代理的时候，Rancher Server不需要使用任何环境变量即可启动。所以，启动操作就和没有使用代理服务是一样的，指令如下:

sudo docker run -d --restart=unless-stopped -p 8080:8080 rancher/server

Rancher操作界面

默认情况下，操作界面访问(含接口API)是通过8080端口暴露的，可以用以下这个地址访问:http://<SERVER_IP>:8080。

添加主机

在操作界面，点击 添加主机后，如果是第一次添加主机会进入到主机注册地址配置界面。点击保存后即可添加主机。

由于不能使用公有云提供商的主机服务，所以请点击 自定义图标来增加主机。

操作界面上生成的主机注册命令可以用在任何配置了HTTP代理的Docker的主机上。