title: 概述

title: 概述

在 Rancher 中，主机是调度资源的基本单位(直观的理解就是所发生的操作最终都会落到某台主机上)，它可以是虚拟的或者物理的 Linux 服务器。Rancher 管理的主机需要满足以下的条件:

• 任何可以运行支持的 Docker 版本的 Linux 发行版本，例如:RancherOS，Ubuntu，RHEL/CentOS 7。不过针对 RHEL/CentOS 系列，有些需要注意的地方:
  • Docker 并不推荐使用 RHEL/CentOS 默认的存储驱动(devicemapper)，可以参考这篇文档来修改。
  • 如果启用 SELinux，需要安装额外的模块。
  • 内核版本要求是 3.10.0-514.2.2.el7.x86_64 及以上，建议使用 RHEL/CentOS 7.3 或者更高的发行版本。
• 1GB 的内存。
• 推荐 w/AES-NI 架构的 CPU。
• 主机可以通过 HTTP 或 HTTPS 来访问 Rancher Server 服务，默认端口是 8080。
• 主机与主机之间是可以相互访问的，从而确保容器之间的跨主机通信。

另外，Rancher 也可以管理由 Docker Machine 驱动的主机，只要这些主机满足上面的条件即可。

在 Rancher 的操作界面上，选择 基础架构->主机，单击 添加主机按钮，然后再做些工作，就可以让 Rancher 管理到这台新主机了。

1. Docker 版本适用对比

注意: 我们不会支持 Docker 的 edge 版本，但是我们会支持 Docker 的稳定版本。

2. 安装特定版本的 Docker

一般会使用 curl https://get.docker.com | sh 脚本来安装最新版的 Docker 。但是，最新版的 Docker 有可能不适用于正准备安装或已经在使用中的 Rancher 版本。因此，一种推荐的做法是:安装特定版本的 Docker。按照上方的对比表，选择 Rancher 适用的安装脚本执行即可。

注意: 如果从操作界面上添加云主机，可以通过 高级选项 里面的 Docker Install URL来选择需要安装的 Docker 版本。

3. 主机是如何工作的？

Rancher Agent 容器在主机上启动成功之后，这台主机就连接到了 Rancher Server 上。在添加主机->Custom(自定义)界面中的很长的 URL 就是主机注册口令。这个注册口令在主机第一次连接 Rancher Server 的时候会被用到。在注册的过程中，Rancher Server 会生成一个 Agent 账号和一个 API 密钥。之后 Agent 与 Server 直接的全部通信都要使用这个密钥，它们之间的认证逻辑和其他的 API 密钥认证逻辑是一样的。

从设计的角度而言，Rancher Agent 是运行在独立于 Rancher Server 的主机上，所以 Rancher Agent 本身是不可信的。采用接口访问密钥的机制，可以确保 Rancher Agent 只访问被授权的接口，而 Rancher Server 只响应可信的请求。但是目前是单向认证，只认证从 Rancher Agent 到 Rancher Server 的请求，并没有认证从 Rancher Server 到 Rancher Agent 的响应。因此，用户可以根据需要，使用 TLS 和证书来做校验。

每个环境的注册口令，都是由 Rancher Server 生成并保存到数据库，然后和 API 密钥一起下发给 Rancher Agent 使用。Rancher Agent 和 Rancher Server 之间是采用 AES 对称加密的点对点通讯。

4. 添加主机

第一次添加主机时，Rancher Server 会要求配置主机注册地址。这个地址可以是域名或者 IP 地址(如果 80 端口不可访问，还需要加上可访问的端口号，默认 8080)，能够访问 Rancher 接口即可。任何时候都可以改变 主机注册地址，相关操作可以查看 系统管理 下的 系统设置。设置好主机注册地址后，单击 保存.

Rancher 支持添加云提供商(例如 AWS，DigitalOcean，阿里云，vSphere 等)所提供的主机或者本地(例如 VirtualBox，VMWare 等)设置好的主机。对于云提供商，Rancher 可以通过docker-machine来添加的，所以本质上实现了 Docker Machine 驱动的厂商的云主机，都可以被添加。

