为何GCP镜像无法部署到本地Kubernetes集群？拉取失败

排查方向及解决方案 #

1. 确认镜像有效性与网络连通性 #

• 手动拉取镜像测试：在本地执行 docker pull gcr.io/<redacted>/<redacted>:latest@sha256:<redacted>，如果拉取失败，优先解决网络问题（比如GCR访问受限可配置镜像代理），同时确认GCP上的镜像是否存在、标签/摘要是否正确。
• 测试GCR连通性：执行 curl https://gcr.io，返回正常响应说明网络通畅，否则排查本地网络或防火墙设置。

2. 处理私有镜像的拉取权限 #

若为私有GCR仓库，本地K8s节点需配置认证才能拉取：

• 创建GCR拉取密钥：

  kubectl create secret docker-registry gcr-secret --docker-server=gcr.io --docker-username=_json_key --docker-password="$(cat 你的服务账号密钥路径.json)" --docker-email=任意邮箱@example.com
  

• 修改Deployment配置关联密钥：

  spec:
    template:
      spec:
        imagePullSecrets:
          - name: gcr-secret
  

• 检查节点Docker配置：确认节点的~/.docker/config.json包含GCR认证信息，确保Docker单独拉取私有镜像正常。

3. 排查Cloud Code插件部署流程 #

• 查看插件构建日志：确认镜像是否成功推送到GCR，部分场景下插件构建完成但推送失败，导致GCR无对应镜像。
• 跳过插件手动部署：用docker build构建镜像，docker push推送到GCR，再手动编写Deployment文件部署到集群，验证是否为插件配置问题。

4. 清理本地集群镜像缓存 #

• 删除节点损坏镜像：在集群节点执行 docker rmi gcr.io/<redacted>/<redacted>:latest@sha256:<redacted>，让K8s重新拉取镜像。
• 查看Pod详细事件：执行 kubectl describe pod <你的Pod名称>，获取更具体的拉取失败原因（如认证错误、镜像不存在等）。

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