asuuto/ci-build

ci-build 镜像文档

镜像概述和主要用途

ci-build 是一个专为持续集成（CI）构建流程设计的Docker镜像，集成了主流构建工具和环境依赖，提供标准化、可重复的构建环境。该镜像旨在自动化代码编译、单元测试、集成测试及应用打包过程，减少手动操作，提升团队构建效率和环境一致性，适用于各类软件开发项目的CI/CD流程。

核心功能和特性

• 多语言支持：兼容Java、Python、Node.js、Go等主流编程语言的构建需求
• 工具集成：内置Git、Maven、Gradle、npm、yarn等常用构建及版本控制工具
• 自动化流程：支持自定义构建脚本，实现从代码拉取到产物输出的全流程自动化
• 轻量级设计：基于Alpine或Debian slim基础镜像，优化镜像体积，加快下载和启动速度
• 环境一致性：消除"在我机器上能运行"问题，确保不同环境（开发/测试/CI平台）构建结果一致

使用场景和适用范围

• 开发团队日常构建：开发人员本地或CI平台执行代码构建、测试验证
• 多环境构建管理：支持开发、测试、预发布、生产等多环境构建配置
• CI/CD平台集成：无缝对接Jenkins、GitLab CI、GitHub Actions、GitLab CI等主流CI/CD工具
• 开源项目自动化：为开源项目提供标准化构建流程，降低贡献者参与门槛
• 微服务构建流水线：适用于微服务架构中多模块并行构建场景

使用方法和配置说明

基本使用方式

通过docker run命令启动容器，挂载项目目录并执行构建命令：

bash
docker run -v $(pwd):/app -w /app ci-build:latest [构建命令]

常用命令示例：

• Maven项目构建：

  bash
  docker run -v $(pwd):/app -w /app ci-build:latest mvn clean package -DskipTests
  

• Node.js项目测试：

  bash
  docker run -v $(pwd):/app -w /app ci-build:latest npm install && npm test
  

• Go项目编译：

  bash
  docker run -v $(pwd):/app -w /app ci-build:latest go build -o app main.go
  

Docker Compose配置示例

创建docker-compose.yml文件定义构建服务：

yaml
version: '3.8'
services:
  ci-build:
    image: ci-build:latest
    volumes:
      - ./:/app                      # 挂载项目目录
      - ~/.m2:/root/.m2              # 可选：挂载Maven本地仓库缓存
      - ~/.npm:/root/.npm            # 可选：挂载npm缓存
    working_dir: /app
    environment:
      - BUILD_DIR=/app               # 构建工作目录
      - TEST_CMD="npm run test"      # 自定义测试命令
    command: sh -c "npm install && npm run build"

启动构建：

bash
docker-compose up

环境变量配置

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

环境变量使用示例：

bash
docker run -e BUILD_DIR=/code -e TEST_CMD="pytest" -e LOG_LEVEL=DEBUG -v $(pwd):/code -w /code ci-build:latest

注意事项

• 挂载宿主机目录时需确保目录权限正确，避免因权限不足导致构建失败
• 大型项目建议启用构建缓存（如挂载Maven/Gradle/npm缓存目录）以提升构建速度
• 复杂构建流程建议编写独立构建脚本（如build.sh），通过容器执行脚本实现灵活控制
• 生产环境使用时建议指定具体版本标签（如ci-build:1.2.0）而非latest，确保构建稳定性