Golang项目GitLab CI构建Docker镜像时登录失败求解决方案

这个报错其实很好理解：docker login 默认是交互式模式，需要在终端手动输入用户名和密码，但GitLab CI的运行环境没有交互式终端（非TTY），所以直接执行docker login $REGISTRY肯定会失败。而且你之前以为CI会自动注入凭证，其实得借助GitLab自带的预定义变量来完成非交互式登录——这也是最规范、最安全的解决方案。

具体操作步骤： #

1. 利用GitLab自动提供的敏感变量
   GitLab CI会为每个项目自动生成一组用于访问自身容器镜像仓库的变量，完全不用你手动配置：

• CI_REGISTRY: 对应你的GitLab容器仓库地址（也就是你配置的registry.gitlab.com）
• CI_REGISTRY_USER: CI专用的登录用户名
• CI_REGISTRY_PASSWORD: CI专用的登录密码（GitLab会自动屏蔽这个变量的日志输出，避免密码泄露）

2. 替换为非交互式登录命令
   把原来的docker login $REGISTRY换成下面两种方式之一，推荐第一种，更符合安全最佳实践：

方式一：通过标准输入传递密码（首选）

echo $CI_REGISTRY_PASSWORD | docker login -u $CI_REGISTRY_USER --password-stdin $CI_REGISTRY

这种方式不会在日志里留下密码痕迹，哪怕你开启了详细日志，GitLab也会自动过滤敏感内容，完美适配非交互式环境。

方式二：通过命令行参数传递密码

docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY

虽然GitLab也会自动屏蔽密码，但从安全角度来说，用标准输入传递更稳妥。

3. 调整你的.gitlab-ci.yml配置
   结合上面的修改，优化后的build_docker_image job应该是这样的：

build_docker_image:
  image: docker:latest
  stage: build
  # 必须添加这个服务，否则Docker守护进程无法启动
  services:
    - docker:dind
  script:
    # 非交互式登录GitLab容器仓库
    - echo $CI_REGISTRY_PASSWORD | docker login -u $CI_REGISTRY_USER --password-stdin $CI_REGISTRY
    # 构建镜像，用GitLab预定义变量CI_PROJECT_PATH代替硬编码路径，更通用
    - docker build --no-cache -t ${CI_REGISTRY}/${CI_PROJECT_PATH} .
    - docker push ${CI_REGISTRY}/${CI_PROJECT_PATH}

额外提醒两个关键点： #

• 使用docker:latest镜像构建时，一定要加上docker:dind服务（Docker-in-Docker），否则docker build会因为找不到守护进程而失败。
• 你当前的build_golang_binary和build_docker_image属于同一build阶段，默认是并行执行的，这会导致构建镜像时可能还没生成Go二进制文件。如果你的Dockerfile需要用到这个二进制，要么把两个job合并，要么用artifacts和dependencies传递文件，确保执行时序正确。

比如合并后的job示例（一步完成二进制构建和镜像推送）：

build_and_push:
  image: golang:latest
  stage: build
  services:
    - docker:dind
  before_script:
    - mkdir -p ${GOPATH}/src/${GO_PROJECT}
    - cp -r ${CI_PROJECT_DIR}/* ${GOPATH}/src/${GO_PROJECT}/
    - cd ${GOPATH}/src/${GO_PROJECT}
    - go get
    # 给golang镜像安装Docker客户端
    - apt-get update && apt-get install -y docker.io
  script:
    - go build
    # 把二进制文件复制回项目目录，方便Docker构建
    - cp ${GOPATH}/src/${GO_PROJECT}/${GO_PROJECT} ${CI_PROJECT_DIR}/
    - cd ${CI_PROJECT_DIR}
    - echo $CI_REGISTRY_PASSWORD | docker login -u $CI_REGISTRY_USER --password-stdin $CI_REGISTRY
    - docker build --no-cache -t ${CI_REGISTRY}/${CI_PROJECT_PATH} .
    - docker push ${CI_REGISTRY}/${CI_PROJECT_PATH}

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