argonet/docker-compose Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Docker Compose 镜像文档

镜像概述

本镜像基于 docker:git 基础镜像构建，额外集成了 docker-compose 工具，专门用于验证 docker-compose.yaml 文件的语法和配置有效性。它提供了独立的环境，无需在本地系统单独安装 docker-compose，即可快速检查配置文件的正确性。

核心功能与特性

• 基础环境：基于官方 docker:git 镜像，包含 Docker 客户端和 Git 工具
• 工具集成：预安装 docker-compose，支持直接执行配置验证命令
• 轻量设计：在基础镜像上最小化添加必要组件，保持镜像精简
• 便捷验证：可直接通过 docker-compose config 命令验证 YAML 文件语法和结构

使用场景

• 开发阶段：开发人员编写 docker-compose.yaml 后，快速验证配置是否存在语法错误
• CI/CD 流程：作为持续集成/部署管道的前置检查步骤，确保配置文件有效后再进行部署
• 配置审核：在多人协作中，验证提交的 docker-compose 配置是否符合规范

使用方法

基本验证命令

通过以下命令验证当前目录下的 docker-compose.yaml 文件：

bash
docker run --rm -v $(pwd):/app -w /app [镜像名称] docker-compose config

参数说明：

• --rm：容器运行结束后自动删除
• -v $(pwd):/app：将当前目录挂载到容器内的 /app 目录
• -w /app：设置工作目录为 /app，确保命令在挂载目录执行
• [镜像名称]：替换为实际使用的镜像名称
• docker-compose config：执行配置验证，若配置正确则输出解析后的配置，否则显示错误信息

验证自定义文件名

若需验证非默认名称的配置文件（如 docker-compose.prod.yaml），使用 -f 参数指定文件：

bash
docker run --rm -v $(pwd):/app -w /app [镜像名称] docker-compose -f docker-compose.prod.yaml config

CI/CD 集成示例（GitHub Actions）

在 .github/workflows/validate.yml 中添加验证步骤：

yaml
name: Validate Docker Compose
on: [pull_request]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run docker-compose validation
        run: |
          docker run --rm -v $(pwd):/app -w /app [镜像名称] docker-compose config

注意事项

• 确保挂载目录包含待验证的 docker-compose 文件
• 若配置文件引用本地资源（如 .env 文件），需同时挂载相关文件
• 本镜像专注于配置验证，不建议用于实际容器部署操作