GitLab托管Runner流水线拉取Docker镜像失败，报无效引用格式错误

错误原因 #

你遇到的invalid reference format错误，核心原因是指定的Docker镜像标签格式不正确：docker:20:10:17里的版本号用冒号分隔，而Docker镜像标签中版本号的层级分隔应该使用点号，冒号仅用于分隔镜像名和标签本身。

修正后的流水线配置 #

将image字段的镜像标签改为正确格式docker:20.10.17，同时确保和dind服务镜像版本保持一致：

build_image:
  image: docker:20.10.17
  services:
    - docker:20.10.17-dind
  variables:
    DOCKER_TLS_CERTDIR: "/certs"
  before_script:
    - docker login -u $REGISTRY_USER -p $REGISTRY_PASS
  script:
    - docker build -t $IMAGE_NAME:$IMAGE_TAG .
    - docker push $IMAGE_NAME:$IMAGE_TAG

额外提示 #

在Docker-in-Docker场景中，主任务使用的docker镜像版本建议和dind服务镜像版本完全匹配，能有效避免因版本差异引发的API兼容、TLS配置冲突等问题。

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