内容导读

• 准备一台Linux主机
• 启动Rancher服务器，进入Rancher UI
• 如何在Rancher UI下添加一个主机
• 如何导入现有的Kubernetes集群
• 如何在Rancher UI下添加一个容器
• 启动Calalog应用
• 如何使用高级Kubernetes选项

9月27日北京海航万豪酒店，在Rancher Labs举办的容器技术大会Rancher Container Day 2017上，Rancher Labs的CEO及联合创始人梁胜博士亲自发布了Rancher容器管理平台的重大版本——Rancher 2.0的Tech Preview。

在Rancher 2.0中，Cattle用户依然可以享受和以前一样的易于使用的用户体验，还可以额外地利用Kubernetes编排引擎的优势，包括其丰富的基础设施插件、增强的RBAC功能和原生生态系统服务。而Kubernetes用户能在同一平台上管理任何Kubernetes集群，轻松地充分利用Kubernetes的强大能力及其迅速壮大的生态系统。通过基于Kubernetes、简单直观的用户体验，Rancher 2.0将加快Kubernetes在企业中的普及。

在本指南中，你将会了解如何快速上手Rancher v2.0。本文将涉及以下内容：

• 准备一台Linux主机
• 启动Rancher服务器，进入Rancher UI
• 在Rancher UI下添加一个主机
• 导入现有的Kubernetes集群
• 在Rancher UI下添加一个容器

另外我们还将包含一部分进阶内容，比如：

• 启动Calalog应用
• 使用高级Kubernetes选项

准备一台Linux主机

在开始之前，你需要为Linux主机安装Docker的兼容版本：

• Docker v1.12.6
• Docker v1.13.1
• Docker v17.03-ce
• Docker v17.06-ce

对Linux主机的要求

准备一台64位主机，系统Ubuntu16.04，至少4GB的内存，内核版本3.10+； 在主机上安装兼容的Docker版本，关于如何在服务器上安装Docker，请参考此教程。

启动Rancher Server

只需一条命令和几分钟时间，你就可以安装并启动Rancher Server。安装完成后，打开Web浏览器就能访问Rancher UI。

如何启动Rancher Server

第一步： 在你的主机上执行如下的Docker命令

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

这一步骤需要花费几分钟来完成

第二步： 在浏览器中输入http://<SERVER_IP>:8080就可以访问Rancher UI，这里的<SERVER_IP>里要填你主机的IP地址。Rancher可以自动部署和管理Kubernetes，UI界面会展示一个Welcome的页面，其中包含两项有关添加主机的选项。

注意：最开始，Rancher会为你创建一个默认的集群和环境。Rancher能够将资源分组到多个集群和环境中。每个集群都是一组物理（或虚拟）的计算资源。每个环境绑定一个集群，并在集群的主机上运行其容器，而你可以将一个集群共享给多个环境。环境是用来定义应用程序、服务和容器的命名空间。环境中的容器可以通过共享的可管理网络相互通信，你可以通过向不同的用户／组分配访问权限来管理环境中的资源。

第三步： 选择添加主机的一个选项，然后进入到如下的相关部分：

添加主机 – 如果你想要在Rancher中管理主机，请点击此选项。你可以添加一个已有的、安装好了Docker的主机，亦可以添加其他云服务商提供的新主机（后文会有详解）。 使用现有的Kubernetes – 如果你希望集群提供者可以在Rancher外部管理主机，请点击此选项。你可以导入已有的Kubernetes（后文会有详解）。

添加主机

在这里你可以添加来自Rancher v2.0支持的云服务商的主机，也可以添加自定义主机。如果在UI界面没有看到你的云服务商，不要着急，只需选择自定义主机选项即可。

如果你想添加自定义的主机，需要注意这些要求：

• 通常，Rancher会自动检测IP地址来注册主机
  • 如果主机位于NAT后或是正在运行rancher/server容器的同一机器上，你可能需要指定它的IP地址。想要指定IP地址，请点击Show advanced选项，然后输入注册IP地址。
• 主机代理会启动与服务器的连接，因此你需要确保防火墙或者安全组允许它通过命令能够到达URL。
• 环境中的所有主机必须允许彼此间的流量能够进行跨主机联网。
  • IPSec：500/udp和4500/udp
  • VXLAN：4789/udp