接下来，选择:

• 添加自定义主机
• 添加 AWS EC2 主机
• 添加 Azure 主机
• 添加 DigitalOcean 主机
• 添加 Exoscale 主机
• 添加 Packet 主机
• 添加 Rackspace 主机
• 添加其他云提供商的主机

当主机被添加到 Rancher 时，这台主机会运行一个合适版本的rancher/agent容器。

4.1. 主机标签

在 Rancher 中，可以通过添加标签的方式来管理某台主机，做法就是在 rancher/agnet 容器启动的时候，以环境变量的方法把标签加进去。在操作界面上可以看到，标签其实是一些键不可以重复的键值对。值得注意的是，如果有两个相同的键但是值不一样，那么最后添加的值将会被 Rancher 使用。

给主机增加标签后，您可以根据需求来调度服务／负载均衡。如果不希望某个服务运行在某台主机上或者要求某个服务必须运行在某台主机上，可以在添加服务时通过主机标签来进行配置。

在您需要使用外部 DNS 服务(类似 Bind9 这类)或者通过程序来控制 DNS 记录的时候，如果所需的 IP 不是主机 IP 的话，那就要在运行 rancher/agent 时增加标签 io.rancher.host.external_dns_ip=<IP_TO_BE_USED_FOR_EXTERNAL_DNS>。切记，当要某个容器服务要使用外部 DNS 服务时，一定要增加这个标签。

通过 UI 添加云提供商的主机时，您可以在 UI 上添加主机标签，rancher/agent 会保证这些标签都会自动添加到主机上。

如果通过 UI 添加自定义主机，当增加标签时，UI 上的运行注册脚本会增加对应的环境变量:CATTLE_HOST_LABELS。比如，增加一个标签:foo=bar，会出现下面的效果:

$  sudo docker run -e CATTLE_HOST_LABELS='foo=bar' -d --privileged \
    -v /var/run/docker.sock:/var/run/docker.sock rancher/agent:v0.8.2 \
    http://<rancher-server-ip>:8080/v1/projects/1a5/scripts/<registrationToken>
# 当再增加一个标签:hello=world
$  sudo docker run -e CATTLE_HOST_LABELS='foo=bar&hello=world' -d --privileged \
    -v /var/run/docker.sock:/var/run/docker.sock rancher/agent:v0.8.2 \
    http://<rancher-server-ip>:8080/v1/projects/1a5/scripts/<registrationToken>

注意: rancher/agent 的版本与 rancher/server 的版本是相关的，执行添加自定义主机的时候，需要注意注册脚本的 rancher/agent 是否正确。正常情况下，通过操作界面获取的脚本内的版本信息都是正确的，用户不需要做额外修改。

4.2. 自动添加的标签

Rancher 会自动创建一些和 Linux 内核版本信息以及 Docker 引擎版本信息相关的标签。

5. 主机调度地址

为了使 Rancher 可以在有多个 IP 的主机上暴露端口，需要给这些主机进行配置，从而使 Rancher 知道哪些 IP 可以使用。配置调度 IP 的方法取决于这台主机是已经存在的主机(运行了 rancher/agent 容器的服务器)还是还没有添加的主机(还没有运行 rancher/agent 容器的服务器)。

5.1. 给已有主机添加调度地址

在环境中已存在的主机，可以通过增加io.rancher.scheduler.ips标签来设置调度 IP。通过操作界面，单击这台主机的编辑按钮，然后增加 调度 IP。如果是通过接口的方式，只需要给主机添加标签 io.rancher.scheduler.ips 和值(多个地址，可以通过逗号分隔)即可。

注意: 在没有添加调度地址前，如果某些容器已经暴露了端口，那么这些容器的端口暴露在0.0.0.0上。那就意味着，已有的容器已经占用了全部的 IP 地址，后来添加的调度地址也被占用了。

5.2. 给新主机添加调度地址

对于新添加的自定义主机 需要像下面的例子，给注册脚本增加一个环境变量 CATTLE_SCHEDULER_IPS :

