tykio/ci-tools

CI工具集成Docker镜像

概述

本Docker镜像整合Jenkins、GitLab CI Runner、GitHub Actions Runner等主流CI/CD工具，预配置基础依赖环境与常用插件，旨在帮助开发团队快速部署标准化持续集成/持续部署流程，减少环境配置成本，提升开发迭代效率。

核心功能与特性

• 多工具集成：包含Jenkins（2.440.1+）、GitLab CI Runner（16.0.0+）、GitHub Actions Runner（2.303.0+）核心组件，支持主流CI/CD平台对接
• 自动化流程支持：内置构建（Maven/Gradle/npm）、测试（JUnit/Pytest）、部署（Docker/Kubernetes）工具链，可一键触发全流程自动化
• 环境隔离与一致性：基于Docker容器化运行，确保开发、测试、生产环境依赖一致性，避免"本地能跑，线上报错"问题
• 扩展性设计：支持自定义插件安装、配置文件挂载，可根据项目需求扩展工具链（如添加SonarQube代码质量检测、JFrog Artifactory制品管理等）
• 多平台兼容：支持x86_64/ARM64架构，适配物理机、云服务器、Kubernetes等多种部署环境

使用场景

• 中小型开发团队：快速搭建团队级CI/CD平台，实现代码提交后自动构建、测试、部署
• 开源项目维护：对接GitHub/GitLab等代码托管平台，实现PR/MR自动验证、版本发布自动化
• 跨语言项目管理：统一管理Java/Python/Node.js等多语言项目的构建流程，降低多技术栈维护成本
• 教学与演示环境：作为CI/CD教学实验环境，直观展示持续集成流程与工具链协作机制

使用方法

基础启动命令

bash
docker run -d \
  --name ci-tools \
  -p 8080:8080 \  # Jenkins Web端口
  -p 50000:50000 \  # Jenkins Agent通信端口
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载Docker守护进程（如需容器内构建Docker镜像）
  -v ./ci-data:/var/jenkins_home \  # 持久化数据目录
  -e JENKINS_ADMIN_ID=admin \  # Jenkins管理员账号
  -e JENKINS_ADMIN_PASSWORD=your_secure_password \  # Jenkins管理员密码
  ci-tools:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  ci-tools:
    image: ci-tools:latest
    container_name: ci-tools
    ports:
      - "8080:8080"
      - "50000:50000"
      - "3000:3000"  # GitLab CI Runner管理端口
    volumes:
      - ./ci-data:/var/jenkins_home
      - ./gitlab-runner-config:/etc/gitlab-runner
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - JENKINS_ADMIN_ID=admin
      - JENKINS_ADMIN_PASSWORD=your_secure_password
      - GITHUB_RUNNER_TOKEN=your_github_runner_token  # GitHub仓库Runner注册令牌
      - GITLAB_RUNNER_REGISTRATION_TOKEN=your_gitlab_runner_token  # GitLab项目Runner注册令牌
    restart: unless-stopped

环境变量配置说明

初始化配置流程

1. 启动容器后，访问http://<主机IP>:8080打开Jenkins控制台
2. 使用配置的JENKINS_ADMIN_ID和JENKINS_ADMIN_PASSWORD登录
3. 根据项目需求安装额外插件（如Kubernetes、SonarQube Scanner等）
4. 注册GitLab/GitHub Runner：容器内执行gitlab-runner register或config.sh --url <GitHub仓库URL> --token <Runner令牌>完成注册

注意事项

• 持久化数据目录（如./ci-data）需确保权限正确（建议设置UID/GID为1000:1000，匹配容器内Jenkins用户）
• 生产环境建议通过HTTPS访问，可配合Nginx反向代理配置SSL证书
• 高并发场景下，建议将Jenkins Agent、Runner等组件拆分部署，避免单容器资源瓶颈
• 定期备份数据目录，防止配置与构建历史丢失