Rancher 2.x 安装配置

Posted 2021-08-27 catoop

动手操作之前，请先将文本阅读完整，理解整体过程后再动手，相关注意事项需要了解清楚。

本文为开发环境Rancher单机版安装，如需集群版安装可以详见官方文档。

前置条件

1. 服务器已经安装docker并已启动docker服务。
2. 如果是内网安装，需要依赖docker私服harbor，你需要确保你harbor运行正常。
3. docker服务已配置默认连接到私服harbor，并在服务器上使用 docker login 正常登录私服成功。
4. 将域名 harbor.goodcol.com 配置到服务器的 /etc/hosts 中（例如：192.168.10.164 harbor.goodcol.com），域名对应 harbor 实际的服务器IP地址。
5. 关闭服务器的防火墙和SELinux。

安装Rancher

docker run -d --name=rancher-v258 \\
--privileged --restart=unless-stopped \\
-p 18080:80 -p 18443:443 \\
--add-host=harbor.goodcol.com:192.168.10.164 \\
-e CATTLE_SYSTEM_DEFAULT_REGISTRY=harbor.goodcol.com:18443/dockerhub_proxy \\
-e CATTLE_SYSTEM_CATALOG=bundled harbor.goodcol.com:18443/dockerhub_proxy/rancher/rancher:v2.5.8

注意其中的add-host中的本地域名和IP地址要和私服对应

rancher启动后，可以通过docker ps，docker logs等命令观察rancher容器的信息，稍等片刻后（空隙时间请将192.168.10.164 harbor.goodcol.com添加到你电脑的hosts文件中）打开Chrome浏览器访问rancher系统（例如 https://harbor.goodcol.com:18443），初次登陆会让你设置登陆密码。

添加集群

1. 点击“添加集群”按钮再选择“自定义”进入添加集群配置界面
2. 输入集群名称，例如 k8s001
3. 选择Kubernetes版本，这里注意选择你私服里面有的版本，也就是曾经完全安装过的版本。如果这里可以选择的版本不存在你需要的，你就点击“编辑YAML”按钮，手工修改版本后就可以了
4. 私有镜像仓库选择“启用”，然后输入仓库地址（例如harbor.goodcol.com:18443/dockerhub_proxy）、用户名和密码
5. 主机Docker版本中的“Docker根目录”，输入你docker的数据目录地址（使用命令 docker info | grep "Root Dir" 查看），默认为/var/lib/docker

其他主要参数就没有了，更多参数根据实际需求选择调整

最后点击下一步就保存了这个集群配置，下一个页面会显示“集群注册命令”，你可以通过勾选 Etcd、Control Plane、Worker 来生成命令，最后拷贝命令在你的服务器上执行即可。

注意：命令在服务器上执行后到完全初始化和注册完成，需要好几分钟时间，请耐心等待。
如果时间很久了还是出现红色错误没有完全注册完成，则通过查看日志等方式排查问题。
那3个可被勾选的选项的作用界面上有明确说明，不过一般来说master节点会选择前面两个或者3个都选择，而worker节点只选择最后一个worker。
生成的命令中会出现rancher的IP地址和访问端口、私服harbor的访问地址，请注意检查，如果不正确你需要手工修改一下再到服务器上执行。

---

（END）