vortexa/ci-tools

容器化CI工具镜像

镜像概述

该Docker镜像提供了容器化的持续集成(CI)工具环境，集成了主流CI工具及依赖组件，旨在简化开发团队搭建和维护持续集成管道的过程。通过容器化部署，可快速启动标准化的CI环境，减少环境配置差异，支持各类项目的自动化构建、测试及部署流程，助力开发团队实现高效、可靠的持续集成实践。

核心功能与特性

• 容器化部署：采用Docker容器化技术，支持快速启动、停止及扩展，降低环境依赖管理复杂度。
• 多工具集成：内置主流CI工具（如Jenkins、GitLab CI Runner、GitHub Actions Runner等）及必要依赖（如Git、Maven、Node.js等），满足多样化CI需求。
• 自动化流程支持：支持自定义CI/CD管道配置，可实现代码拉取、构建、测试、打包及部署等全流程自动化。
• 多平台兼容：兼容Linux、Windows及macOS等主流操作系统的Docker环境，支持x86_64和ARM架构。
• 可扩展性：支持通过配置文件或环境变量自定义工具版本、插件及工作目录，适应不同项目需求。

使用场景

• 软件开发团队CI流程：适用于中小型开发团队快速搭建持续集成环境，实现代码提交后的自动构建、测试及质量检查。
• 项目构建测试自动化：用于自动化执行项目构建脚本、单元测试、集成测试等任务，提升开发效率。
• 多环境一致性保障：通过容器化环境确保开发、测试及生产环境中CI工具版本及依赖的一致性，减少"在我机器上能运行"问题。
• 临时CI环境搭建：支持快速创建临时CI环境，用于验证新的CI配置或测试特殊场景下的构建流程。

使用方法与配置说明

快速启动（docker run）

通过以下命令可快速启动容器化CI工具环境：

bash
docker run -d \
  --name ci-tools \
  -p 8080:8080 \  # CI工具Web界面端口映射（如Jenkins默认8080）
  -v /path/to/ci-data:/var/lib/ci \  # 持久化数据目录挂载
  -e CI_TOOL=jenkins \  # 指定使用的CI工具（支持jenkins/gitlab-runner/github-runner等）
  -e LOG_LEVEL=info \  # 日志级别（debug/info/warn/error）
  your-registry/ci-tools:latest

Docker Compose配置示例

创建docker-compose.yml文件，配置如下：

yaml
version: '3.8'
services:
  ci-tools:
    image: your-registry/ci-tools:latest
    container_name: ci-tools
    ports:
      - "8080:8080"  # Web界面端口
      - "50000:50000"  # Jenkins代理端口（如使用Jenkins）
    volumes:
      - ./ci-data:/var/lib/ci  # 数据持久化
      - ./ci-config:/etc/ci  # 自定义配置文件挂载
    environment:
      - CI_TOOL=jenkins  # 指定CI工具
      - ADMIN_USER=admin  # 管理员用户名
      - ADMIN_PASSWORD=securepassword  # 管理员密码（生产环境建议使用secret管理）
      - TIMEZONE=Asia/Shanghai  # 时区设置
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

环境变量配置

数据持久化

为避免容器重启导致数据丢失，建议挂载以下目录：

• /var/lib/ci：CI工具核心数据目录（包含配置、构建历史、插件等）
• /etc/ci：自定义配置文件目录（如工具配置、证书等）
• /var/lib/ci/workspace：项目构建工作目录（存放临时构建文件）

注意事项

• 生产环境中，建议通过Docker Swarm或Kubernetes进行容器编排，以提升可用性和扩展性。
• 管理员密码应通过Docker Secrets或环境变量加密方式管理，避免明文暴露。
• 根据项目需求选择合适的CI工具（通过CI_TOOL环境变量指定），不同工具的端口映射及配置方式可能存在差异，具体参考对应工具官方文档。
• 定期备份挂载的数据目录，以防数据损坏或丢失。