背景说明

在 Bigtop 框架下集成编译 Celeborn，最重要的入口配置是 bigtop.bom。 **bigtop.bom 文件承载了 Celeborn 的所有版本号、依赖描述与下载路径，是整个自动化编译、打包、环境切换的统筹中心。 ** BOM核心

BOM 文件的作用

BOM（Bill of Materials）既约束了 Celeborn 主版本、依赖包的下载来源，也决定了源码包校验、打包解压等底层逻辑。合理维护 BOM，可以灵活应对多环境切换、主流国产化适配及后续运维扩展，极大降低踩坑概率。

第一步：新增 Celeborn 的 BOM 配置

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

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

字段说明

字段	作用说明	备注
name	组件英文名，建议与目录和包名保持一致	必须全小写
rpm_pkg_suffix	构建产物 RPM 包后缀，自动随 bigtop 版本变更	用于区分多版本
relNotes	版本发布说明，建议写 Celeborn 官方 tag/版本号	可用于后续 changelog
version	版本号/包名/发行批次，pkg 一般与 base 一致	按需调整
tarball.source	实际下载包名，通常与上传至 dl 目录的原始文件对应	v0.5.3.tar.gz 格式
tarball.destination	目标包名，决定解包后打包目录名	celeborn-0.5.3.tar.gz
url.site/archive	官方源码仓库路径，建议带 gh_proxy 代理，加速拉取	推荐与 site 保持一致

笔记

source 和 destination 字段务必与 dl 目录下实际上传的 tar 包文件名严格对应，否则编译时会报错找不到源码包。