如何在GitLab CI/CD变量中自动配置Docker配置？

方法一：使用GitLab内置的DOCKER_AUTH_CONFIG特殊变量 #

GitLab CI/CD原生支持DOCKER_AUTH_CONFIG变量，配置后Runner会自动生成~/.docker/config.json，完全无需手动执行写入命令：

• 在GitLab项目的设置 > CI/CD > 变量中添加变量：
  • 类型：Variable
  • 键：DOCKER_AUTH_CONFIG
  • 值：你的Docker配置JSON（示例：{"auths":{"registry.redhat.io":{"auth":"<base64>"}}}）
  • 可选勾选保护变量（根据安全需求）

配置完成后，所有Docker命令会自动读取生成的配置文件，无需额外脚本。

方法二：通过DOCKER_CONFIG环境变量自定义配置路径 #

如果需要自定义配置文件存放路径，可以通过全局脚本统一处理，避免每个任务重复编写：

1. 在GitLab项目变量中添加File类型变量：
   • 键：DOCKER_CONFIG_JSON
   • 值：你的Docker配置JSON内容
2. 在项目.gitlab-ci.yml中设置全局前置脚本：

   default:
     before_script:
       - mkdir -p $CI_PROJECT_DIR/.docker
       - cat $DOCKER_CONFIG_JSON > $CI_PROJECT_DIR/.docker/config.json
       - export DOCKER_CONFIG=$CI_PROJECT_DIR/.docker
   

所有任务会自动执行上述步骤，Docker将读取$DOCKER_CONFIG/config.json中的凭证信息。

为什么之前的尝试不生效？ #

你之前将DOCKER_CONFIG设为File类型变量，导致$DOCKER_CONFIG指向的是一个文件路径，但Docker的规则是：DOCKER_CONFIG环境变量必须指向目录，Docker会自动在该目录下寻找config.json文件，而非直接读取变量指向的文件，因此不符合Docker的要求。

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