如何在Google Cloud Build的Docker构建器中启用实验性功能？

你遇到的核心问题是：Cloud Build托管的Docker Daemon默认未启用实验性功能，而--squash需要Daemon端开启实验模式才能生效，仅开启客户端实验功能无法解决问题。以下是几个实用的解决办法：

方案1：用BuildKit原生压缩替代--squash #

你已经启用了DOCKER_BUILDKIT=1，BuildKit本身提供了比--squash更高效的镜像压缩能力，且属于标准功能，无需依赖实验模式。修改构建步骤如下：

- name: 'gcr.io/cloud-builders/docker'
  entrypoint: 'bash'
  args:
      ['-c', 'docker build --compress --memory-swap=-1 -t eu.gcr.io/$PROJECT_ID/${_IMAGE_TAG} -f ${_IMAGE_NAME}/Dockerfile .']
  env:
   - "DOCKER_BUILDKIT=1"

--compress参数会让BuildKit在构建时压缩镜像层，同时BuildKit的镜像存储格式本身就比传统格式更紧凑，能有效减小镜像体积。

方案2：使用多阶段构建（推荐） #

这是目前减小Docker镜像体积最主流、最有效的方式，完全不需要依赖实验性功能。通过将构建环境和运行环境分离，只把运行所需的文件复制到最终镜像中，彻底消除构建过程中的冗余文件。

示例Dockerfile结构：

# 第一阶段：构建阶段，使用包含编译工具的完整镜像
FROM golang:1.21 AS builder
WORKDIR /app
COPY . .
RUN go build -o myapp

# 第二阶段：运行阶段，使用轻量基础镜像
FROM alpine:3.18
WORKDIR /app
COPY --from=builder /app/myapp .
CMD ["./myapp"]

这种方式能把动辄几百MB的镜像压缩到几十MB甚至更小，优化效果远好于--squash。

方案3：自定义Cloud Build Worker（不推荐） #

如果一定要使用--squash，需要创建自定义的Cloud Build Worker镜像，在其中启用Docker Daemon的实验性功能：

1. 创建自定义Worker的Dockerfile：

FROM gcr.io/cloud-builders/docker
RUN echo '{ "experimental": true }' > /etc/docker/daemon.json

2. 构建并推送自定义镜像到你的GCR仓库：

docker build -t eu.gcr.io/$PROJECT_ID/custom-docker-worker .
docker push eu.gcr.io/$PROJECT_ID/custom-docker-worker

3. 修改Cloud Build配置，使用自定义镜像：

- name: 'eu.gcr.io/$PROJECT_ID/custom-docker-worker'
  entrypoint: 'bash'
  args:
      ['-c', 'docker build --squash --memory-swap=-1 -t eu.gcr.io/$PROJECT_ID/${_IMAGE_TAG} -f ${_IMAGE_NAME}/Dockerfile .']
  env:
   - "DOCKER_BUILDKIT=1"

不过这种方式维护成本高，且Cloud Build托管环境的变动可能影响可用性，不如前两种方案可靠。

内容的提问来源于stack exchange，提问作者fabio.geraci