snapkitchen/concourse-docker-compose

concourse-docker-compose

概述

此Docker镜像及辅助库允许在Concourse CI平台上运行集成Docker Compose的Docker-in-Docker（DinD）环境，镜像内置bash以支持辅助库的使用，方便用户快速执行容器化任务。

核心功能

1. 提供DinD环境并集成Docker Compose工具，支持Concourse CI任务中的容器编排需求
2. 包含bash辅助库，实现Docker引擎的启动/停止、镜像保存/加载等自动化操作
3. 支持通过Docker Hub构建钩子自动生成不同Docker引擎版本的镜像，标签及元数据清晰记录版本信息
4. 提供本地构建脚本，便于开发或测试阶段定制镜像版本

使用场景

• Concourse CI流水线中执行需要Docker Compose的容器化任务（如多容器应用构建、部署验证）
• 本地开发环境中模拟Concourse CI的DinD任务场景，进行调试或预验证

配置说明

辅助库使用示例（Concourse任务）

yaml
- task: run-hello-world
  image: concourse-docker-compose
  privileged: true
  config:
    platform: linux
    run:
      path: /bin/bash
      args:
      - -c
      - |
        set -e
        source /usr/local/lib/concourse-docker-compose/docker-v1.bash
        start_docker
        docker run hello-world
        stop_docker

辅助库关键API

• start_docker：启动Docker引擎，清理历史cgroup残留，设置退出陷阱自动停止引擎（超时120秒）
• stop_docker：停止Docker引擎
• save_image NAME TAG DIR [FILENAME] [ID_FILENAME]：避免重复保存镜像到指定目录，更新镜像ID记录
• load_image NAME TAG DIR [FILENAME] [ID_FILENAME]：从指定目录加载镜像并打标签

本地构建镜像

使用脚本构建指定Docker引擎版本的镜像：

bash
./scripts/build 18.06

许可证

详见https://github.com/Snapkitchen/concourse-docker-compose/blob/master/LICENSE%EF%BC%8C%E9%83%A8%E5%88%86%E4%BB%A3%E7%A0%81%E6%9D%A5%E8%87%AAhttps://github.com/concourse/docker-image-resource%EF%BC%8C%E9%81%B5%E5%BE%AAApache 2.0许可证。