jc21/docker-ci-tools 镜像文档

1. 镜像概述和主要用途

jc21/docker-ci-tools 是一个基于 Debian 系统的 Docker 镜像，集成了 CI/CD 流程中常用的工具和依赖，旨在为持续集成/持续部署（CI/CD）流水线提供统一、便捷的运行环境。该镜像可直接用于各类 CI 平台（如 GitHub Actions、GitLab CI、Jenkins 等），简化环境配置步骤，确保构建、测试、部署等任务的一致性和稳定性。

2. 核心功能和特性

2.1 基础系统

基于 Debian 稳定版，提供可靠的底层系统支持
包含基础系统工具（如 bash、coreutils、sudo 等），满足日常命令行操作需求

2.2 CI/CD 常用工具集成

版本控制：git（支持代码拉取与版本管理）
网络工具：curl、wget（资源下载）、openssh-client（SSH 远程操作）
构建工具：build-essential（含 GCC、Make 等编译工具）、cmake（跨平台构建系统）
包管理：apt（Debian 原生包管理）、npm/yarn（Node.js 包管理）、pip（Python 包管理）
容器工具：docker-cli（Docker 命令行工具，需宿主机 Docker 服务支持）

2.3 关键特性

开箱即用：无需额外安装基础依赖，直接投入 CI 任务
环境统一：标准化工具版本，避免因环境差异导致的构建失败
轻量设计：在集成必要工具的同时控制镜像体积

3. 使用场景和适用范围

3.1 适用场景

CI/CD 流水线执行环境（构建、测试、部署阶段）
多平台 CI 工具适配（GitHub Actions、GitLab CI、Jenkins 等）
本地 CI 脚本调试（模拟 CI 环境验证流程）

3.2 适用任务类型

代码编译构建（C/C++、Python、Node.js 等项目）
自动化测试（单元测试、集成测试、E2E 测试）
镜像打包与推送
部署脚本执行（如服务器配置、应用发布）

4. 使用方法和配置说明

4.1 基础使用（Docker Run）

交互式终端模式

bash
docker run -it --rm jc21/docker-ci-tools bash

执行一次性命令

bash
# 示例：检查工具版本
docker run --rm jc21/docker-ci-tools sh -c "git --version && curl --version && docker --version"

4.2 在 CI 平台中使用

GitHub Actions 配置示例

yaml
jobs:
  build:
    runs-on: ubuntu-latest
    container:
      image: jc21/docker-ci-tools
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Build project
        run: |
          git submodule update --init
          make build

GitLab CI 配置示例

yaml
stages:
  - test

test_job:
  stage: test
  image: jc21/docker-ci-tools
  script:
    - pip install -r requirements.txt
    - pytest tests/

4.3 Docker Compose 配置示例

yaml
version: '3.8'

services:
  ci-worker:
    image: jc21/docker-ci-tools
    volumes:
      - ./project:/workspace  # 挂载项目目录
      - /var/run/docker.sock:/var/run/docker.sock  # 启用 Docker 交互（可选）
    working_dir: /workspace
    command: ./ci-pipeline.sh  # 执行项目 CI 脚本

启动命令：

bash
docker-compose up

4.4 环境配置

自定义工具配置

通过挂载配置文件实现工具自定义：

bash
# 示例：挂载自定义 .gitconfig
docker run -v $(pwd)/.gitconfig:/root/.gitconfig --rm jc21/docker-ci-tools git config --list

网络代理配置

通过环境变量设置代理：

bash
docker run -e HTTP_PROXY=[***] -e HTTPS_PROXY=[***] --rm jc21/docker-ci-tools curl [***]

5. 注意事项

工具版本验证：使用前建议通过 docker run --rm jc21/docker-ci-tools <工具名> --version 确认工具版本
Docker 权限：使用 docker-cli 时需挂载宿主机 Docker 套接字（-v /var/run/docker.sock:/var/run/docker.sock）并确保权限正确
非 root 用户需求：可通过 --user 参数指定运行用户（需提前在容器内创建用户）