通过Terraform构建镜像部署AWS ECR时CircleCI连接Docker报错

本地执行terraform apply可正常将镜像推送至AWS ECR，同时成功创建ECS集群、任务定义与服务，但通过CircleCI执行相关Docker命令时失败，报错信息：

无法连接unix:///var/run/docker.sock的Docker守护进程。

1. 确认CircleCI配置中启用Docker守护进程 #

CircleCI默认不会自动启动本地Docker守护进程，需在.circleci/config.yml中明确配置：

• 若使用Docker执行器，添加setup_remote_docker步骤：

version: 2.1
jobs:
  deploy:
    docker:
      - image: cimg/base:stable
    steps:
      - setup_remote_docker:
          version: 20.10.14 # 指定与本地兼容的Docker版本
      # 后续的Terraform执行、Docker镜像推送等步骤

• 若使用机器执行器，确保镜像自带Docker并验证状态：

jobs:
  deploy:
    machine:
      image: ubuntu-2004:2023.04.2
    steps:
      - run: docker --version # 确认Docker已安装并运行

2. 检查Terraform Docker Provider配置 #

如果Terraform的Docker Provider硬编码了本地sock地址，需适配CircleCI的远程Docker环境：

provider "docker" {
  host = "tcp://localhost:2376" # CircleCI远程Docker默认端口
  # 若启用TLS，需补充cert_file、key_file等配置
}

也可以不手动指定host，让Provider自动读取CircleCI环境中的Docker连接变量。

3. 验证Docker守护进程状态 #

在CircleCI任务中添加前置检查命令，确认Docker是否正常运行：

run:
  name: 检查Docker状态
  command: |
    docker info
    systemctl status docker || true

如果返回Docker未启动，尝试手动重启：

sudo systemctl restart docker

4. 修复sock文件权限问题 #

如果是权限不足导致无法访问/var/run/docker.sock，临时调整权限：

sudo chmod 666 /var/run/docker.sock

但更推荐使用官方setup_remote_docker方案，避免权限隐患。

5. 确认ECR推送的权限配置 #

确保CircleCI任务中已正确配置AWS凭证（通过环境变量或AWS CLI配置），执行ECR登录命令时使用CircleCI的Docker环境：

aws ecr get-login-password --region <你的区域> | docker login --username AWS --password-stdin <你的AWS账号ID>.dkr.ecr.<你的区域>.amazonaws.com

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