shawnqwil/ci

CI Docker镜像文档

镜像概述

本镜像提供轻量级持续集成（CI）环境，旨在简化开发团队的自动化构建、测试与集成流程。通过预集成常用开发工具与运行时环境，可快速部署CI工作流，支持多语言项目的自动化流程执行，降低CI/CD管道搭建门槛。

核心功能与特性

• 多语言支持：兼容Java、Python、Node.js、Go等主流开发语言，内置对应构建工具（Maven、Gradle、npm、pip等）。
• 工具集成：预装Git、Docker CLI、SSH客户端、curl等基础工具，支持代码拉取、依赖管理与外部服务交互。
• 工作流自定义：支持通过配置文件（如.gitlab-ci.yml、Jenkinsfile）定义构建、测试、部署步骤，兼容主流CI配置规范。
• 轻量级设计：基于Alpine或Debian Slim基础镜像，减小体积同时保证功能完整性，提升启动速度。
• 环境隔离：每个CI任务运行在独立容器中，避免项目间依赖冲突，确保构建环境一致性。

使用场景与适用范围

• 小型开发团队：无需搭建复杂CI服务器，通过Docker快速部署轻量级CI环境。
• 多项目共享：单一镜像支持多个项目的CI流程，降低维护成本。
• 自动化测试与构建：集成单元测试、集成测试工具，自动生成测试报告与构建产物。
• 临时CI任务：用于临时验证代码变更、紧急修复的自动化构建与测试。

使用方法与配置说明

基础使用命令

bash
# 启动CI容器并执行默认构建流程
docker run -d \
  --name ci-worker \
  -e CI_PROJECT_URL="https://git.example.com/your-project" \
  -e CI_COMMIT_SHA="a1b2c3d4e5f6" \
  -v /path/to/your/project:/app \
  your-registry/ci-image:latest

环境变量配置

卷挂载说明

• /app：挂载项目代码目录，CI任务将在此路径下执行构建与测试。
• /ci-config：挂载自定义CI配置文件（如.gitlab-ci.yml），覆盖默认配置。
• /ci-cache：挂载缓存目录，存储依赖包（如npm_modules、.m2/repository）以加速后续构建。

docker-compose配置示例

yaml
version: "3.8"
services:
  ci-worker:
    image: your-registry/ci-image:latest
    container_name: ci-worker
    restart: unless-stopped
    environment:
      - CI_PROJECT_URL="https://git.example.com/your-project"
      - CI_LOG_LEVEL="debug"
      - CI_TIMEOUT=7200
    volumes:
      - ./your-project:/app
      - ./ci-config:/ci-config
      - ci-cache:/ci-cache
    networks:
      - ci-network

volumes:
  ci-cache:

networks:
  ci-network:
    driver: bridge

自定义工作流示例

在项目根目录创建.ci.yml配置文件，定义构建步骤：

yaml
# .ci.yml示例（兼容GitLab CI语法）
stages:
  - test
  - build

test-stage:
  stage: test
  script:
    - cd /app
    - npm install
    - npm run test

build-stage:
  stage: build
  script:
    - npm run build
    - cp -r dist /ci-cache/build-output
  artifacts:
    paths:
      - /ci-cache/build-output

停止与清理

bash
# 停止CI容器
docker stop ci-worker

# 清理容器与镜像（如需）
docker rm ci-worker
docker rmi your-registry/ci-image:latest

注意事项

• 首次运行时，建议挂载/ci-cache卷以缓存依赖，减少重复下载耗时。
• 敏感信息（如Git凭证、API密钥）建议通过Docker Secrets或环境变量文件（--env-file）传入，避免硬编码。
• 高并发场景下，建议结合Docker Swarm或Kubernetes进行容器编排，实现CI任务的负载均衡。