背景说明

Bigtop 集成 Ozone 时，bigtop.bom 是所有依赖和版本适配的唯一元数据中心。 bigtop.bom 文件承载了 Ozone 的主版本、依赖声明及源码下载路径，是自动化编译、RPM 打包与环境复现的基础。

BOM 文件作用

BOM（Bill of Materials）不仅决定 Ozone 组件的主版本、依赖包和源码包下载，还直接关系到打包、解压、版本切换等下游链路，维护好 BOM 可以极大降低集成踩坑和环境不一致风险。

第一步：新增 Ozone 的 BOM 配置

请在 bigtop/bigtop.bom 文件中新增 Ozone 组件配置段，结构如下：

'ozone' {
    name = 'ozone'
    rpm_pkg_suffix = "_" + bigtop.base_version.replace(".", "_")
    relNotes = 'ozone v1.4.1'
    version { base = '1.4.1'; pkg = base; release = 1 }
    tarball {
        source = "${name}-${version.base}.tar.gz"
        destination = source
    }
    url {
        site = bigtop.gh_proxy + "https://github.com/apache/ozone/archive/refs/tags"
        archive = site
    }
}

字段说明

字段	作用与说明	备注
name	组件英文名，建议与源码/包名全小写一致	必须保持一致
rpm_pkg_suffix	构建产物 RPM 包后缀，自动拼 bigtop 版本	支持多环境适配
relNotes	版本说明，建议注明官方 tag/发行记录	用于后续 changelog 或归档
version	组件主版本、包名和发布号	pkg 一般等于 base
tarball.source	上传源码包实际文件名	如 ozone-1.4.1.tar.gz
tarball.destination	构建期包名，决定 rpm 包根目录结构	通常等于 source
url.site/archive	官方源码仓库路径，推荐拼接国内 gh_proxy 镜像加速	推荐 archive 与 site 保持一致

笔记

source 和 destination 字段必须与 dl 目录下上传的 tar 包文件名一致，否则编译期会找不到源码包而失败。