Rancher 2.x 安装配置

Dear 丶 2022-08-31 15:17 263阅读 0赞

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

> 本文为开发环境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）