GitLab CI/CD中使用aws-base镜像执行Docker命令失败求助

问题原因 #

registry.gitlab.com/gitlab-org/cloud-deploy/aws-base:latest镜像仅包含AWS CLI和Docker客户端，但没有内置Docker守护进程，默认情况下无法连接到可用的Docker daemon，因此执行docker build、docker login等命令时会触发连接失败报错。

解决方案 #

有两种常用修复方式，按需选择：

方式一：挂载宿主机Docker套接字 #

直接共享GitLab Runner宿主机的Docker守护进程，适合对环境隔离性要求不高的场景：
修改CI配置，在job中添加volumes挂载宿主机的Docker套接字：

aws_ecr:
  image: registry.gitlab.com/gitlab-org/cloud-deploy/aws-base:latest
  stage: build
  # 添加挂载配置，共享宿主机Docker守护进程
  volumes:
    - /var/run/docker.sock:/var/run/docker.sock
  script:
    - aws ecr get-login-password | docker login --username AWS --password-stdin 51234567.dkr.ecr.ap-south-1.amazonaws.com
    - docker build --build-arg IMAGE_TAG=$IMAGE_TAG -t $IMAGE_NAME:$IMAGE_TAG .

注意：此方法要求GitLab Runner使用docker executor，且runner配置已开启privileged模式。

方式二：使用Docker-in-Docker（DinD）服务 #

启动独立的Docker守护进程服务，环境隔离性更强，适合需要独立构建环境的场景：
修改CI配置，添加services引入docker:dind并设置必要环境变量：

aws_ecr:
  image: registry.gitlab.com/gitlab-org/cloud-deploy/aws-base:latest
  stage: build
  # 引入DinD服务
  services:
    - name: docker:dind
      alias: docker
  # 配置环境变量，让Docker客户端连接到DinD服务
  variables:
    DOCKER_HOST: tcp://docker:2376
    DOCKER_TLS_CERTDIR: "/certs"
    DOCKER_TLS_VERIFY: 1
    DOCKER_CERT_PATH: "$DOCKER_TLS_CERTDIR/client"
  script:
    - aws ecr get-login-password | docker login --username AWS --password-stdin 51234567.dkr.ecr.ap-south-1.amazonaws.com
    - docker build --build-arg IMAGE_TAG=$IMAGE_TAG -t $IMAGE_NAME:$IMAGE_TAG .

注意：此方法要求GitLab Runner处于privileged模式（DinD运行需要特权权限）。

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