netdata/builder

CI系统Docker镜像文档

一、镜像概述和主要用途

本系列Docker镜像专为CI（持续集成）和构建流水线设计，主要用于自动化执行构建、编译、测试等CI/CD环节的任务。核心定位：作为构建环境的基础组件，提供标准化的运行时环境，确保CI流程的一致性和稳定性。

重要提示：本镜像仅针对开发和构建场景优化，未经过生产环境所需的安全加固、性能调优及长期运行稳定性验证，严禁用于生产环境。

二、核心功能和特性

1. 自动化构建流程

• 基于Docker Hub的「Automated Build」系统实现镜像构建全自动化，无需手动触发构建命令。
• 支持通过代码仓库（如GitHub、GitLab）的事件触发构建（如分支推送、标签创建），实现构建流程与代码迭代的联动。

2. 基础镜像更新联动

• 集成Docker Hub「Repository Links」功能，可与基础镜像（如官方Python、Node.js镜像等）建立关联。
• 当关联的基础镜像发生版本更新或安全补丁时，系统会自动触发本镜像的重新构建，确保构建环境依赖的基础组件始终为最新状态。

3. 标准化构建环境

• 内置CI流程常用工具链（如编译器、打包工具、测试框架等），减少构建环境配置的重复工作。
• 镜像版本与CI流程版本绑定，支持多版本并行维护，满足不同流水线对环境版本的差异化需求。

三、使用场景和适用范围

适用场景

• CI/CD流水线构建环节：用于自动化执行代码编译、依赖安装、单元测试、制品打包等任务。
• 开发环境镜像构建：为开发团队提供统一的本地构建环境，避免「本地能跑，CI报错」的环境不一致问题。
• 多版本构建验证：通过多标签镜像（如latest、v1.0、v2.0）支持对不同代码版本的构建结果进行并行验证。

适用范围

• 支持主流CI平台（如GitHub Actions、GitLab CI、Jenkins等），可作为CI任务的基础运行环境。
• 兼容Docker生态工具链（如Docker Compose、Buildx），可集成到复杂构建流程中。

四、使用方法和配置说明

1. 前置条件

• 已在Docker Hub注册账号并创建镜像仓库。
• 代码仓库（如GitHub）与Docker Hub账号已完成授权绑定。
• 基础镜像已发布至Docker Hub或其他可公开访问的容器仓库。

2. 自动化构建配置（Docker Hub）

步骤1：启用Automated Build

1. 登录Docker Hub，进入目标镜像仓库页面，点击「Build Settings」。
2. 在「Source Repository」中选择关联的代码仓库（需提前授权Docker Hub访问该仓库）。
3. 启用「Automated Build」开关，配置构建触发条件（如「Branch」或「Tag」触发）。

步骤2：配置构建规则

步骤3：设置Repository Links（基础镜像联动）

1. 在「Build Settings」页面下滑至「Repository Links」模块，点击「Add Repository Link」。
2. 输入基础镜像的仓库名称（格式：[用户名]/[仓库名]，如library/python）。
3. 选择触发条件（默认：当基础镜像更新时自动触发本镜像构建），保存配置。

3. 本地测试（可选）

若需在本地验证镜像功能，可通过以下命令手动构建（需替换占位符）：

bash
# 构建命令示例（需本地存在Dockerfile）
docker build -f ./docker/ci/Dockerfile -t [your-dockerhub-username]/[image-name]:test .

# 运行测试（模拟CI任务执行）
docker run --rm [your-dockerhub-username]/[image-name]:test [ci-task-command]

说明：[ci-task-command]需替换为实际CI任务的命令（如make build、pytest等）。

五、配置参数说明

1. 构建配置参数

六、注意事项

1. 版本管理：建议通过标签（Tag）管理镜像版本，避免直接依赖latest标签导致构建环境不可控。
2. 基础镜像选择：关联的基础镜像需确保稳定性，避免频繁更新导致本镜像构建频繁触发。
3. 构建日志：Docker Hub的「Build Details」页面可查看构建日志，用于排查构建失败问题。
4. 安全合规：定期检查基础镜像的安全漏洞（如通过Docker Scout），并通过Repository Links自动同步修复补丁。