KubeSphere 多节点安装过程错误记录

安装过程参考官网 KubeSphere 多节点安装指南

1. 安装 Docker 时依赖软件包 selinux-policy-targeted 下载失败

   # 执行 docker 安装命令
   yum -y install docker-ce-19.03.9-3.el7 docker-ce-cli-19.03.9
   # 错误信息
   selinux-policy-targeted-3.13.1-268.el7_9.2.noarch: [Errno 256] No more mirrors to try
   

   解决方法 1：

   # 清除重建 yum 缓存
   yum clean all
   yum makecache
   # 再次安装 docker
   yum -y install docker-ce-19.03.9-3.el7 docker-ce-cli-19.03.9
   

   如果方法 1 不行，尝试方法 2：

   # 指定完整链接下载依赖软件
   yum -y install \
   http://mirror.centos.org/centos/7/updates/x86_64/Packages/selinux-policy-3.13.1-268.el7_9.2.noarch.rpm \
   http://mirror.centos.org/centos/7/updates/x86_64/Packages/selinux-policy-targeted-3.13.1-268.el7_9.2.noarch.rpm
   # 再次安装 docker 即可
   yum -y install docker-ce-18.09.9-3.el7 docker-ce-cli-18.09.9
   

2. 下载 kubekey 超时无反应

   # 官方步骤
   export KKZONE=cn
   curl -sfL https://get-kk.kubesphere.io | VERSION=v1.1.1 sh -
   

   解决方法： 使用其他机器下载，或者手动下载后传到服务器上，暂时没有尝试其他办法。kubekey v1.1.1 下载地址

   # 解压缩 kubekey
   tar -zxvf kubekey-v1.1.1-linux-amd64.tar.gz
   # 赋执行权限
   chmod +x kk
   

3. 虚拟机 CPU 数量为 1 的错误

   [ERROR NumCPU]: the number of available CPUs 1 is less than the required 2
   

   解决方法： 将虚拟机 CPU 数量调整到 2 以上即可。

4. 由于国内无法访问 google 造成下载失败

   WARN[11:53:19 CST] Having a problem with accessing https://storage.googleapis.com? You can try again after setting environment 'export KKZONE=cn'
   WARN[11:53:19 CST] Task failed ...
   WARN[11:53:19 CST] error: Failed to download kubectl binary: curl -L -o /root/kubekey/v1.19.8/amd64/kubectl https://storage.googleapis.com/kubernetes-release/release/v1.19.8/bin/linux/amd64/kubectl
   Error: Failed to download kube binaries: Failed to download kubectl binary: curl -L -o /root/kubekey/v1.19.8/amd64/kubectl https://storage.googleapis.com/kubernetes-release/release/v1.19.8/bin/linux/amd64/kubectl
   

   解决方法： 按照提示，设置环境变量后，重新执行安装

   export KKZONE=cn
   

5. 最小化安装时未启用 etcd 监控
   查看组件状态时，etcd 状态显示为黄色图标，如下图。起初以为是 etcd 组件有错误，查阅资料发现是没有开启监控导致。
   
   解决方法： 手动开启监控，并配置证书。参考链接

   # 生成证书，如果提示已经生成则继续往下执行
   kubectl -n kubesphere-monitoring-system create secret generic kube-etcd-client-certs
   # 编辑配置文件
   kubectl edit cc ks-installer -n kubesphere-system
   

   # 配置文件 etcd 部分
   etcd:
     endpointIps: 172.22.151.165
     monitoring: true # 默认为 false
     port: 2379
     tlsEnable: true
   

   # 保存配置文件后，执行该命令查看安装过程日志
   kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f
   

   安装完成后，重新登录即可看到正常状态。
   

---

安装成功，记录一下。