平台构建CI运行器镜像文档

镜像概述

本镜像作为CI/CD流程的核心执行环境，专为平台级项目构建设计，集成完整的开发工具链与自动化能力。通过标准化运行环境，解决多团队协作中的环境一致性问题，实现从代码提交到制品交付的全流程自动化，提升平台项目的构建效率与可靠性。

核心功能与特性

• 全流程自动化：支持代码拉取、依赖解析、编译构建、单元测试、集成测试到制品打包的端到端自动化执行
• 多工具集成：预装Git、Maven 3.8+、Gradle 7+、Docker 20+、Node.js 16+等开发工具，适配Java、Python、Go、JavaScript等多语言项目
• 环境一致性保障：容器化设计确保不同环境（开发/测试/生产）的构建配置统一，消除"本地可运行，CI构建失败"的环境差异问题
• 灵活工作流适配：兼容GitLab CI、GitHub Actions、Jenkins等主流CI/CD平台，支持自定义构建脚本与流程编排
• 资源优化：内置缓存机制，加速依赖下载与构建过程，支持增量构建以减少重复计算

使用场景

• 团队日常开发构建：替代本地手动构建流程，开发人员提交代码后自动触发构建，即时反馈构建结果
• 持续集成流水线：作为CI系统的执行节点，实现代码合并前的自动化验证（语法检查、单元测试、代码质量分析）
• 多架构平台构建：支持x86_64、ARM64等多架构构建环境，满足跨平台部署需求
• 版本发布自动化：集成制品推送能力，构建完成后自动将产物推送至Maven仓库、Docker Registry等存储服务

使用方法与配置说明

基础运行命令

bash
docker run -it --rm \
  --name platform-ci-runner \
  -v /本地项目路径:/workspace \
  -e CI_PROJECT_DIR=/workspace \
  -e BUILD_SCRIPT=./scripts/build.sh \
  -e TEST_ENABLED=true \
  [镜像名称]:[版本标签]

核心环境变量配置

高级配置示例（Docker Compose）

yaml
version: '3.8'
services:
  ci-runner:
    image: [镜像名称]:[版本标签]
    volumes:
      - ./project-code:/workspace:rw
      - ci-cache:/root/.cache:rw  # 持久化缓存目录
    environment:
      - CI_PROJECT_DIR=/workspace
      - BUILD_SCRIPT=./ci/build-pipeline.sh
      - TEST_ENABLED=true
      - ARTIFACT_OUTPUT_DIR=/workspace/target
      - LOG_LEVEL=info
    command: ["sh", "-c", "chmod +x $CI_PROJECT_DIR/$BUILD_SCRIPT && $CI_PROJECT_DIR/$BUILD_SCRIPT"]

volumes:
  ci-cache:  # 命名卷用于持久化缓存，加速后续构建

构建脚本规范

构建脚本（BUILD_SCRIPT指定文件）需包含以下关键步骤（根据项目类型调整）：

1. 环境检查（依赖工具版本验证）
2. 依赖安装（如npm install、mvn dependency:resolve）
3. 代码编译（如go build、javac）
4. 测试执行（如pytest、mvn test）
5. 产物打包（如docker build、mvn package）
6. 产物输出（将打包结果复制到ARTIFACT_OUTPUT_DIR）

示例构建脚本（build.sh）：

bash
#!/bin/bash
set -e  # 出错立即退出

# 依赖安装
echo "Installing dependencies..."
mvn dependency:resolve

# 代码编译
echo "Compiling source code..."
mvn compile

# 单元测试
if [ "$TEST_ENABLED" = "true" ]; then
  echo "Running unit tests..."
  mvn test
fi

# 产物打包
echo "Packaging artifacts..."
mvn package -DskipTests

# 输出产物到指定目录
mkdir -p "$ARTIFACT_OUTPUT_DIR"
cp target/*.jar "$ARTIFACT_OUTPUT_DIR/"

echo "Build completed successfully. Artifacts in $ARTIFACT_OUTPUT_DIR"