Github Actions推送镜像至GCP Artifact Registry报Missing image name错误

核心原因 #

你的Docker镜像标签格式不符合Google Artifact Registry的要求，导致推送时提示「Missing image name」。

Artifact Registry的Docker镜像推送路径必须遵循格式：
HOST-NAME/PROJECT-ID/REPOSITORY/IMAGE:TAG

而你当前使用的标签是：
us-central1-docker.pkg.dev/[my-project]/github-actions:ecb28fdf...
这里github-actions是仓库名，但缺少了仓库下的镜像名称部分，Docker无法识别有效镜像路径，因此报错。

修复步骤 #

修改Build and Push Container步骤中的镜像标签，在仓库名后添加镜像名称（可自定义，比如与服务名一致）：

- name: Build and Push Container
  run: |-
    # 在仓库名后添加镜像名称，示例用服务名作为镜像名
    IMAGE_TAG="${{ env.GAR_LOCATION }}-docker.pkg.dev/${{ env.PROJECT_ID }}/${{ env.SERVICE }}/${{ env.SERVICE }}:${{ github.sha }}"
    docker build -t "$IMAGE_TAG" .
    docker push "$IMAGE_TAG"

修改后的完整标签示例：
us-central1-docker.pkg.dev/[my-project]/github-actions/github-actions:ecb28fdf92addae09fe6bd9e86033027b2850de3
其中github-actions/github-actions分别对应仓库名和镜像名称，完全符合Artifact Registry的路径规范。

额外验证点 #

1. 确认Artifact Registry仓库us-central1-docker.pkg.dev/[my-project]/github-actions确实存在，且区域与GAR_LOCATION配置一致
2. 检查IAM权限：你配置的Artifact Registry Administrator角色已包含推送镜像所需的roles/artifactregistry.writer权限，此权限无需额外调整

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