CI基础镜像文档

镜像概述

本镜像作为持续集成(CI)流水线的基础环境，旨在提供标准化、可复用的构建环境，简化跨项目CI流程配置。通过预集成CI常用工具和依赖，减少重复环境配置工作，提升流水线稳定性。

核心功能与特性

1. 标准化工具链

• 预安装CI流程必备工具：git、curl、wget、jq、build-essential
• 包含多语言基础依赖：Python3、Node.js运行时、Java开发工具包(可选版本)
• 版本控制工具：支持Git LFS、Subversion客户端

2. 轻量级设计

• 基于Alpine/Debian Slim基础镜像构建，最小化镜像体积
• 优化层缓存策略，减少CI流水线拉取时间

3. 多平台支持

• 支持主流架构：amd64、arm64
• 兼容Linux内核版本4.19+

4. CI系统兼容性

• 适配主流CI平台：GitLab CI/CD、Jenkins、GitHub Actions、CircleCI
• 支持容器化构建模式，兼容Docker-in-Docker(DIN)场景

使用场景

• 代码编译与打包流程标准化
• 自动化测试环境一致性保障
• 跨团队协作的统一构建规范
• 复杂CI流水线的基础环境层

使用方法

基本使用

拉取镜像

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

本地测试

# 启动交互式终端验证环境
docker run -it --rm [镜像仓库地址]/ci-base:latest /bin/bash

# 运行基础命令测试工具可用性
docker run --rm [镜像仓库地址]/ci-base:latest git --version

CI配置示例

GitLab CI配置(.gitlab-ci.yml)

image: [镜像仓库地址]/ci-base:latest

stages:
  - build
  - test

build_job:
  stage: build
  script:
    - git clone $CI_REPOSITORY_URL
    - cd project && make build
  artifacts:
    paths:
      - project/dist/

test_job:
  stage: test
  script:
    - cd project && make test

Jenkins Pipeline配置

pipeline {
  agent {
    docker {
      image '[镜像仓库地址]/ci-base:latest'
      reuseNode true
    }
  }
  stages {
    stage('Build') {
      steps {
        sh 'git checkout $BRANCH_NAME'
        sh './build.sh'
      }
    }
  }
}

环境变量配置

高级配置

自定义工具安装

基于本镜像扩展自定义工具链：

FROM [镜像仓库地址]/ci-base:latest

# 安装额外依赖
RUN apt-get update && apt-get install -y \
    golang \
    rustc \
    && rm -rf /var/lib/apt/lists/*

# 配置环境变量
ENV GOPATH=/workspace/go

多版本工具切换

通过环境变量指定工具版本：

docker run -e "NODE_VERSION=18.x" [镜像仓库地址]/ci-base:latest node --version

注意事项

• 镜像标签策略：latest为稳定版，nightly为开发版，建议生产环境使用具体版本标签(如v1.2.0)
• 工具版本更新周期：每月进行基础工具安全更新，重大版本变更将在Release Notes中说明
• 安全最佳实践：运行时建议使用非root用户，本镜像默认启用ci-user(UID 1000)
• 缓存优化：CI配置中建议对/workspace目录启用缓存，减少依赖重复下载

版本信息

• 基础镜像版本：Alpine 3.18 / Debian 12 Slim
• 默认工具版本：Git 2.40+, Node.js 18.x, Python 3.11+