下载 Ambari 3.1.0

Ambari 3.1.0 文档当前描述的是经过审查的候选版本和源码构建，不表示最终公开发布、下载镜像、校验和集合或生产认证已经存在。请从发布流程使用的项目渠道获取候选版本及其经过审查的源码。

选择制品

Server、Agent 以及可选的 Metrics 软件包必须来自同一候选制品集合。不要混用不同候选版本的软件包，也不要在两次安装之间复制私有 Python 库。RPM 架构必须与目标主机、Python Wheel 和 VictoriaMetrics 后端制品保持一致。

默认 Linux 打包目标为 x86_64、CPython cp39 和 manylinux2014_x86_64。独立的 aarch64 构建选择 manylinux2014_aarch64，CPython 3.10 构建则使用另一套构建配置。这些配置只声明构建目标，不表示对应平台组合已经通过生产认证。

从源码构建

在 JDK 17 和 Maven 3.9.x 的 Linux 环境中构建；仓库会强制检查这些版本。Agent 和 Server RPM 的常规构建命令如下：

mvn -B -am -pl ambari-agent,ambari-server clean package rpm:rpm -Dbuild.os_arch=x86_64

如需在受控环境中构建 Python 依赖，应准备包含全部锁定制品的离线 Wheel 仓库：

mvn -B -am -pl ambari-agent,ambari-server clean package rpm:rpm \
  -Dbuild.os_arch=x86_64 -Dpython.wheelhouse=/srv/build/wheelhouse

指定离线 Wheel 仓库后会启用 PIP_NO_INDEX=true；Maven、Node 和 npm 仍需要各自的缓存或镜像。RPM 生成后应先检查内容，不要直接分发：

export AGENT_RPM=/path/to/ambari-agent.rpm
rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' "$AGENT_RPM"
rpm -qp --requires "$AGENT_RPM"
rpm -qpl "$AGENT_RPM"

确认架构、Python ABI 运行时封装脚本、私有库、LICENSE/NOTICE 文件和 SBOM 均符合预期。不要在目标节点上运行 pip install 来补装或替换依赖。

可选 Metrics 包

可选的 ambari-metrics RPM 包含经过审查的 VictoriaMetrics 监控后端，用于替代旧 AMS/Ganglia 集成；旧版 AMS 或 Ganglia 安装说明不适用于此候选版本。该模块可单独构建：

mvn -B -Pmetrics-rpm -pl ambari-metrics -am package rpm:rpm \
  -Dmetrics.package.version=3.1.0.0 -Dpackage.release=0.candidate1 \
  -Dbuild.os_arch=x86_64

应将监控后端版本、源码修订、校验和、元数据和 NOTICE 作为一个不可拆分的审查集合。上述命令只描述操作流程，不表示当前环境已经完成构建或认证。

安装前

记录候选版本标识、源码修订、目标操作系统和架构、Ambari JDK、Stack JDK、Python 可执行文件、数据库方案以及回滚备份。Rocky Linux 8 使用 AppStream python39；系统通用的 python3 可能指向其他次版本。运行时封装脚本与原生扩展必须使用同一个 ABI。

下载清单中不要发布密码、私钥、注册密钥或默认凭据。请通过经过审查的部署流程配置信任锚点和凭据。

依据

本指南依据源码提交 4e95d2e33493ac934d7d98a14a81d86c0f1bc0c4 和 Java 17 基线提交 94c6389a96b38bccef0b6a08269481a086b63ca1。参阅 Java 依赖、Python 运行时 和 RPM 打包。