fdiotools/builder-ubuntu2004

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

镜像概述和主要用途

本镜像基于Ubuntu 20.04构建，主要用于LF-Networking/FD.io项目的CI/CD流水线执行，同时支持开发者在本地使用与生产环境一致的构建环境进行项目构建和测试。镜像包含预配置的构建环境，确保CI/CD作业的稳定性和一致性。

核心功能和特性

• 多环境支持：提供多种标签镜像，满足不同场景需求：

  • prod-x86_64/prod-aarch64：当前Jenkins生产环境执行器镜像
  • prod-prev-x86_64/prod-prev-aarch64：历史生产环境镜像（用于回滚）
  • sandbox-x86_64/sandbox-aarch64：沙箱环境镜像（用于验证新镜像）

• 预配置依赖：包含所有项目包依赖（已安装或缓存），避免CI/CD作业执行过程中下载和安装系统或语言包，减少因网络或包服务器故障导致的错误失败。

• 本地开发支持：开发者可通过容器在本地复现生产构建环境，支持挂载本地工作区，实现代码实时同步和测试。

使用场景和适用范围

• CI/CD流水线执行：作为FD.io项目Jenkins CI/CD流水线的执行环境（Jenkins地址），处理代码构建、测试等自动化任务。

• 本地开发与测试：开发者可在本地运行容器，使用与生产环境一致的依赖和配置，构建、测试FD.io核心项目（如VPP）及相关变更。

使用方法和配置说明

拉取并运行容器

针对x86_64架构，拉取并启动当前生产环境执行器镜像：

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

说明：--privileged提供特权模式，--shm-size=1024M设置共享内存大小，-m24g限制内存使用为24GB，可根据实际需求调整。

项目仓库位置

容器内已包含FD.io核心项目仓库（构建时的状态），路径为：
/scratch/docker-build

构建FD.io项目（以VPP为例）

1. 进入VPP仓库目录：

   bash
   cd /scratch/docker-build/vpp
   

2. 拉取最新代码并构建：

   bash
   git pull
   make build-release
   

获取Gerrit审查中的变更

例如获取VPP项目Gerrit变更39276（Patchset 1）：

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

挂载本地工作区

通过-v参数将本地目录挂载到容器中（如当前目录挂载为/vpp）：

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

进入容器后，通过cd /vpp访问本地工作区。

容器构建细节

容器构建脚本及更多细节可参考：https://github.com/FDio/ci-management/blob/master/docker/scripts/README.md

相关链接

• FD.io Jenkins：[***]
• FD.io Gerrit：[***]