Docker推送至Kubernetes容器仓库失败，求原因及解决办法

可能原因及对应解决方法 #

1. 容器注册表API未启用 #

Google Container Registry依赖Container Registry API，若项目未启用该API，会直接导致推送失败。

• 解决：登录Google Cloud控制台，找到对应项目，搜索并启用「Container Registry API」。

2. 本地Docker认证信息失效 #

即便执行过gcloud auth configure-docker，认证凭证也可能过期或未正确关联当前项目。

• 解决：
  • 重新执行认证命令：gcloud auth configure-docker，按提示完成授权流程。
  • 若仍无效，先清除现有认证：gcloud auth revoke --all，再重新登录账号：gcloud auth login，之后再次配置Docker认证。

3. 镜像标签格式不符合要求 #

必须严格遵循GCR的标签格式：gcr.io/[项目ID]/[镜像名]:[标签]

• 注意：必须使用项目ID而非项目名称，项目ID可在Google Cloud控制台的项目设置中查看。
• 示例操作：

  # 重新为本地镜像打正确标签
  docker tag [本地镜像ID/名称] gcr.io/[项目ID]/[镜像名]:[标签]
  # 执行推送
  docker push gcr.io/[项目ID]/[镜像名]:[标签]
  

4. 账号权限不足 #

当前使用的Google账号缺少该项目的**存储管理员（Storage Admin）或容器注册表管理员（Container Registry Admin）**权限。

• 解决：登录Google Cloud控制台，进入「IAM与管理员」→「IAM」，找到对应账号，添加roles/storage.admin或roles/containerregistry.admin权限。

5. 网络连接异常 #

本地网络无法正常连接GCR服务，可能是防火墙、代理或运营商限制导致。

• 解决：
  • 测试网络连通性：尝试访问gcr.io，确认服务可正常访问。
  • 若使用代理，需为Docker配置对应代理：在Docker可视化设置中添加HTTP/HTTPS代理，或修改~/.docker/config.json文件添加代理配置。

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