2000cubits/ci

CI镜像技术文档

镜像概述

本Docker镜像专为持续集成(CI)流程设计，集成了多种常用开发、构建和测试工具，旨在简化CI环境配置，提供一致的构建和测试环境，减少因环境差异导致的构建或测试失败，提升开发团队协作效率。

核心功能和特性

工具集成

• 版本控制工具：Git（支持代码拉取、分支管理）
• 构建工具：Maven 3.8.x、Gradle 7.x、npm 9.x、yarn 1.x、Python 3.9+、pip 23.x
• 测试工具：JUnit 5、pytest、Mocha、Jest
• 系统工具：curl、wget、ssh-client、jq

多语言支持

• 支持Java、Python、JavaScript/TypeScript、Go等多种编程语言项目的构建和测试

环境一致性

• 提供标准化的CI环境，确保不同开发人员和CI服务器使用相同版本的工具链，消除"在我电脑上能运行"的问题

轻量级设计

• 基于Alpine或Debian Slim基础镜像构建，平衡工具完整性和镜像体积

可定制配置

• 支持通过环境变量或挂载配置文件自定义工具行为（如Maven/Gradle仓库镜像、npm registry等）

使用场景和适用范围

自动化构建流程

• 集成到GitLab CI、Jenkins、GitHub Actions等CI/CD平台，执行代码拉取→依赖安装→编译构建流程

自动化测试执行

• 在CI流程中自动运行单元测试、集成测试，生成测试报告

多语言项目CI/CD管道

• 适用于包含多种编程语言的复杂项目，统一CI环境配置

快速搭建临时CI环境

• 开发人员本地调试CI脚本或构建流程，无需手动配置完整开发环境

使用方法和配置说明

基本使用

拉取镜像

bash
docker pull [镜像仓库地址]/ci-image:latest

启动交互式CI环境

bash
docker run -it --rm [镜像仓库地址]/ci-image:latest /bin/bash

执行自动化构建

挂载项目目录并执行构建命令

bash
# Java Maven项目示例
docker run --rm -v $(pwd):/app -w /app [镜像仓库地址]/ci-image:latest mvn clean package

# Node.js项目示例
docker run --rm -v $(pwd):/app -w /app [镜像仓库地址]/ci-image:latest npm install && npm run build

# Python项目示例
docker run --rm -v $(pwd):/app -w /app [镜像仓库地址]/ci-image:latest python -m pip install -r requirements.txt && pytest

集成到CI配置文件

GitLab CI配置示例（.gitlab-ci.yml）

yaml
stages:
  - build
  - test

build_job:
  stage: build
  image: [镜像仓库地址]/ci-image:latest
  script:
    - mvn clean compile

test_job:
  stage: test
  image: [镜像仓库地址]/ci-image:latest
  script:
    - mvn test
  artifacts:
    paths:
      - target/surefire-reports/

环境变量配置

配置代理示例

bash
docker run --rm -e HTTP_PROXY=http://proxy.example.com:8080 \
  -e HTTPS_PROXY=https://proxy.example.com:8080 \
  [镜像仓库地址]/ci-image:latest npm install

自定义工具配置

如需修改工具默认配置（如Maven settings.xml、npm .npmrc），可通过挂载配置文件实现：

bash
# 挂载自定义Maven配置
docker run --rm -v $(pwd)/custom-settings.xml:/root/.m2/settings.xml \
  -v $(pwd):/app -w /app [镜像仓库地址]/ci-image:latest mvn clean package