本文是Rancher 2.0部署与使用过程中常见的问题及其解决方法，多数问题整理收集自Rancher官方技术交流群内用户的提问与反馈。欢迎扫描文末二维码，添加Rancher小助手为好友，加群获得更多技术支持。
本文主要内容为：
1、部署Rancher 2.0的环境需求
- 推荐使用的操作系统
- 推荐的硬件配置
- 支持的docker版本
- 防火墙需要允许通过的端口
2、部署过程中的常见问题及排查思路
- 环境信息残留
- openssh版本过低问题
- nodeport端口只有一台机器能访问
- 部署使用calico网络部署环境失败问题
- 部署时主机not found问题
- web页面kubectl闪退问题
- 非worker节点仍然被调度pod问题
- it is a not share mount 问题
- networkredy=false 问题
- 集群 unavailable
环境需求
推荐使用的操作系统
- Ubuntu 16.04 (64-bit)
-
Red Hat Enterprise Linux 7.5 (64-bit)
-
RancherOS 1.3.0 (64-bit)
推荐的硬件配置
支持的docker版本
- 1.12.6
-
1.13.1
-
17.03.02
防火墙请允许通过已下端口
|
Protocol |
Port range |
Purpose |
|
tcp |
22 |
ssh server |
|
tcp |
80 |
Rancher Server/ingress |
|
tcp |
443 |
Rancher Server/ingress |
|
tcp |
6443 |
kubernetes api server |
|
tcp |
2379-2380 |
etcd server client api |
|
tcp |
10250-10256 |
kubernetes components |
|
tcp |
30000-32767 |
nodeport services |
|
udp |
8472 |
canal |
常见问题与排查思路
环境信息残留
目前部署中，大部分问题都是因为由于部署环境的操作系统，或多次部署，升级后残留的的信息造成的。
部署前或部署时，请使用以下命令将环境的各类信息清理干净：
df -h|grep kubelet |awk -F % '{print $2}'|xargs umount
rm /var/lib/kubelet/* -rf
rm /etc/kubernetes/* -rf
rm /var/lib/rancher/* -rf
rm /var/lib/etcd/* -rf
rm /var/lib/cni/* -rf
iptables -F && iptables -t nat –F
ip link del flannel.1
docker ps -a|awk '{print $1}'|xargs docker rm -f
docker volume ls|awk '{print $2}'|xargs docker volume rm
openssh版本过低问题
centos或rhel系统并且版本低于7.4的，因为默认的openssh和openssl和红帽系ssh默认将AllowTcpForwarding 关闭了，rke部署时会出现如下问题：
参考issue：
https://github.com/rancher/rke/issues/93
需要您进行以下操作：
1. 确保您的openssh版本大于等于7.x
2. 修改sshd配置打开重启sshd
3. 默认centos和rhel不能使用root用户进行ssh tunnel，所以需要使用一个普通用户
4. 并将这个用户加入docker这个Group，useradd –G docker yourusername
nodeport端口只有一台机器能访问
只能访问一台宿主机的nodeport，并且还是pod所在那台机器，出现这种问题很大原因是因为跨集群网络有问题，或本地防火墙问题。排查思路如下：
1、在宿主机本机telnet localhost:nodeort看看是否能通，本机能通，在集群内互相telnet测试，如果不能通根部署环境网络有很大关系，建议联系网络管理员进行排查。
如果本机telnet也不能通，进行如下测试。
2、首先我们需要或取对应的pod 信息
比如我这个test-6b4cdf4ccb-7pzt6在rancher-kf-worker01节点上，它的ip为10.42.3.23
3、先在pod所在的宿主机上然后在另外几个节点去ping这个ip，看看能否ping通，在canal网络模式下，请检查防火墙端口8472/UDP是否开放。查看每天机器上是否有尝试使用每台机器的flannel.1网卡，用的话，用flannel.1上的ip互相ping，看看是否能通，因为flannel网络和canal网络是通过flannel.1网卡互相建立vxlan遂道的。建议操作在关闭防火墙的情况下测试。
部署使用calico网络部署环境失败问题
部署rancher2.0时网络类型为calico时，如果cloud provider默认不填会选用公有云的，导致部署失败，所以这里我们需要手动填写为none。（后期会优化此项）
部署时主机not found问题
出现这个问题是因为宿主机的主机名不符合kubernetes的标准主机名要求也不符合标准的linux主机名，主机名内不能有下划线。
获取组件健康状态forbidden问题
大部分原因是因为部署多次，证书残留的导致的，解决办法，按照环境信息残留里面的方法把环境清空下，在重新添加。
web页面kubectl闪退问题
这个主要根操作系统版本和浏览器的版本有关系，请使用上推荐使用操作系统中的操作系统，浏览器使用Chrome
非worker节点仍然被调度pod问题
目前rancher2.0非worker节点，仍然会被调度pod过去，您可以选择手动将它们从kube-scheduler踢除，命令如下：
在获取节点在kubernetes集群的名字
打开web页面kubectl
然后执行
kubectl taint node rancher-kf-control01 node-role.kubernetes.io/rancher-kf-control01="":NoSchedule kubectl taint node rancher-kf-control02 node-role.kubernetes.io/rancher-kf-control02="":NoSchedule kubectl taint node rancher-kf-control03 node-role.kubernetes.io/rancher-kf-control03="":NoSchedule
it is a not share mount问题
部署时遇到share mount问题时，报错提示如下：
FATA[0180] [workerPlane] Failed to bring up Worker Plane: Failed to start [kubelet] container on host [192.168.10.51]: Error response from daemon: linux mounts: Path /var/lib/kubelet is mounted on / but it is not a shared mount.
这个问题原因主要是kubelet容器化部署，需要手动设置docker的MuntFLAGS为空
https://github.com/kubernetes/kubernetes/issues/4869#issuecomment-195696990
解决方法：
执行
mount --make-shared /
或配置docker.server
MountFlags=shared
重启docker.service
NetworkRedy=false问题
这个问题通常是，在部署时网络组件在初始化，在配置，等待段时间就好了。或在对应节点查看kubelet日志的docker logs kubelet。
集群unavailable
通常此问题，是因为rancher-server根kubernetes中的kube-apiserver 6443端口连接有问题，建议检查防火墙和查看kube-api-server的日志。
总结
1、部署时能严格按照官方给出的操作系统版本和docker版本部署，可以避免掉很多问题。
2、多次部署，升级，环境一定要按照环境信息残留章节的命令，将环境清理干净。
3、如果遇到问题，建议docker logs 查看rancher-agent，rancher-server的日志。
原文地址：http://blog.51cto.com/12462495/2119381