简要说明：

RKE (Rancher Kubernetes Engine)是RancherLabs提供的一个工具，可以在裸机、虚拟机、公私有云上快速安装Kubernetes集群。整个集群的部署只需要一个命令、一个配置文件，解决了如何轻松部署Kubernetes的问题。

尽管Rancher提供了免费的视频培训（见后面的参考链接），但用户在使用RKE时，还是会遇到了很多报错信息，无法安装成功，这主要是因为一些基本的前置条件没有满足。

为了用户使用RKE部署Kubernetes更顺利，有必要梳理一下，把部署要点整理出来，让使用RKE的用户少走弯路。

部署要点：

系统版本：

建议使用Ubuntu 16.04.3 LTS版本，如果是CentOS7，建议7.3以上版本；

Docker版本：

RKE在Github上的readme中已有说明，Kubernetes1.8需要Docker 1.12.6、1.13.1、17.03,Kubernetes1.8不支持更高版本的Docker；

主机名：

如果是克隆的系统一定要修改主机名，hostname主机名必须不同！

主机文件：

/etc/hosts要配置正确，一定要有127.0.0.1 localhost 这一项。Hosts文件中包含所有主机节点的IP和名称列表。使用vi进行编辑，不能使用中文全角的空格；

SELinux：

必须关闭！Ubuntu 16.04默认未安装，无需设置。CentOS7下可修改配置文件/etc/sysconfig/selinux，设置SELINUX=disabled ，重启后永久关闭。

IPV4转发：

必须开启！Ubuntu 16.04下默认已启用，无需设置。CentOS7 下可编辑配置文件/etc/sysctl.conf，设置启用转发,

net.ipv4.ip_forward = 1

net.bridge.bridge-nf-call-ip6tables = 1

net.bridge.bridge-nf-call-iptables = 1

执行sudo sysctl -p 立刻生效。

防火墙：

开放集群主机节点之间6443、2379、2380端口，如果是刚开始试用，可以先关闭防火墙；Ubuntu默认未启用UFW防火墙，无需设置。也可手工关闭：sudo ufw disable

禁用SWAP：

一定要禁用swap，否则kubelet组件无法运行，永久禁用swap可以直接修改/etc/fstab文件，注释掉swap项。swapoff -a 只是临时禁用，下次关机重启又恢复原样；

启用Cgroup：

修改配置文件/etc/default/grub，启用cgroup内存限额功能,配置两个参数：

GRUB_CMDLINE_LINUX_DEFAULT="cgroup_enable=memory swapaccount=1"

GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1"

注意：要执行sudo update-grub 更新grub，然后重启系统后生效。

SSH免密登录：

RKE通过SSH tunnel进行安装部署，需要事先建立RKE到各节点的SSH免密登录。如果集群中有5个节点，需要在RKE机器上执行1遍秘钥生成命令ssh-keygen +5次公钥分发命令ssh-copy-id user1@节点IP。如果执行RKE的本机也要加入到K8S集群中，也要使用ssh-copy-id user1@本机IP，将公钥分发到本机，对本机执行ssh免密配置，否则也会报错。免密配置方法：http://blog.csdn.net/csdn_duomaomao/article/details/79164073 。

RKE部署用户：

1、RKE部署用户是cluster.yml配置文件中的用户，也就是上述能ssh免密登录到其他机器的用户；

2、CentOS7不能用root用户，Ubuntu既可用root也可用普通用户；

3、如果使用普通用户进行RKE安装，要将普通用户（如user01）加入到docker组，命令：sudo usermod -aG docker user01 注意：重启系统以后才能生效，只重启Docker服务是不行的！重启后，user01用户也可以直接使用docker run命令。

4、在Ubuntu上使用apt安装完docker后，会自动创建docker用户组，无需手工创建docker组，只需要将部署RKE的用户（如user01）加入到docker组即可，查看是否存在docker组、以及user01用户是否在docker组中，可以直接查看/etc/group文件；

*5、如果Ubuntu使用root用户进行RKE安装，需要配置sshd服务，修改配置文件/etc/ssh/sshd_config,将PermitRootLogin prohibit-password 改为PermitRootLogin yes ，允许root远程ssh登录；取消注释#AuthorizedKeysFile %h/.ssh/authorized_keys ，允许记录授权秘钥文件；

关键截图：

01-创建user01用户，将user01加入到docker组中

02-修改GRUB配置文件，启用cgroup内存限额功能

03-修改etc下fstab文件，永久禁用swap

04-ubuntu下如果使用root用户进行安装，需要修改ssh配置，允许root远程登录

05-RKE安装部署过程1

06-RKE安装部署过程2

07-RKE安装部署过程3

01-创建user01用户，将user01加入到docker组中

02-修改GRUB配置文件，启用cgroup内存限额功能

03-修改etc下fstab文件，永久禁用swap

04-ubuntu下如果使用root用户进行安装，需要修改ssh配置，允许root远程登录

05-RKE安装部署过程1

06-RKE安装部署过程2

07-RKE安装部署过程3

参考配置文件：

一个可用的cluster.yml配置文件：

---

auth:

strategy: x509

options:

foo: bar

# supported plugins are:

# flannel

# calico

# canal

# weave

# If you are using calico on AWS, use the network plugin config option:

# 'cloud_provider: aws'

network:

plugin: flannel

options:

flannel_image: registry.cn-shenzhen.aliyuncs.com/rancher_cn/flannel

flannel_cni_image: registry.cn-shenzhen.aliyuncs.com/rancher_cn/flannel-cni

nodes:

- address: 192.168.3.161

user: user01

role: [controlplane, etcd]

ssh_key_path: ~/.ssh/id_rsa

- address: 192.168.3.162

user: user01

role: [worker]

ssh_key_path: ~/.ssh/id_rsa

- address: 192.168.3.163

user: user01

role: [worker]

ssh_key_path: ~/.ssh/id_rsa

services:

etcd:

image: registry.cn-shenzhen.aliyuncs.com/rancher_cn/etcd:latest

kube-api: