fdiotools/builder-ubuntu2204

FD.io CI/CD流水线容器（基于Ubuntu 22.04）

1. 镜像概述和主要用途

本镜像基于Ubuntu 22.04，专为FD.io（[***]

2. 核心功能和特性

• CI/CD流水线支持：作为Jenkins服务器的执行器镜像，用于FD.io项目的自动化构建、测试和部署。
• 本地开发兼容：开发者可本地运行容器，利用生产环境配置进行代码构建和测试，确保环境一致性。
• 多标签版本：提供生产、回滚和沙箱测试等多标签镜像，满足不同场景需求。
• 依赖预配置：包含所有项目所需的系统包和语言依赖（已安装或缓存），避免CI/CD过程中因网络或包服务器故障导致的构建失败。
• 本地工作区挂载：支持挂载本地目录至容器，方便开发过程中代码同步和调试。

3. 标签说明

Jenkins服务器使用以下标签标识不同用途的镜像：

• prod-x86_64、prod-aarch64：当前Jenkins生产环境执行器镜像
• prod-prev-x86_64、prod-prev-aarch64：上一版本生产环境执行器镜像（用于回滚）
• sandbox-x86_64、sandbox-aarch64：当前Jenkins沙箱镜像（用于验证新镜像）

4. 使用方法和配置说明

4.1 本地运行容器

以下命令用于拉取并启动当前生产环境执行器镜像（以x86_64架构为例）：

bash
sudo docker run -it --privileged --shm-size=1024M -m24g fdiotools/builder-ubuntu2204:prod-x86_64

参数说明：

• --privileged：授予容器特权模式，支持需要高权限的操作
• --shm-size=1024M：设置共享内存大小为1024MB
• -m24g：限制容器内存使用为24GB
• fdiotools/builder-ubuntu2204:prod-x86_64：镜像名称及标签（x86_64架构生产版本）

4.2 容器内部项目目录

容器内已包含FD.io核心项目仓库（构建容器时的代码状态），位于：

/scratch/docker-build

4.3 项目构建示例

以VPP项目为例，更新代码并构建：

bash
cd /scratch/docker-build/vpp
git pull
make build-release

4.4 获取Gerrit审核中的代码变更

如需获取特定Gerrit变更（例如变更39276，补丁集1：[***]

bash
cd /scratch/docker-build/vpp
git fetch https://gerrit.fd.io/r/vpp refs/changes/76/39276/1 && git checkout FETCH_HEAD

4.5 挂载本地工作区

如需将本地工作目录挂载至容器，可在docker run命令中添加-v参数（例如挂载当前目录至容器/vpp）：

bash
sudo docker run -it --privileged --shm-size=1024M -m24g -v.:/vpp fdiotools/builder-ubuntu2204:prod-x86_64

进入容器后，通过cd /vpp访问挂载的工作区。

5. 依赖与构建优化

容器预配置了所有项目依赖（系统包或缓存），避免CI/CD任务执行过程中下载和安装依赖，减少因网络或包服务器故障导致的构建失败。有关生成容器镜像的脚本详情，可参考[1]。

参考资料

• [0] FD.io Jenkins服务器：[] Gerrit代码审核：[]
• [1] 容器生成脚本README：https://github.com/FDio/ci-management/blob/master/docker/scripts/README.md