FD.io CI/CD流水线容器镜像

镜像概述

本镜像基于Ubuntu 24.04构建，专为LF-Networking/FD.io项目CI/CD流水线设计，同时支持开发者在本地复现生产构建环境以进行代码构建与测试。镜像确保生产环境与本地开发环境一致性，避免因环境差异导致的构建问题。

核心功能与特性

多场景标签支持

• 生产环境标签：prod-x86_64、prod-aarch64，用于Jenkins生产环境CI/CD作业执行
• 回滚标签：prod-prev-x86_64、prod-prev-aarch64，用于生产环境回滚场景
• 沙箱标签：sandbox-x86_64、sandbox-aarch64，用于验证新镜像功能

环境一致性保障

• 预安装所有FD.io项目依赖包（系统及语言依赖），避免因网络或包服务器故障导致的构建失败
• 内置FD.io核心项目仓库（构建时状态），路径为/scratch/docker-build

本地开发支持

• 支持挂载本地工作区至容器，方便开发者使用本地代码进行构建测试
• 兼容x86_64和aarch64两种架构，适配不同开发环境

使用场景与适用范围

• 生产CI/CD执行：FD.io项目***CI/CD流水线（Jenkins）生产环境作业调度
• 本地开发测试：开发者本地构建、测试FD.io项目代码，复现生产环境问题
• 代码变更验证：通过Gerrit获取特定代码变更并在容器内验证构建效果
• 版本回滚：使用prod-prev-*标签在生产环境构建异常时快速回滚至稳定版本

使用方法与配置说明

拉取并运行容器

根据主机架构选择对应标签（x86_64或aarch64），执行以下命令拉取并启动容器：

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

参数说明：

• --privileged：授予容器特权模式，满足部分构建工具需求
• --shm-size=1024M：设置共享内存大小为1GB
• -m24g：限制容器内存使用为24GB
• 标签替换：若为aarch64架构，将prod-x86_64替换为prod-aarch64

容器内操作

访问FD.io核心项目仓库

容器内置FD.io核心项目仓库（构建时状态），路径为/scratch/docker-build。进入容器后可直接操作：

bash
# 进入VPP项目目录
cd /scratch/docker-build/vpp
# 拉取最新代码
git pull
# 构建发布版本
make build-release

获取特定Gerrit代码变更

若需验证Gerrit上的代码变更（如变更39276，Patchset 1），执行以下命令：

bash
cd /scratch/docker-build/vpp
git fetch [***] refs/changes/76/39276/1 && git checkout FETCH_HEAD

挂载本地工作区

如需使用本地代码，可通过-v参数挂载工作区至容器（以当前目录为例）：

bash
sudo docker run -it --privileged --shm-size=1024M -m24g -v $(pwd):/vpp fdiotools/builder-ubuntu2404:prod-x86_64

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

标签说明

注意事项

• 容器已预安装所有项目依赖包，无需额外下载系统或语言依赖
• 本地运行时，建议根据主机性能调整-m（内存限制）参数
• 沙箱标签（sandbox-*）仅用于测试，不保证生产环境稳定性
• 回滚标签（prod-prev-*）保留上一稳定版本，用于生产环境故障恢复===SHORT_DESC=== 基于Ubuntu 24.04的FD.io项目CI/CD流水线容器，用于生产环境CI/CD作业执行及开发者本地构建/测试，提供与生产一致的构建环境。 ===FULL_DESC===# FD.io CI/CD流水线容器镜像

镜像概述

本镜像基于Ubuntu 24.04构建，专为LF-Networking/FD.io项目CI/CD流水线设计，同时支持开发者在本地运行以复现生产构建环境。主要用途包括生产环境CI/CD作业执行、开发者本地代码构建与测试，确保构建环境与生产环境一致性。

核心功能与特性

多场景标签支持

• 生产环境标签：prod-x86_64/prod-aarch64，用于Jenkins生产环境CI/CD作业执行
• 回滚标签：prod-prev-x86_64/prod-prev-aarch64，保留上一版生产镜像，用于故障回滚
• 沙箱标签：sandbox-x86_64/sandbox-aarch64，用于验证新镜像功能（非生产环境）

预配置构建环境

• 内置所有FD.io项目依赖包（系统依赖及语言依赖），避免因网络或包服务器故障导致的构建失败
• 包含FD.io核心项目仓库（构建时状态），路径为/scratch/docker-build，可直接访问历史版本代码

本地开发适配

• 支持通过-v参数挂载本地工作区，方便开发者使用本地代码进行构建测试
• 兼容x86_64和aarch64两种架构，适配不同开发硬件环境

使用场景与适用范围

• CI/CD流水线生产执行：FD.io项目***Jenkins流水线调度，执行自动化构建、测试作业
• 本地开发调试：开发者复现生产构建环境，排查构建问题或验证代码变更
• 代码变更验证：通过Gerrit获取特定代码变更并在容器内构建验证
• 版本回滚保障：使用prod-prev-*标签在生产构建异常时快速切换至稳定版本

使用方法与配置说明

拉取并启动容器

根据主机架构选择标签（x86_64或aarch64），执行以下命令拉取并运行容器：

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

参数说明：

• --privileged：授予特权模式，满足部分构建工具对系统权限的需求
• --shm-size=1024M：设置共享内存大小为1GB
• -m24g：限制容器内存使用为24GB（可根据主机配置调整）
• 架构适配：aarch64架构需将标签替换为prod-aarch64

容器内代码构建

基于内置仓库构建

容器内置FD.io核心项目仓库（路径/scratch/docker-build），可直接拉取最新代码并构建：

bash
# 进入VPP项目目录
cd /scratch/docker-build/vpp
# 拉取最新代码
git pull
# 构建发布版本
make build-release

获取Gerrit代码变更

如需验证Gerrit上的特定变更（如变更39276，Patchset 1），执行以下命令：

bash
cd /scratch/docker-build/vpp
git fetch [***] refs/changes/76/39276/1 && git checkout FETCH_HEAD

挂载本地工作区

通过-v参数将本地工作区挂载至容器（以当前目录为例）：

bash
sudo docker run -it --privileged --shm-size=1024M -m24g -v $(pwd):/vpp fdiotools/builder-ubuntu2404:prod-x86_64

进入容器后，通过cd /vpp访问本地代码目录。

注意事项

• 容器已预安装所有依赖，无需额外执行apt install等包管理命令
• 沙箱标签（sandbox-*）仅用于测试新镜像功能，不保证稳定性，请勿用于生产作业
• 内存限制（-m参数）建议根据项目需求调整，VPP等大型项目需较高内存配置
• 本地挂载时确保主机目录权限正确，避免容器内读写权限问题