defangio/cd-sandbox

CD测试构建镜像

镜像概述

本镜像专为持续部署(CD)流程中的测试构建任务设计，提供执行和验证部署构建的基础环境。通过集成必要的构建工具和测试组件，帮助开发与运维团队在部署前对构建产物进行验证，确保部署流程的正确性、稳定性及兼容性。

核心功能与特性

• 构建环境支持：内置常见构建工具，适配多编程语言和项目类型的测试构建需求
• 流程验证：提供基础框架验证CD流程中的构建步骤，包括依赖检查、编译过程和产物生成
• 轻量级设计：优化镜像体积，减少资源占用，适合集成到CI/CD管道高效运行
• 可扩展性：支持通过配置文件或环境变量自定义构建参数，适应不同项目测试需求

使用场景与适用范围

• CI/CD管道集成：作为CD流程关键环节，在正式部署前执行测试构建，提前发现构建问题
• 部署流程验证：验证新部署脚本、配置变更或环境更新对构建过程的影响
• 开发团队测试：开发人员本地或开发环境快速测试构建流程，确保代码提交符合规范
• 多环境适配测试：在不同配置的测试环境中验证构建产物的兼容性和可部署性

使用方法与配置说明

基本使用（Docker Run）

启动基础测试构建任务：

bash
docker run --rm -v $(pwd):/app test-builds-of-cd:latest

• -v $(pwd):/app：挂载本地项目目录到容器/app目录作为构建上下文
• 默认在/app目录执行基础构建测试流程

自定义构建参数

通过环境变量自定义构建行为：

示例：使用自定义命令和完整测试模式

bash
docker run --rm -v $(pwd):/app \
  -e BUILD_CMD="npm run build" \
  -e TEST_MODE="full" \
  test-builds-of-cd:latest

Docker Compose 配置

CI/CD管道集成配置：

yaml
version: '3'
services:
  cd-test-build:
    image: test-builds-of-cd:latest
    volumes:
      - ./project:/app
    environment:
      - BUILD_CMD="mvn clean package"
      - TEST_MODE="full"
      - LOG_LEVEL="debug"
    command: ["sh", "-c", "$BUILD_CMD && echo 'Build test completed'"]

输出与结果查看

构建测试结果输出到标准输出，详细日志保存于/var/log/build-test.log：

bash
docker exec -it <container-id> cat /var/log/build-test.log

注意事项

• 确保挂载目录包含构建所需配置文件（如build.sh、package.json）
• 生产环境CI/CD管道建议使用具体镜像标签（如:v1.0.0）而非latest，确保版本一致
• 完整测试模式（TEST_MODE=full）执行更多验证步骤，需更多时间和资源