注意:本入门指南的目的是让您快速的运行一个Rancher2.0环境，它不适用于生产。有关更全面的说明，请查阅Rancher安装.

本教程将指导您完成:

  • 安装Rancher v2.0 ；
  • 创建第一个集群；
  • 部署一个应用程序，如Nginx；

一、入门须知

  • 熟悉Linux基础命令；
  • 了解SSH使用方法，了解公钥/私钥工作原理；
  • 熟悉Docker基本使用方法及基础命令，比如：容器日志查看；
  • 了解SSL证书使用方法；
  • 了解负载均衡工作原理(L4/L7)；
  • 了解域名解析原理；
  • 了解K8S基本概念

二、配置Linux主机

通过配置Linux主机开始创建自定义集群。您的主机可以是:

  • 云主机
  • 本地虚拟机
  • 本地物理机

注意:在使用云主机时，您需要允许TCP/80和TCP/443入站通信端口。请查阅您的云主机文档以获取有关端口配置的信息。有关端口要求的完整列表，请查阅端口需求.

根据以下要求配置主机:

  • Ubuntu 16.04 +(64位)
  • Centos/RedHat Linux 7.5+(64位)
  • RancherOS 1.3.0+(64位)

Ubuntu操作系统有Desktop和Server版本，选择安装server版本.

1、硬件需求:

  • CPU: 2C
  • 内存: 4GB

注意:此配置仅为满足小规模测试环境的最低配置。如用于生产，请参考基础配置要求。

2、软件需求:

  • 软件: Docker
  • 支持的Docker版本:
  • 17.03.x
  • 18.06.x
  • 18.09.x

注意:有关Docker安装说明,请访问其文档。软件需求要应用于所有节点。

主机的更详细配置说明，请查看基础环境配置

三、安装Rancher

要想在主机上安装Rancher,需要先登录到主机上，接着进行以下步骤:

  1. 通过shell工具(例如PuTTy或远程终端连接)登录到主机
  2. 在shell中执行以下命令:
sudo docker run -d --restart=unless-stopped -v <主机路径>:/var/lib/rancher/ -p 80:80 -p 443:443 rancher/rancher:stable

四、登录Rancher

登录并开始使用Rancher。登录后，您将进行一些一次性配置。

  1. 打开浏览器，输入https://<server_ip>,server_ip替换为运行Rancher容器主机的ip;
  2. 因为是自动使用的自签名证书，在第一次登录会提示安全授信问题，信任即可；
  3. 设置管理员密码
    第一次登录会要求设置管理员密码，默认管理员账号为: admin

如果没有设置密码而要求输入当前密码，可以输入密码: admin

  1. 设置Rancher Server URL
    Rancher Server URL是agent节点注册到rancher serverd的地址，需要保证这个地址能够被agent主机访问，不要设置为127.0.0.1或者localhost。

五、创建K8S集群

现在创建第一个Kubernetes集群，可以使用自定义选项。您可以添加云主机、内部虚拟机或物理主机作为集群节点，节点可以运行任何一种或多种主流Linux发行版:

  1. 页面右下角可以切换语言；
  2. 在全局视图下，点击菜单中的集群 , 并点击添加集群；
  3. 选择 Custom，并设置集群名称,其他参数可不用修改，点击下一步；
  4. 选择节点运行的角色
    默认会勾选Worker角色，根据需要可以一次勾选多种角色。比如，假设我只有一个节点，那就需要把所有角色都选择上，选择后上面的命令行会自动添加相应的命令参数；
  5. 如果是云主机，需要添加主机的内网地址和对应的公网地址，如果是没有公网的云主机，可以跳过这步；
  6. 其他参数保持默认，点击命令行右侧的复制按钮，复制命令参数

如果是多台主机，根据角色的不同，需要复制多次

  1. 登录预添加集群的主机，执行以上复制的命令；
  2. 在主机上执行完命令后，最后点击完成；
  3. 回到全局视图，可以查看集群的部署状态；
  4. 点击集群名称，进入集群视图
  1. 点击菜单栏主机按钮
  2. 集群创建完成
  3. 集群创建完成后，默认会生成Default项目，点击Default切换到项目视图；

六、部署工作负载

工作负载是一个对象，包括pod以及部署应用程序所需的其他文件和信息。我们以nginx作为例如:

  1. 在Default视图下，点击工作负载—部署服务
  2. 在部署工作负载页面，设置工作负载名称、副本数量、镜像名称、命名空间、端口映射，其他参数保持默认，最后点击启动；
  3. 部署完成
  4. 通过31174端口去访问nginx服务。