Docker Compose CI工具镜像文档

镜像概述与主要用途

本镜像为一款用于CI（持续集成）环境的工具镜像，专注于提供便捷的Docker和Docker Compose工具链支持。其核心定位是简化CI流程中的工具配置，目前主要用于支持Docker-in-Docker（dind）构建等CI场景，帮助开发团队快速集成和定制CI环境中的容器化工具链。

核心功能与特性

• 简化定制流程：内置Makefile抽象构建逻辑，支持通过环境变量快速自定义Docker和Docker Compose版本。
• 版本灵活配置：可按需指定Docker引擎和Docker Compose的版本，适配不同CI场景的工具版本需求。
• 提交规范与CHANGELOG自动化：可选集成standard-version、husky、commit-lint等工具，支持规范化提交信息和自动生成CHANGELOG.md。

使用场景与适用范围

适用场景

• CI/CD流水线中的Docker工具链配置
• 支持dind（Docker-in-Docker）构建环境的CI任务
• 需要统一Docker和Docker Compose版本的团队CI流程

适用范围

开发团队的CI/CD工具链，尤其适合对容器化构建依赖较高的自动化流水线。

使用方法与配置说明

前提条件

• 本地环境需安装Node.js（如需使用可选的提交规范和CHANGELOG工具）。
• 具备Docker环境及镜像仓库访问权限（用于构建和推送镜像）。

构建与推送镜像

通过镜像内置的Makefile可快速构建并推送自定义版本的镜像，核心命令如下：

bash
# 自定义Docker和Docker Compose版本，构建并推送镜像
make DOCKER_VERSION=19.03.2 DOCKER_COMPOSE_VERSION=1.24.1 build push

其中，build目标用于构建镜像，push目标用于推送至指定仓库。

环境变量配置

镜像支持通过环境变量自定义构建参数，具体变量说明如下：

可选功能：提交规范与CHANGELOG自动化

如需集成提交信息规范检查和CHANGELOG自动生成工具，可执行以下步骤：

1. 运行make init初始化工具依赖：

   bash
   make init
   

   该命令会安装以下Node.js模块：

   • standard-version：自动化版本管理和CHANGELOG生成
   • husky：Git钩子工具，用于提交前校验
   • commit-lint：提交信息格式校验

2. 完成初始化后，提交信息需遵循Conventional Commits规范，工具链将自动生成CHANGELOG.md并管理版本号。

贡献指南

1. Fork本项目仓库
2. 创建特性分支（git checkout -b feature/your-feature）
3. 提交变更（git commit -am 'Add some feature'）
4. 推送分支至远程（git push origin feature/your-feature）
5. 创建Pull Request

许可证

Copyright (c) 2020 Territory Embrace - Talent Platforms.