添加来自云服务商的主机

第一步： 在添加主机页面，选择你的云服务商：

• Amazon EC2
• Microsoft Azure
• DigitalOcean
• Packet

第二步： 按照Rancher UI界面的说明添加主机。这一过程可能需要几分钟。当主机添加成功，你就可以在Hosts页面看到它的状态

添加一个自定义主机

第一步： 在添加主机页面，点击“自定义”，输入docker命令，比如：

sudo docker run --rm --privileged -v /var/run/docker.sock:/var/run/docker.sock -v /var/lib/rancher:/var/lib/rancher rancher/agent:v2.0-alpha2 http://<SERVER_IP>:8080/v3/scripts/D5433C26EC51325F9D98:1483142400000:KvILQKwz1N2MpOkOiIvGYKKGdE 

注意：命令中的IP地址必须对应你的<SERVER_IP>而且必须能够从主机内部访问。

第二步： 在你的主机上复制、粘贴并运行该命令，就可以把你的主机注册到Rancher上。这一过程需要几分钟完成。

第三步： 点击“关闭”。在Hosts页面就可以看到主机的状态。

导入Kubernetes集群

在Rancher v2.0中，你可以导入已有的在外部安装的Kubernetes v1.7以上版本。这种情况下，集群提供商可以在Rancher之外管理你的主机。我们支持像Google Container Engine、Azure Container Service、IBM Bluemix这样的托管服务，你也可以导入你自己的Kubernetes集群。

如何导入Kubernetes集群

第一步： 复制、粘贴UI界面的kubectl命令，在你的集群中执行它。

第二步： 点击“关闭”，在Hosts页面，你就可以看到Kubernetes节点的状态。

添加容器

在你向环境中添加了至少一个主机或集群后，可能会需要几分钟来启动所有的Rancher系统服务。想要验证自己的环境，那么在“默认”菜单中选择“系统”。如果服务正常，将会显示状态为绿色。

当确认所有的系统服务均正常启动后，就可以创建你的第一个容器了。

如何添加容器

第一步： 在Rancher UI菜单，点击“容器”

第二步： 点击“添加容器”，进入添加容器页面

第三步： 输入“名称”，比如“first-container”

第四步： 输入一个Docker Hub上托管的Docker Image

第五步： 点击“启动”。该步骤需要几分钟来完成。当容器开始启动，就可以在“容器”页面看到它的状态

到目前为止你已经添加了主机，并且启动了第一个容器，接下来将介绍Rancher v2.0的新特性。

启动Catalog应用

Rancher提供了一个catalog应用模板来部署复杂的应用。

如何启动catalog应用

第一步： 在Rancher UI菜单，点击Apps，进入Application页面

第二步： 点击Launch from Catalog，显示可用的catalog应用模板

第三步： 找到你想要启动的模板，点击View Details

第四步： 完成必要的填写

注意：docker-compose.yml和rancher-compose.yml文件与生成应用有关。在启动堆栈前点击Preview即可查看它们。

第五步： 点击Launch，在Application页面，你会看到Rancher正在为你的新应用创建堆栈。这一过程需要几分钟时间。

如果服务正常启动，新堆栈的状态将显示为绿。

使用高级Kubernetes选项

在Rancher UI界面，你只需一键点击即可进入本地的Kubernetes dashboard。

你也可以从web浏览器上执行kubectl。Kubernetes CLI或者kubectl都可以帮助你部署和管理Kubernetes应用。有关更多信息以及下载kubectl，请访问Kubernetes documentation。

另外，你可以创建一个Kubernetes配置文件，以便在桌面上使用kubectl。Kubernetes配置文件（即kubeconfig）允许你配置一个或多个集群的访问。

如何使用高级kubernets选项

第一步： 在Rancher UI菜单，点击Containers。

第二步： 选择Advanced标签，将出现下列高级选项：

• Launch Dashboard – 在新浏览器窗口中访问本地Kubernetes dashboard
• Launch kubectl – 使用shell从浏览器运行kubectl命令，单击Close返回到Rancher UI界面
• Download kubeconfig – 生成一个kubeconfig文件以便在桌面使用kubectl。将～/.kube/config文件中的代码复制粘贴到新文件中，然后运行kubectl。点击Close返回到Rancher UI界面。