Docker拉取速率超限致K8s部署失败，登录DockerHub仍未解决求方案

1. 配置Kubernetes全局镜像拉取密钥 #

你在节点登录Docker Hub的操作不会自动同步给Kubernetes，需要将Docker Hub凭证创建为集群级别的Secret，并设置为默认拉取凭证：

• 创建Docker Hub密钥：

kubectl create secret docker-registry dockerhub-secret --docker-server=docker.io --docker-username=你的Docker Hub用户名 --docker-password=你的Docker Hub密码 --docker-email=你的邮箱

• 给默认服务账户绑定该密钥，让所有Pod默认使用此凭证拉取镜像：

kubectl patch serviceaccount default -p '{"imagePullSecrets": [{"name": "dockerhub-secret"}]}'

2. 使用私有镜像仓库或镜像加速器 #

• 私有仓库方案：提前将kubesphere/ks-controller-manager:v3.3.1拉取到本地，推送到私有仓库（如Harbor、私有云镜像库），然后修改Kubernetes资源中的镜像地址为私有仓库地址。
• 镜像加速器方案：修改Docker配置文件/etc/docker/daemon.json添加国内镜像加速器：

{
  "registry-mirrors": ["https://hub-mirror.c.163.com"]
}

执行以下命令重启服务：

systemctl restart docker
systemctl restart kubelet

3. 优化镜像拉取策略 #

• 给Pod设置imagePullPolicy: IfNotPresent，避免重复拉取已存在的镜像，修改Deployment或Pod的YAML：

spec:
  containers:
  - name: ks-controller-manager
    image: kubesphere/ks-controller-manager:v3.3.1
    imagePullPolicy: IfNotPresent

• 分批启动部署资源，减少短时间内的镜像拉取请求量，避免触发速率限制。

4. 确认Docker Hub账号配额 #

免费Docker Hub账号每6小时仅允许200次拉取请求，若多节点共享同一账号，需检查总拉取次数是否超出配额；若配额不足，可考虑升级付费账号。

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