一、概述
对于生产环境，需以高可用的配置安装 Rancher，确保用户始终可以访问 Rancher Server。当安装在Kubernetes集群中时，Rancher将与集群的 etcd 集成，并利用Kubernetes 调度实现高可用。
为确保高可用，本文所部署的 Kubernetes 集群将专用于运行 Rancher ，Rancher 运行起来后，可再创建或导入集群以运行具体的工作负载。
推荐架构
- Rancher的DNS 应解析到 4层(TCP) 负载均衡上。
- 负载均衡应将端口 TCP/80 和 TCP/443 转发到 Kubernetes 集群中的所有3个节点。
- Ingress-controller 将 HTTP 重定向到HTTPS并终止端口 TCP/443 上的 SSL/TLS（SSL数字证书在这里部署）。
- Ingress-controller 将流量转发到 pod 的 TCP/80 端口。
下面是一张从官网拉过来的图片,更直观一些。
二、准备工作
服务器准备
- 1台 Linux服务器，配置不用很高，用于四层负载均衡
- 3台 Linux服务器，Rancker-server-node 节点
- n台 Linux服务器，Rancker-agent-node 节点(n<=50)
节点服务器的硬件配置，可根据实际情况依据该表自行选择。
规模
集群
节点
CPU
内存
小
最多5个
高达50
2
8 GB
中
最多15个
最多200
4
16 GB
大
高达50
最多500个
8
32 GB
超大
最多100个
高达1000
32
128 GB
更大规模
100+
1000+
联系 Rancher
联系 Rancher
环境说明
服务器使用本地的EXSI，虚拟机具体配置如下：
主机名称
系统版本
内网ip
配置
rancher-01
CentOS 7.6
10.212.22.32
2核3g
rancher-02
CentOS 7.6
10.212.22.23
2核3g
rancher-03
CentOS 7.6
10.212.20.97
2核3g
rancher-slb
CentOS 7.6
10.212.20.213
1核1g
注意：如果云服务器，比如阿里云，腾讯云，AWS等等。不需要rancher-slb服务器，直接TCP转发到rancher后端即可。
centos7 永久修改主机名，使用命令：
hostnamectl set-hostname xxx
其中xxx表示你要设置的主机名，执行完成之后，退出，重新登录一次，就可以了。
docker安装
关于docker安装，请参考链接：
https://www.cnblogs.com/xiao987334176/p/11771657.html
安装RKE
Rancher Kubernetes Engine(RKE)是一款轻量级Kubernetes安装程序，支持在裸机和虚拟化服务器上安装Kubernetes。 RKE解决了Kubernettes社区中的一个常见问题，比如:安装复杂性。RKE支持多种平台运行，比如MacOS,linux,windows。
这里在rancher-01上安装rke：
1、下载二进制文件
https://github.com/rancher/rke/releases/latest
目前稳定版本为v1.0.8
下载文件
下载安装
wget https://github.com/rancher/rke/releases/download/v1.0.8/rke_linux-amd64
chmod +x rke_linux-amd64
mv rke_linux-amd64 /usr/bin/
rke_linux-amd64 --version
注意：此文件安装的k8s版本为v1.17.5
安装kubectl
kubectl是一个CLI命令行工具，用于运行Kubernetes集群的命令。Rancher 2.x中的许多维护和管理都需要它。
这里在rancher-01上安装kubectl:
https://storage.googleapis.com/kubernetes-release/release/v1.17.0/kubernetes-client-linux-amd64.tar.gz
注意：此链接必须在访问谷歌的电脑上面才行下载。
我已经上传到百度网盘了，下载链接如下：
链接：https://pan.baidu.com/s/1WbuaTIJGBSNP5CgRIq75Bw
提取码：f77i
解压，并放到path路径下
tar zxvf kubernetes-client-linux-amd64.tar.gz -C /usr/src/
cp /usr/src/kubernetes/client/bin/kubectl /usr/bin/kubectl
chmod +x /usr/bin/kubectl
配置kubectl的shell补全
CentOS Linux上，您可能需要安装默认情况下未安装的bash-completion软件包。
yum install bash-completion -y
运行source <(kubectl completion bash)可将kubectl自动补全添加到当前shell，要使kubectl自动补全命令自动加载:
echo "source <(kubectl completion bash)" >> ~/.bashrc
退出，重新登录一下即可。
三、使用 RKE 安装 kubernetes
下面使用 RKE(Kubernetes Engine) 安装高可用的 Kubernetes。
NODE-SERVER 之间建立 ssh 信任
我们目前有三台服务器用作 local 集群，首先要确保我们主机能够通过 ssh 访问到另外两台主机并执行相关操作。
创建用户rancher
注意：使用rke安装kubernetes时，不能以root用户执行。必须是一个普通用户才行！！！
在rancher-01，rancher-02，rancher-02执行以下命令：
useradd rancher
passwd rancher
授权docker权限
在rancher-01，rancher-02，rancher-02执行以下命令：
使用root账号登录
#将登陆用户develop加入到docker用户组中
gpasswd -a rancher docker
#更新用户组
newgrp docker
切换到rancher用户进行测试
su rancher
docker ps
输出正常，则表示成功了。
ssh信任
在rancher-01，rancher-02，rancher-02执行以下命令：
# su rancher
$ ssh-keygen -t rsa -P "" -f ~/.ssh/id_rsa
$ cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
$ chmod 600 ~/.ssh/authorized_keys
复制公钥
在rancher-01上执行
注意：以rancher用户执行。
$ ssh-copy-id 10.212.22.32
$ ssh-copy-id 10.212.22.23
$ ssh-copy-id 10.212.20.97
测试ssh免密
在rancher-01上执行
注意：以rancher用户执行。
$ ssh 10.212.22.32
$ ssh 10.212.22.23
$ ssh 10.212.20.97
编写 rancher-cluster.yml 文件
这里需要注意，这个文件没有明确配置rsa文件名，默认会使用 $HOME/.ssh/id_rsa 建立连接。内容如下
在rancher-01上执行
注意：以rancher用户执行。
$ vi rancher-cluster.yml
内容如下：
nodes:
- address: 10.212.22.32
internal_address: 10.212.22.32
user: rancher
role: [controlplane,worker,etcd]
hostname_override: rancher-01
- address: 10.212.22.23
internal_address: 10.212.22.23
user: rancher
role: [controlplane,worker,etcd]
hostname_override: rancher-02
- address: 10.212.20.97
internal_address: 10.212.20.97
user: rancher
role: [controlplane,worker,etcd]
hostname_override: rancher-03
services:
etcd:
backup_config:
enabled: true
interval_hours: 6
retention: 60
View Code
备注：
address 公共域名或IP地址
user 可以运行docker命令的用户
role 分配给节点的Kubernetes角色列表
internal_address 内部集群通信的私有域名或IP地址
开启了etcd的备份机制，每隔6小时备份一次，保存60天数据
运行 RKE 构建 kubernetes 集群
在rancher-01上执行
注意：以rancher用户执行。
$ rke_linux-amd64 up --config ./rancher-cluster.yml
输出如下：
INFO[0000] Running RKE version: v1.0.8
INFO[0000] Initiating Kubernetes cluster
INFO[0000] [dialer] Setup tunnel for host [10.212.20.97]
INFO[0000] [dialer] Setup tunnel for host [10.212.22.32]
INFO[0000] [dialer] Setup tunnel for host [10.212.22.23]
INFO[0000] Checking if container [cluster-state-deployer] is running on host [10.212.22.32], try #1
INFO[0000] Image [rancher/rke-tools:v0.1.56] exists on host [10.212.22.32]
...
INFO[0128] [ingress] ingress controller nginx deployed successfully
INFO[0128] [addons] Setting up user addons
INFO[0128] [addons] no user addons defined
INFO[0128] Finished building Kubernetes cluster successfully
View Code
以上输出，表示安装成功了。
执行成功会在当前目录生成2个文件，分别是rancher-cluster.rkestate和kube_config_rancher-cluster.yml
文件说明
rancher-cluster.yml：RKE集群配置文件。
kube_config_rancher-cluster.yml：群集的Kubeconfig文件，此文件包含完全访问群集的凭据。
rancher-cluster.rkestate：Kubernetes群集状态文件，此文件包含完全访问群集的凭据。
错误集锦
WARN[0000] Failed to set up SSH tunneling for host [10.212.20.97]: Can't retrieve Docker Info: error during connect: Get http://%2Fvar%2Frun%2Fdocker.sock/v1.24/info: Unable to access node with address [10.212.20.97:22] using SSH. Please check if you are able to SSH to the node using the specified SSH Private Key and if you have configured the correct SSH username. Error: ssh: handshake failed: ssh: unable to authenticate, attempted methods [none publickey], no supported methods remain
ssh信任没有做好，请确保是普通用户执行rke_linux-amd64。不能是root用户
Failed to get job complete status for job rke-network-plugin-deploy-job in namespace kube-system
重新执行一遍 rke_linux-amd64 up --config ./rancher-cluster.yml即可。
设置环境变量
在rancher-01上执行
注意：以rancher用户执行。
mkdir ~/.kube
cp kube_config_rancher-cluster.yml ~/.kube/config
export KUBECONFIG=$(pwd)/kube_config_rancher-cluster.yml
查看node
$ kubectl get nodes
NAME STATUS ROLES AGE VERSION
rancher-01 Ready controlplane,etcd,worker 43m v1.17.5
rancher-02 Ready controlplane,etcd,worker 43m v1.17.5
rancher-03 Ready controlplane,etcd,worker 43m v1.17.5
如果需要root用户执行kubectl，切换到root用户，执行以下命令
mkdir ~/.kube
cp /home/rancher/kube_config_rancher-cluster.yml ~/.kube/config
export KUBECONFIG=~/.kube/config
测试kubectl命令
# kubectl get pods
No resources found in default namespace.
[root@rancher-master-01 ~]# kubectl get pods -A
NAMESPACE NAME READY STATUS RESTARTS AGE
ingress-nginx default-http-backend-67cf578fc4-r4cgs 1/1 Running 0 41m
ingress-nginx nginx-ingress-controller-8ck28 1/1 Running 0 41m
ingress-nginx nginx-ingress-controller-crw7r 1/1 Running 0 41m
ingress-nginx nginx-ingress-controller-s5zkp 1/1 Running 0 41m
kube-system canal-5fhpj 2/2 Running 0 42m
kube-system canal-m5ww5 2/2 Running 0 42m
kube-system canal-mzqkg 2/2 Running 0 42m
kube-system coredns-7c5566588d-89ztq 1/1 Running 0 42m
kube-system coredns-7c5566588d-xdwg6 1/1 Running 0 40m
kube-system coredns-autoscaler-65bfc8d47d-pbc5t 1/1 Running 0 42m
kube-system metrics-server-6b55c64f86-bfrcb 1/1 Running 0 41m
kube-system rke-coredns-addon-deploy-job-npdcf 0/1 Completed 0 42m
kube-system rke-ingress-controller-deploy-job-pqkpl 0/1 Completed 0 41m
kube-system rke-metrics-addon-deploy-job-5nd4r 0/1 Completed 0 42m
kube-system rke-network-plugin-deploy-job-cvxnv 0/1 Completed 0 42m
View Code
四、安装和配置Helm
Helm是Kubernetes首选的包管理工具。Helmcharts为Kubernetes YAML清单文档提供模板语法。使用Helm，可以创建可配置的部署，而不仅仅是使用静态文件。Helm有两个部分：Helm客户端(helm)和Helm服务端(Tiller)。
配置Helm客户端访问权限
在rancher-01上执行，下面提到的所有命令，都可以在root用户执行了。
kubectl -n kube-system create serviceaccount tiller
kubectl create clusterrolebinding tiller \
--clusterrole cluster-admin --serviceaccount=kube-system:tiller
备注：在kube-system命名空间中创建ServiceAccount；创建ClusterRoleBinding以授予tiller帐户对集群的访问权限；helm初始化tiller服务
安装Helm客户端
wget https://get.helm.sh/helm-v2.16.6-linux-amd64.tar.gz
tar zxvf helm-v2.16.6-linux-amd64.tar.gz -C /usr/src/
cp /usr/src/linux-amd64/helm /usr/local/bin/
安装Helm服务端（Tiller）
helm_version=`helm version |grep Client | awk -F""\" '{print $2}'`
helm init \
--service-account tiller --skip-refresh \
--tiller-image registry.cn-shanghai.aliyuncs.com/rancher/tiller:$helm_version
备注：
1、RKE默认启用RBAC,所以在安装tiller时需要指定ServiceAccount。
2、helm init在缺省配置下，会去谷歌镜像仓库拉取gcr.io/kubernetes-helm/tiller镜像，在Kubernetes集群上安装配置Tiller；由于在国内可能无法访问gcr.io、storage.googleapis.com等域名，可以通过--tiller-image指定私有镜像仓库镜像。
3、helm init在缺省配置下，会利用https://kubernetes-charts.storage.googleapis.com作为缺省的stable repository地址,并去更新相关索引文件。在国内可能无法访问storage.googleapis.com地址, 可以通过--stable-repo-url指定chart国内加速镜像地址。
4、如果您是离线安装Tiller, 假如没有内部的chart仓库, 可通过添加--skip-refresh参数禁止Tiller更新索引。
Helm安装Rancher
添加Chart仓库地址
helm repo add rancher-stable \
https://releases.rancher.com/server-charts/stable
配置SSL
注意：rancher默认使用https访问，因此，需要有一个公网的SSL才行。我在阿里云上面买了一个通配符的SSL证书。
将证书上传到rancher-01
在rancher-01上执行
创建secret
kubectl create ns cattle-system
kubectl -n cattle-system create secret tls tls-rancher-ingress --cert=./214563317320547.pem --key=./214563317320547.key
通过helm安装rancher
helm install rancher-stable/rancher --name rancher --namespace cattle-system --set hostname=rancher.baidu.com --set ingress.tls.source=secret
注意：这里指定了hostname=rancher.baidu.com，必须使用域名访问才行。
查看pod，确保运行正常
# kubectl get pods -A
NAMESPACE NAME READY STATUS RESTARTS AGE
cattle-system rancher-66b5cfc7f5-6wbhq 0/1 Running 1 100s
cattle-system rancher-66b5cfc7f5-9p98v 1/1 Running 0 100s
cattle-system rancher-66b5cfc7f5-zs7qc 0/1 Running 1 100s
ingress-nginx default-http-backend-67cf578fc4-r4cgs 1/1 Running 0 71m
ingress-nginx nginx-ingress-controller-8ck28 1/1 Running 0 71m
ingress-nginx nginx-ingress-controller-crw7r 1/1 Running 0 71m
ingress-nginx nginx-ingress-controller-s5zkp 1/1 Running 0 71m
kube-system canal-5fhpj 2/2 Running 0 71m
kube-system canal-m5ww5 2/2 Running 0 71m
kube-system canal-mzqkg 2/2 Running 0 71m
kube-system coredns-7c5566588d-89ztq 1/1 Running 0 71m
kube-system coredns-7c5566588d-xdwg6 1/1 Running 0 70m
kube-system coredns-autoscaler-65bfc8d47d-pbc5t 1/1 Running 0 71m
kube-system metrics-server-6b55c64f86-bfrcb 1/1 Running 0 71m
kube-system rke-coredns-addon-deploy-job-npdcf 0/1 Completed 0 71m
kube-system rke-ingress-controller-deploy-job-pqkpl 0/1 Completed 0 71m
kube-system rke-metrics-addon-deploy-job-5nd4r 0/1 Completed 0 71m
kube-system rke-network-plugin-deploy-job-cvxnv 0/1 Completed 0 71m
kube-system tiller-deploy-9d74c75cf-7blmd 1/1 Running 0 18m
View Code
访问页面
由于没有DNS服务器，这里直接在windows10添加一条记录。
10.212.22.32 rancher.baidu.com
注意：这里ip地址rancher-01地址，其实，设置为rancher-02或者rancher-03都是能访问的。
访问页面
https://rancher.baidu.com
效果如下：
设置一个强密码
确定访问地址
设置中文
查看local集群
查看主机
五、负载均衡配置
登录rancher-slb节点，安装nginx
yum install -y nginx
修改nginx.conf
vi /etc/nginx/nginx.conf
完整内容如下：
user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;
include /usr/share/nginx/modules/*.conf;
events {
worker_connections 8192;
}
http {
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log /var/log/nginx/access.log main;
sendfile on;
tcp_nopush on;
tcp_nodelay on;
keepalive_timeout 65;
types_hash_max_size 2048;
include /etc/nginx/mime.types;
default_type application/octet-stream;
# Load modular configuration files from the /etc/nginx/conf.d directory.
# See http://nginx.org/en/docs/ngx_core_module.html#include
# for more information.
include /etc/nginx/conf.d/*.conf;
server {
listen 80;
return 301 https://$host$request_uri;
}
}
stream {
upstream rancher_servers {
least_conn;
server 10.212.22.32:443 max_fails=3 fail_timeout=5s;
server 10.212.22.23:443 max_fails=3 fail_timeout=5s;
server 10.212.20.97:443 max_fails=3 fail_timeout=5s;
}
server {
listen 443;
proxy_pass rancher_servers;
}
}
上面红色部分，就是核心配置。
重新加载
nginx
nginx -s reload
修改windows10的hosts记录，指向为rancher-slb节点ip
10.212.20.213 rancher.baidu.com
刷新页面，能正常访问，说明成功了。
本文参考链接：
https://blog.51cto.com/bilibili/2440304
https://blog.51cto.com/liuzhengwei521/2398244
