版本：3.1.0（预览）

源码基线

参考项	修订或版本
上一版本源代码标签	`release-3.0.0`, `3acb048b3f6e209d6d1e5ac54efcbd30f1b25c57`
2026-09-07 审查的社区 trunk	`94c6389a96b38bccef0b6a08269481a086b63ca1`
监控目标基线，PR #4182	`4e95d2e33493ac934d7d98a14a81d86c0f1bc0c4`
2026-09-22 多集群专题核查	`fc07b5cb873dc154c48349085494e664baf6b9d1`，包含 AMBARI-26656 / PR #4216
审查 trunk 中的 Maven 开发版本	`3.1.0.0-SNAPSHOT`

对于本文档，PR #4182 包含在预期的 3.1.0 功能基线中。发布候选版本必须同时包含选定的社区更改和监控实现；表中的参考 SHA 不是要求用旧功能分支替换较新的社区工作。

网站发布标签为 3.1.0。四段式 Maven/软件包开发版本不表示存在中间的公开 3.0.x 版本。

变更选择方式

审查使用源代码祖先关系，而不只是提交日期。功能分支可能包含较早日期的提交，这些提交在 3.0.0 之后才首次成为主线的一部分。审查的 trunk 在上一版本标签之后包含 181 个可达提交；发行说明按面向用户的影响归纳这些提交，而不是逐一列出每个测试或合并。

维护者可以针对固定的审查版本重现比较：

git log --first-parent --date=short --format='%h %ad %s' \
  release-3.0.0..94c6389a96b38bccef0b6a08269481a086b63ca1
git diff --stat release-3.0.0..94c6389a96b38bccef0b6a08269481a086b63ca1

主要证据

主题	来源
监控控制面/数据面及替换边界	遥测架构
VictoriaMetrics 部署拓扑和配置	受管理的 Stack 服务
新的监控数据库模型	UpgradeCatalog310
受管理的 Java 依赖	项目 POM、构建策略
Python 运行时和分发契约	Agent 元数据、Agent 打包、有效实现审计
React 路由和权限	Routes、主要 UI 选择
选定的监控运行时捕获	三节点证据

证据边界

监控证据包括一个配备 VictoriaMetrics Server、VMAGENT、VMAUTH 以及选定服务/主机仪表板的三节点 Rocky Linux 8 ARM64 部署。它不认证每种分布式拓扑或每种故障模式。

Python 现代化记录包括 Linux x86_64 RPM 和部署验证，以及针对其他 ABI/架构配置的独立暂存构件检查。某个配置受支持不等于每个发行版都有已发布并通过认证的二进制文件。

React 对等基线区分实现、静态比较和运行时验证。较早的审查快照不是当前测试证书，不得将其转换为“每个角色、SSO 模式、自定义 Stack 和恢复路径都已通过”的无条件声明。React 指南列出了已实现的工作流界面和验收边界。

文档构建和浏览器检查会验证本网站的路由、翻译、标签和资源，但不会执行 Ambari 集群升级、Maven/RPM 生产构建或监控故障演练。

多集群专题补充

多集群指南使用上表中较新的固定 trunk 版本，核查集群隔离、持久化向导恢复、Admin 管理与 HBase 托管依赖。这是聚焦源码补充，不是重新执行原有整版审查或新的 RPM 验收。

指南区分最终独立集群包验收与早期带覆盖补丁的托管 HBase 部署证据，并说明真实 KDC、解绑与数据保留、故障注入及消息代理撤权等剩余门禁。运维指南列出了发布最终支持声明前仍需补齐的证据。

运行时 Mpack 与控制台后续版本

运行时商店指南增加了单独标识的开发后续版本，检查日期为 2026-09-29：

输入	检查的快照
Ambari 实现	分支 `AMBARI-26663`，提交 `3a71190847503b033036833d1d49ba0ce325ca41`
独立参考商店	提交 `c10a271`，准确的定义版本由 `release.json` 选择
参考部署范围	Rocky Linux 8/aarch64、systemd、基础非 HA 服务
控制台验收范围	桌面环境，覆盖服务聚合选择、完整内容编辑、外观导航和监控交互

这些实现快照是在开发检出中检查的，不代表新发布的 Apache 源码标签、可下载的 ASF 二进制发行版，也不能证明每个 3.1 构建都已经包含它们。应取得配套供应的构建和商店，并在使用流程前检查发布的清单与 API 能力。

证据输入包括核心检出中的 docs/mpack/http-api.md、docs/mpack/corrective-implementation.md 和 docs/frontend-refactor/react-current，以及商店的 release.json、各服务 README、docs/content-configuration.md 和 docs/content-configuration-acceptance.md。较晚的完整配置验收记录替代了较早的定义版本示例和不可安装的 MinIO 草稿。

该快照包含十项所选服务的基础运行检查及针对性的配置失败恢复检查，不等于通用高可用、多平台、所有角色、数据迁移或生产负载认证。网站构建和浏览器测试只验证文档行为。

建议先阅读商店概览、服务矩阵和工作区指南。

发布版本前

选定发布候选版本后更新此基线。记录最终源代码标签、签名构件/校验和位置、软件包目标矩阵、支持的升级路径、测试结果和发布投票结果。完成这些工作后，才能将预览标记替换为已发布版本。

变更选择方式​

主要证据​

证据边界​

多集群专题补充​

运行时 Mpack 与控制台后续版本​

发布版本前​