govukpay/concourse-runner

Concourse Docker-in-Docker镜像

镜像概述

该镜像专为Concourse CI/CD平台设计，提供Docker-in-Docker（DinD）功能，允许在Concourse任务容器内部运行Docker命令和容器化操作。通过此镜像，用户可在Concourse流水线中构建、运行和管理Docker容器，特别适合需要容器化环境支持的Java集成测试等场景。

核心功能与特性

• Docker-in-Docker支持：在容器内部提供完整的Docker daemon，支持标准Docker命令（如docker build、docker run等）
• Concourse兼容性：针对Concourse任务环境优化，可直接集成到Concourse流水线配置中
• 轻量级设计：基于官方Docker镜像构建，保持较小体积同时提供完整功能
• 多场景适配：不仅支持Java集成测试，还可用于需要容器化环境的各类自动化测试和构建任务

使用场景与适用范围

• Concourse流水线中的Java集成测试：在测试阶段启动依赖服务容器（如数据库、消息队列等）
• 容器化应用的构建验证：在CI流程中构建并临时运行应用容器进行功能验证
• 多容器协作测试：模拟微服务架构中多个容器间的交互测试
• Dockerfile语法检查与构建测试：验证项目Dockerfile的正确性和构建结果

使用方法与配置说明

基础使用（Concourse任务配置）

在Concourse流水线的task配置中使用该镜像：

yaml
jobs:
- name: java-integration-test
  plan:
  - get: source-code
  - task: run-tests
    image: <镜像名称>
    privileged: true  # DinD环境需要特权模式
    config:
      platform: linux
      run:
        path: sh
        args:
        - -c
        - |
          # 启动Docker daemon
          dockerd &
          sleep 5  # 等待daemon启动
          
          # 运行Java集成测试（示例）
          cd source-code
          ./mvnw verify -Pintegration-tests

Docker run命令示例（本地测试）

bash
docker run -it --privileged <镜像名称> sh
# 在容器内启动Docker daemon
dockerd &
# 验证Docker功能
docker info

关键配置参数

• 特权模式：必须启用--privileged标志，DinD环境需要访问主机设备和内核功能
• Docker daemon启动：使用dockerd命令手动启动Docker守护进程，可添加参数如--storage-driver overlay2指定存储驱动
• 网络配置：默认使用桥接网络，可通过--network参数自定义网络模式
• 存储卷挂载：如需持久化Docker数据，可挂载卷到/var/lib/docker目录

环境变量说明

注意事项

• 仅在可信环境中使用特权容器，避免安全风险
• DinD环境性能可能略低于直接使用主机Docker，适合测试场景而非生产环境
• 长时间运行任务需注意Docker daemon资源占用，必要时添加资源限制
• 确保Concourse worker节点支持特权容器运行（需配置allow_privileged选项）