GitLab CI中LocalStack运行Lambda的Docker连接问题求助

核心问题根源 #

当前配置跑不通的本质是：你用GitLab内置services模式拉起来的LocalStack附属容器，既没有挂载Runner宿主机的Docker daemon socket，也和主构建容器不在同一个可直连的网络域里，完全满足不了LAMBDA_EXECUTOR=docker模式要求的Docker访问权限，自然会在启动Lambda独立容器的时候报各种连接错误。

有效配置方案 #

方案1：保留Docker执行器，手动启动带Socket挂载的LocalStack #

• 弃用GitLab内置的services快捷配置，这种模式下附属容器默认无权限访问宿主机Docker daemon，根本支撑不了Docker类型的Lambda执行器
• 调整流水线配置为手动启动LocalStack容器，关键调整点：
  • 在主构建容器内安装Docker客户端，用来操作宿主机Docker
  • 启动LocalStack时挂载宿主机的/var/run/docker.sock到容器内部，让LocalStack可以直接调用宿主机Docker创建Lambda运行容器
  • 采用host网络模式启动LocalStack，避免跨容器域名解析的问题

调整后的可用配置参考：

integration-test:
  stage: integration-test
  image: node:14-alpine3.12
  tags:
    - docker
  variables:
    # LocalStack基础运行配置
    LAMBDA_EXECUTOR: docker
    HOSTNAME_EXTERNAL: localstack
    DEFAULT_REGION: eu-west-1
    USE_SSL: "false"
    DEBUG: "1"
    AWS_ACCESS_KEY_ID: test
    AWS_SECRET_ACCESS_KEY: test
    AWS_DEFAULT_REGION: eu-west-1
  before_script:
    # 安装构建环境需要的客户端工具
    - apk add --no-cache docker-cli curl
    # 手动启动LocalStack容器，挂载宿主机Docker socket打通权限
    - docker run -d --name localstack --network host -v /var/run/docker.sock:/var/run/docker.sock localstack/localstack
    # 等待LocalStack完成启动后再执行后续操作
    - until curl -sf http://localhost:4566/_localstack/health; do sleep 2; done
  script:
    - npm ci
    - npx sls deploy --stage local --region eu-west-1
    - npx jest --testMatch='**/*.integration.js'
  after_script:
    # 流水线执行结束后强制清理LocalStack容器，避免环境残留
    - docker rm -f localstack
  only:
    - merge_requests

这个配置的跑通逻辑：

• 挂载docker.sock后，LocalStack不需要额外配置DOCKER_HOST，会自动通过unix socket连接可用的Docker daemon，创建Lambda容器时不会再抛出连接错误
• host网络模式下，LocalStack的4566端口直接绑定在Runner宿主机上，主构建容器可以通过localhost访问LocalStack，不需要维护额外的服务别名映射

方案2：切换本地Lambda执行器，无Docker依赖 #

如果不想手动管理LocalStack的启动和清理逻辑，可以直接调整LocalStack的运行参数：

• 将变量LAMBDA_EXECUTOR的值从docker改为local
• 这种模式下LocalStack会直接在自身进程空间运行Lambda函数，完全不需要调用外部Docker daemon，100%兼容GitLab内置的services附属容器模式，不需要额外的socket挂载配置
• 注意模式限制：该方案仅适合测试无特殊系统依赖的Lambda逻辑，需要自定义二进制依赖、多架构运行时的场景不适用

之前尝试无效的原因 #

• 配置DOCKER_HOST=tcp://docker:2375：GitLab内置services的DNS仅能解析流水线中定义的服务别名（如你配置的localstack），不存在名为docker的服务条目，因此会出现域名解析失败
• 配置DOCKER_HOST=tcp://localhost:2375：该地址指向LocalStack容器自身的回环网络，LocalStack本身没有在2375端口部署Docker daemon，自然无法建立连接
• 默认unix socket连接失败：GitLab的services附属容器默认不会自动将宿主机的/var/run/docker.sock挂载到容器内部，容器内不存在该路径文件，因此提示连接失败

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