背景说明

在 Bigtop 框架下编译 Cloudbeaver，最核心的入口配置文件是 bigtop.bom。 它负责声明 Cloudbeaver 组件的版本号、依赖包、源码下载地址等所有元信息 ，直接决定了后续编译、打包和自动化部署的可控性。

BOM 文件核心作用

BOM（Bill of Materials）不仅决定 Cloudbeaver 的主版本和全部依赖，还定义了源码包的下载地址、校验方式，以及 RPM 制品的产出路径等。 通过合理维护 BOM，可以灵活应对多版本适配、快速切换国产源，极大降低编译失败概率与环境兼容风险。

第一步：新增 Cloudbeaver 的 BOM 配置

在 bigtop/bigtop.bom 文件中，新增 Cloudbeaver 配置段。可参考已有 Flink、Hadoop 等组件的写法，建议如下：

'cloudbeaver' {
    name = 'cloudbeaver'
    rpm_pkg_suffix = "_" + bigtop.base_version.replace(".", "_")
    relNotes = 'Cloudbeaver v25.1.0'
    version { base = '25.1.0'; pkg = base; release = 1 }
    tarball {
        destination = "cloudbeaver-v${version.base}.tar.gz"
        source = "${version.base}.tar.gz"
    }
    url {
        site = bigtop.gh_proxy + "https://github.com/JaneTTR-Bigdata/cloudbeaver/archive/refs/tags/"
        archive = site
    }
}

字段说明

字段	含义与说明	备注
name	Cloudbeaver 组件名称	建议全小写，与包名一致
rpm_pkg_suffix	RPM 包后缀（区分多版本构建）	建议直接引用 bigtop.base_version
relNotes	版本说明，可选	填写当前 Cloudbeaver 版本特性
version	组件主版本、包名及发布号	pkg 通常等于 base
tarball	源码包下载目标名和实际文件名	必须与 dl 目录中包名完全一致
url	官方源代码地址，推荐拼接国内 gh_proxy	archive 建议与 site 保持一致

笔记

source 和 destination 字段必须与 dl 目录下上传的 tar.gz 文件名严格一致，否则编译阶段会提示找不到文件直接报错。