在Google Cloud Build上运行依赖Testcontainers的Spring Boot测试最佳实践

核心问题解决：Maven + Docker环境的实现 #

Google Cloud Build官方没有预构建同时集成Maven和Docker的Builder镜像，但有两种实用方案可以满足需求，其中挂载Docker socket是更简便的首选方案：

方案1：直接在Maven步骤中挂载Docker Socket（推荐）

Cloud Build允许步骤共享宿主机器的Docker socket，这样gcr.io/cloud-builders/mvn镜像不需要内置Docker，就能通过socket调用宿主的Docker服务，满足Testcontainers的运行需求。

修改你的构建配置如下：

steps:
# Git拉取代码（保持原配置不变）
- name: 'gcr.io/cloud-builders/git'
  args: ['-c', 'http.sslVerify=false', 'clone', '<my source repository>',
         '--branch', 'my-tag', '--single-branch']
# 运行测试并构建包（去掉跳过测试的参数，添加Docker socket挂载）
- name: 'gcr.io/cloud-builders/mvn'
  args: ['package']
  dir: src-dir
  volumes:
    - name: 'docker-socket'
      path: '/var/run/docker.sock'

# 可选：拆分测试与构建步骤
# - name: 'gcr.io/cloud-builders/mvn'
#   args: ['test']
#   dir: src-dir
#   volumes:
#     - name: 'docker-socket'
#       path: '/var/run/docker.sock'
# - name: 'gcr.io/cloud-builders/mvn'
#   args: ['package', '-DskipTests=true']
#   dir: src-dir

volumes:
  - name: 'docker-socket'
    hostPath:
      path: '/var/run/docker.sock'

Testcontainers会自动检测到挂载的socket，无需额外配置；如果出现检测问题，可以在Maven步骤中添加环境变量明确指定：

env:
  - 'DOCKER_HOST=unix:///var/run/docker.sock'

方案2：自定义包含Maven和Docker的Builder镜像

如果业务场景需要完全定制化的环境，可以自行构建包含Maven和Docker CLI的镜像：

1. 创建Dockerfile：

FROM maven:3.8-openjdk-17
RUN apt-get update && apt-get install -y docker.io && rm -rf /var/lib/apt/lists/*

2. 用Cloud Build构建并推送镜像到GCR：

steps:
- name: 'gcr.io/cloud-builders/docker'
  args: ['build', '-t', 'gcr.io/[你的项目ID]/maven-docker', '.']
images: ['gcr.io/[你的项目ID]/maven-docker']

3. 在项目构建配置中使用自定义镜像：

steps:
- name: 'gcr.io/cloud-builders/git'
  args: ['-c', 'http.sslVerify=false', 'clone', '<my source repository>',
         '--branch', 'my-tag', '--single-branch']
- name: 'gcr.io/[你的项目ID]/maven-docker'
  args: ['package']
  dir: src-dir
  volumes:
    - name: 'docker-socket'
      path: '/var/run/docker.sock'

volumes:
  - name: 'docker-socket'
    hostPath:
      path: '/var/run/docker.sock'

额外最佳实践 #

• 缓存Maven依赖：减少重复下载时间，可通过Cloud Build的缓存配置实现：

options:
  cache:
    paths:
      - '/root/.m2/repository/**'

• 配置足够资源：Testcontainers运行容器需要充足CPU和内存，可指定更高配置的机器类型：

options:
  machineType: 'E2_HIGHCPU_8'

• 自动清理容器：Testcontainers默认会在测试结束后清理容器，无需额外操作；若需强制清理，可在测试代码中添加@Testcontainers(disabledWithoutDocker = true)注解。

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