PieCloudDB安装时用Kubekey部署Kubernetes遇kubelet启动失败

问题核心是国内网络无法直接访问k8s.gcr.io仓库，导致kubelet初始化所需的sandbox镜像k8s.gcr.io/pause:3.2拉取失败。以下是快速修复和长效解决方案：

临时修复（已部署集群） #

• 拉取国内镜像源的pause镜像（以阿里云为例）：

  ctr -n k8s.io image pull registry.aliyuncs.com/google_containers/pause:3.2
  

• 为镜像添加kubelet所需的官方标签：

  ctr -n k8s.io image tag registry.aliyuncs.com/google_containers/pause:3.2 k8s.gcr.io/pause:3.2
  

• 验证镜像是否已正确添加标签：

  ctr -n k8s.io image list | grep pause
  

• 重启kubelet服务：

  systemctl restart kubelet
  

• 确认kubelet状态正常：

  systemctl status kubelet
  

长效方案（集群部署前配置） #

在Kubekey的部署配置文件（如config-sample.yaml）中指定国内镜像仓库，避免后续所有K8s官方镜像拉取问题：

找到配置中的imageRegistry字段，将其值设置为国内镜像源，例如：

imageRegistry: registry.aliyuncs.com/google_containers

保存配置后重新执行Kubekey的集群部署命令即可。

内容的提问来源于stack exchange，提问作者PDB