docker/compose-desktop-module-test

Docker Compose二进制测试镜像 技术文档

1. 镜像概述和主要用途

本镜像为专用测试镜像，旨在提供标准化环境，用于验证Docker Compose二进制文件的完整性、兼容性及运行时行为。主要用途包括：测试Compose二进制文件在不同场景下的功能正确性、验证二进制文件的版本信息及基础命令执行结果、隔离测试环境以避免对宿主系统的干扰。

2. 核心功能和特性

• 隔离测试环境：基于轻量级基础镜像（如Alpine）构建，提供最小化且隔离的运行环境，确保测试结果不受宿主系统配置影响。
• 多版本支持：支持通过配置参数指定待测试的Compose二进制文件版本，适配不同版本的兼容性测试需求。
• 基础工具集成：内置基础Shell工具（如sh、curl、file），便于执行测试命令及验证二进制文件属性（如文件类型、权限）。
• 灵活配置：支持通过环境变量和挂载卷自定义测试命令及待测试的二进制文件路径，适配多样化测试场景。

3. 使用场景和适用范围

• Compose开发人员本地测试：开发Docker Compose工具时，用于本地快速验证编译生成的二进制文件功能。
• CI/CD流程集成：在持续集成/持续部署流程中，作为二进制文件构建后的验证环节，自动检测构建产物的可用性。
• 多环境兼容性测试：在不同架构（如amd64、arm64）或系统环境下，验证Compose二进制文件的跨平台兼容性。

4. 使用方法和配置说明

4.1 镜像信息

• 默认镜像名称：test/compose-binaries
• 默认标签：latest（可指定特定版本标签，如v1.0）

4.2 拉取镜像

通过docker pull命令拉取镜像：

bash
docker pull test/compose-binaries:latest

4.3 运行容器

4.3.1 基础测试命令

将本地待测试的Compose二进制文件挂载至容器内，并执行测试命令：

bash
# 假设本地Compose二进制文件路径为 ./compose
docker run --rm \
  -v $(pwd)/compose:/usr/local/bin/compose  # 挂载本地二进制文件至容器内可执行路径 \
  -e TEST_CMD="compose version && compose --help"  # 测试命令：验证版本及帮助信息 \
  test/compose-binaries:latest

4.3.2 多版本兼容性测试

通过环境变量COMPOSE_VERSION指定测试版本（需确保本地二进制文件与指定版本匹配）：

bash
docker run --rm \
  -v $(pwd)/compose-v2.20.0:/usr/local/bin/compose \
  -e COMPOSE_VERSION=2.20.0 \  # 标记当前测试版本（用于日志或报告）
  -e TEST_CMD="compose version | grep 'v2.20.0'"  # 验证版本号是否匹配 \
  test/compose-binaries:latest

4.4 配置参数

4.4.1 环境变量

4.4.2 挂载卷

4.5 docker-compose配置示例

通过docker-compose.yml定义测试服务，适用于多步骤或依赖管理的测试场景：

yaml
version: '3.8'

services:
  compose-test:
    image: test/compose-binaries:latest
    volumes:
      - ./local-compose:/usr/local/bin/compose  # 挂载本地二进制文件
      - ./test-scripts:/scripts  # 可选：挂载外部测试脚本（如批量测试命令）
    environment:
      - COMPOSE_VERSION=2.21.0
      - TEST_CMD="/scripts/run-tests.sh"  # 执行外部脚本中的测试命令
    command: sh -c "$TEST_CMD"  # 覆盖默认命令，执行环境变量指定的测试脚本

使用方法：

bash
# 启动测试服务
docker-compose up

# 查看测试日志
docker-compose logs

5. 注意事项

• 确保本地待测试的Compose二进制文件具备执行权限（可通过chmod +x ./compose添加）。
• TEST_CMD中涉及文件操作或网络请求时，需确保容器内有对应权限（如挂载宿主机目录、配置网络模式）。
• 本镜像仅用于测试场景，不建议用于生产环境部署。
• 若测试命令涉及compose up等需要Docker daemon的操作，需挂载宿主机Docker socket（-v /var/run/docker.sock:/var/run/docker.sock）。