GitLab流水线执行AWS-CDK synth遇spawnSync docker ENOENT错误求助

Error: spawnSync docker ENOENT 本质是当前运行环境中找不到docker命令。你的CDK项目中大概率包含需要构建Docker镜像的资源（比如DockerImageAsset、lambda.DockerImageFunction这类构造），执行cdk synth时会触发Docker镜像构建操作，但你使用的node:16.3.0-alpine基础镜像默认不包含Docker客户端，导致命令调用失败。

1. 给Alpine镜像安装Docker客户端 #

在流水线的script阶段先安装Docker CLI工具，同时确保GitLab Runner具备Docker访问权限：
修改build阶段的脚本：

build:
  tags:
    - mytag
  environment: ${CI_COMMIT_BRANCH}
  stage: build
  script:
    - apk add --no-cache docker-cli  # 安装Docker客户端
    - npm i
    - cdk synth --no-staging > template.yaml
  artifacts:
    paths:
      - cdk.out
    expire_in: 30 mins

同时要确认你的GitLab Runner配置满足以下任一条件：

• 如果是Docker executor：配置privileged: true启用docker-in-docker模式，或者挂载宿主机的Docker socket（在Runner的config.toml中添加volumes = ["/var/run/docker.sock:/var/run/docker.sock"]）
• 如果是Shell executor：宿主机已安装Docker，且Runner执行用户拥有Docker操作权限（比如加入docker用户组）

2. 检查并移除不必要的Docker依赖 #

如果你的CDK项目实际上不需要构建Docker镜像，排查是否误引入了需要Docker的构造，比如：

• 确认是否使用了aws-cdk-lib/aws-ecr-assets.DockerImageAsset
• 确认Lambda函数是否用了lambda.DockerImageFunction而非常规的lambda.Function
  移除这类构造后，cdk synth就不会调用Docker命令。

3. 更换包含Docker的Node镜像 #

如果不想手动安装Docker，可以换用预安装了Docker的Node镜像，比如cimg/node:16.3.0（内置Docker客户端），修改流水线的image字段即可：

image: cimg/node:16.3.0

内容的提问来源于stack exchange，提问作者red house 87