BKCI 基础镜像文档

镜像概述和主要用途

BKCI（蓝盾持续集成）基础镜像是用于CI/CD流程的标准化基础环境镜像，提供两种版本以满足不同构建需求：完整编译环境版本（latest） 和轻量级无编译环境版本（alpine）。

主要用途：作为CI构建任务的底层运行环境，提供稳定、一致的系统基础，简化构建流程配置，确保跨项目、跨环境的构建标准化和可重复性。

核心功能和特性

latest 版本（基于 ci-build/Dockerfile）

• 完整编译环境：包含主流编译工具链（gcc、make、JDK、Maven等）及系统依赖库，支持多语言（C/C++、Java、Python等）源代码编译
• CI工具预置：集成git、curl、wget等常用CI流程工具，减少构建环境前置配置步骤
• 兼容性优先：基于主流Linux发行版（如Debian/Ubuntu），确保与多数构建工具和库的兼容性

alpine 版本（基于 ci-build-less/Dockerfile）

• 轻量级设计：基于Alpine Linux，镜像体积显著减小（通常比latest版本小50%以上），启动速度快，资源占用低
• 无编译依赖：剔除编译工具链及非必要组件，仅保留基础系统组件和运行时库
• 最小化攻击面：精简组件减少潜在安全风险，适合对安全性和资源限制有严格要求的场景

使用场景和适用范围

latest 版本适用场景

• 需要执行源代码编译的CI/CD任务（如Java项目Maven打包、C++程序编译）
• 依赖完整系统库或多语言工具链的复杂构建流程
• 对构建环境兼容性要求高，需避免工具版本冲突的场景

alpine 版本适用场景

• 轻量级脚本执行（如配置文件生成、日志处理、简单命令行操作）
• 仅需基础运行时环境的构建步骤（如文件打包、校验、分发）
• 资源受限环境（如边缘节点、低配置CI服务器）或对镜像拉取速度有严格要求的场景

使用方法和配置说明

镜像拉取

latest 版本（完整编译环境）

docker pull bkci/ci:latest

alpine 版本（轻量级无编译环境）

docker pull bkci/ci:alpine

基础使用示例

1. 启动交互式环境测试

# latest版本（使用bash shell）
docker run -it --rm bkci/ci:latest /bin/bash

# alpine版本（Alpine默认使用ash shell）
docker run -it --rm bkci/ci:alpine /bin/ash

2. 在CI配置中集成（以GitLab CI为例）

# .gitlab-ci.yml
stages:
  - build

build_job:
  stage: build
  image: bkci/ci:latest  # 或 bkci/ci:alpine（根据需求选择）
  script:
    - echo "使用BKCI基础镜像执行构建"
    # 针对latest版本可执行编译命令（示例：Java项目构建）
    # - mvn clean package -DskipTests
    # 针对alpine版本可执行轻量级操作（示例：文件打包）
    # - tar -czf output.tar.gz ./dist

配置说明

版本参数对比

自定义扩展建议

如需添加项目特定依赖，可基于基础镜像构建自定义镜像：

# 示例：基于latest版本添加Node.js环境
FROM bkci/ci:latest
RUN apt-get update && apt-get install -y nodejs npm && rm -rf /var/lib/apt/lists/*

# 示例：基于alpine版本添加Python3
FROM bkci/ci:alpine
RUN apk add --no-cache python3 py3-pip

注意事项

• 确保CI/CD平台已配置Docker环境，且有权限拉取bkci/ci镜像仓库
• alpine版本因无编译工具链，不支持依赖编译的操作（如源码编译安装软件）
• 生产环境建议固定版本标签（如bkci/ci:v1.0）而非latest，避免版本变更导致构建异常
• 定期更新镜像以获取安全补丁和功能优化