$  sudo docker run -e CATTLE_SCHEDULER_IPS='1.2.3.4,<IP2>,..<IPN>' -d --privileged \
    -v /var/run/docker.sock:/var/run/docker.sock rancher/agent:v0.8.2 \
    http://<rancher-server-ip>:8080/v1/projects/1a5/scripts/<registrationToken>

6. 在代理后的主机

如果当前的环境是在代理之后，要给 Rancher 添加主机，需要修改这台主机的 Docker deamon 指向代理。相关的细节可以浏览本文，在此不在累述。

7. 访问云提供商的主机

当用 Rancher 添加云提供商的主机时，实质上是采用 Docker Machine 执行的工作。

8. 克隆主机

在云提供商上启动主机需要使用访问密钥，Rancher 提供了克隆的方法，来轻松地创建另一个主机，而无需再次输入所有认证配置。在操作界面上，从 基础架构 进入 主机 页面，单击某台主机的下拉菜单，选择 克隆，然后就会进入之前的认证配置都已经填写的 添加主机 页面。

9. 修改主机

在操作界面上，从 基础架构 进入 主机 页面，单击需要修改的主机的下拉菜单，选择 编辑，就可以修改这台主机的名称，描述以及标签。

10. 启停主机

停止一台主机后，操作界面上会显示 Inactive 状态。在这种状态下，不会再有容器服务被部署到这台主机。而处于 Active 状态下的主机，容器服务会被正常的部署、停止、重启或销毁。

如果需要停止一台主机，从 基础架构 进入 主机 页面，单击需要停止的这台主机的下拉菜单，选择 停用 即可。

如果需要把一台停止的主机重新激活，从 基础架构 进入 主机 页面，单击已经停止的这台主机的下拉菜单，选择 激活 即可。

注意: 在 Rancher 中如果主机宕机了(比如处于 reconnecting 或 inactive 的状态)，需要给服务配置健康检查 以便于 Rancher 把这台宕掉的主机上的容器服务迁移到其他主机上执行。

11. 在 Rancher 内删除主机

在 Rancher 内删除主机的操作需要进行几个步骤:从 基础架构 进入 主机 页面，单击需要删除的主机的下拉菜单，选择 停用。当主机完成停止以后，将会显示 Inactive 状态。然后单击下拉菜单，选择 删除，Rancher 会执行对这台主机的删除操作。当显示 Removed 状态时，就表示这台主机已经被删除了。但是，仍然可以在操作界面上看到这台主机，只有当单击下拉菜单，选择 清理后，这台主机才会从操作界面上消失。

如果这台主机是由 Rancher 调用 docker-machiine 基于云提供商的驱动创建，按照上述的删除操作执行后，被删除的主机也会在云提供商的管理界面中消失。但是，如果是采用 添加自定义主机 的方式所添加的云提供商主机，被删除的主机还会在云提供商的管理界面中被查看到。而且这台主机内的容器服务(例如 rancher/agent)还是保留着的。可以认为通过自定义添加的云提供商的主机被删除后，只是从 Rancher 的调度中解离出去，但是它原来的生命周期 Rancher 不会干涉。

注意: 对自定义主机，包括 Rancher Agent 在内的全部容器都会保留在该主机上。同时，Rancher 网络驱动创建的docker0上的 IP 也将会保留。

12. 在 Rancher 外删除主机

在 Rancher 外删除主机，也就是意味着不是按照 Rancher 操作界面或者 API 来删除主机。最简单的例子就是，在 Rancher 集群内，有一台云提供商提供的主机。通过云提供商的管理界面删除了这台主机，这个删除行为 Rancher 是无法感知的。Rancher 会一直尝试重新连接这台已经删除的主机，并显示 Reconnecting 的状态，之后主机会显示 Disconnected 状态。 因此，为了同步回删除的状态，还需要从 基础架构 进入 主机 页面，单击已经删除的主机的下拉菜单，选择 删除。 您也可以配置一个延迟用于自动删除失联主机。这个配置叫做host.remove.delay.seconds，您可以在系统 -> 设置 -> 高级选项中找到这个配置。