GitLab CI/CD拉取Docker镜像失败问题求助

错误1："invalid reference format" 修复 #

你把认证信息直接嵌在镜像地址里的写法不符合Docker镜像引用的格式规范，导致解析失败。GitLab CI用CI_JOB_TOKEN拉取私有镜像的正确姿势是通过image字段的credentials配置块单独指定认证，别把token硬拼在镜像地址里。

正确配置示例：

default:
  image:
    name: git.domain.tld:1234/path/to/<subgroup>/<project>/<container>:latest
    credentials:
      username: gitlab-ci-token
      password: ${CI_JOB_TOKEN}

错误2："requested access to the resource is denied" 修复 #

这个错误有两个核心原因：

• 你只写了<project>/<container>:latest，Docker会默认去Docker Hub拉镜像，根本不会访问你的GitLab私有容器仓库，自然找不到对应镜像。
• 就算指向了正确仓库，也没加认证信息，权限肯定过不去。

修复后的配置要明确指定GitLab容器仓库的完整地址，同时配上认证（和错误1的正确配置一致）：

default:
  image:
    name: git.domain.tld:1234/path/to/<subgroup>/<project>/<container>:latest
    credentials:
      username: gitlab-ci-token
      password: ${CI_JOB_TOKEN}

额外验证点 #

• 确认镜像地址里的<subgroup>、<project>、<container>都是实际存在的路径，别写错字
• 检查GitLab容器仓库的可见性设置，确保当前CI任务所在项目有权限访问该镜像仓库
• 确认CI_JOB_TOKEN的权限范围，是否允许访问目标镜像仓库（在项目的-/settings/ci_cd/TOKEN ACCESS里可以配置允许访问的项目）

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