Pulse v6.3.0 Stable Cutoff Owner Approval 深度解析:Telemetry 驱动的发布放行机制
Pulse v6.3.0 Stable Cutoff Owner Approval 深度解析:Telemetry 驱动的发布放行机制
本文深度解析 Pulse 仓库 release-control 体系中的一份核心决策记录
docs/release-control/v6/internal/records/v6.3.0-stable-cutoff-owner-approval-2026-08-22.md。围绕 v6.3.0 从rc.5/rc.6晋升 stable 的真实过程,剖析其「Telemetry 证据 + Owner 风险接受 + 既有 Promotion 流程」的三层放行模型、隐私安全的遥测报告命令、以及独立于放行决策的 Windows 签名边界。读完你可复现 v6.3.0 决策所用遥测报告,理解hotfix_exception的真实语义,掌握 Stable Cutoff 与 Unsigned Windows 两类决策记录的读写与追溯方法。
背景:v6.3.0 之前的两条关键记录
在深入 v6.3.0 决策记录之前,先厘清它所在的时间线。它是 docs/release-control/v6/internal/records/ 目录下的一份稳定发布(Stable Cutoff)Owner 决策记录。该目录同时存放了 v6.2.0、v6.4.0 的同类记录,以及配套的 v6.3.0-stable-publication-proof-2026-08-22.md(发布后的验收证明)与 v6.3.0-unsigned-windows-owner-approval-2026-08-22.md(Windows 签名例外)。
值得注意的是,本文写作时 docs/release-control/v6/internal/RELEASE_PROMOTION_POLICY.md 已经演进到「机械式 release train」模型(founder direction 2026-10-04),训练规则要求候选项至少 24 小时 soak,且「版本绑定的 owner 例外」只被记录为历史实践、不再延续。v6.3.0 的放行决策因此是特定时间点上的历史实践:在 2026-08-22,它还属于「release steward + 版本绑定 owner 例外」阶段,恰好是理解该决策记录如何嵌入旧策略的典型样本。
RELEASE_PROMOTION_POLICY.md 第 533-553 行将 v6.3.0 记录归纳为策略级条目(规则 13),与 v6.2.0(规则 11)、v6.4.0(规则 17)并列。三者的共同模式是:release owner 声明内容 cutoff commit、将稳定版晋升绑定到已发布的 rc.N tag、通过 hotfix_exception=true 携带豁免穿过共享 promotion resolver、最终由 exact-SHA 的 Release Dry Run 与单构建发布工作流把关。
Owner 决策:一次性风险接受,而非 72 小时 soak 证据
记录第一段给出放行决策的全部要素:
- 决策日期:
2026-08-22 - 发布版本:
v6.3.0 - 内容 cutoff 基线:
53ba9786c5522a6839f9cbd3d01c02402556f9eb - 被晋升的预发布版本:
v6.3.0-rc.6 - 回滚目标:
v6.2.1 - 精确回滚重装命令:
./scripts/install.sh --version v6.2.1
Owner 决策的本质是一句话:release owner 在审阅最近两个 RC 的生产遥测姿态后,明确接受缩短的 rc.6 soak 期,以及该 tag 与 cutoff 基线之间的有界运行时与发布路径变更,然后指示发布 stable v6.3.0。
这里有两个极易误读的语义,文档特意澄清:
- 这不是 72 小时 soak 证据。它是一次性的 owner 风险接受(owner-risk acceptance),不是经过完整 soak 的验证证据,也不是后续版本的常设例外。
hotfix_exception=true只是运输豁免,不改变版本性质。该工作流输入把已批准的豁免携带到现有的 promotion resolver(即scripts/release_control/resolve_release_promotion.py),但它不会把这次 minor 版本发布重新归类为 patch hotfix。
第三条约束限制了放行后的改动范围:最终 release-preparation 提交只能改动受治理的版本、发布说明、资质(qualification)、测试护栏与 release-control 元数据。并且,推送的稳定版 SHA 必须先在不公开发布的 Release Dry Run 中通过,之后同一 SHA 才能走正常的单构建发布工作流。
Promotion Resolver 如何落地 hotfix_exception
为了让「豁免如何通过 resolver」的说法落在代码上,直接看 scripts/release_control/resolve_release_promotion.py 的解析逻辑:
MIN_STABLE_SOAK_HOURS = 24(策略演进后);MIN_MINOR_STABLE_SOAK_HOURS = 24;RELEASE_TRAIN_MIN_VERSION = (6, 5, 0)(v6.5.0 起严格按 train 规则)。resolve_metadata()收到hotfix_exception: bool参数:若hotfix_exception为真且版本是预发布(RC),直接抛错hotfix_exception applies only to stable promotions;若目标版本存在同版本 RC tag 或路径触碰例行 patch 风险边界(same_version_rc_tags or routine_patch_risks)而hotfix_exception为假,则拒绝晋升并要求「晋升已练习过的 RC,或用hotfix_exception携带具体的紧急原因」。- 当
hotfix_exception=true时,hotfix_reason必填,否则抛hotfix_reason is required when hotfix_exception is true。 - 对每次 stable 晋升,resolver 计算
soak_hours = (now - promoted_tag_publication_time) / 3600;若train_governed且非 patch 且 soak 不足MIN_MINOR_STABLE_SOAK_HOURS,或一般不足MIN_STABLE_SOAK_HOURS,均只在hotfix_exception为真时放行。 - 它还定义
RELEASE_METADATA_PATH_RE白名单:VERSION、deploy/helm/pulse/{Chart.yaml,README.md}、docker-compose.yml、docs/RELEASE_NOTES.md、docs/UPGRADE_v6.md、docs/releases/.+、docs/release-control/v6/internal/records/.+、status.json、deployment-installability.md等路径之外的一切,都属于「候选从未 soak 过的内容」,需要hotfix_exception才能通过。
这段代码是 v6.3.0 决策中「workflow input hotfix_exception=true carries the approved waiver through the existing promotion resolver」的精确实现:豁免不绕过检查,而是作为显式输入进入同一套检查逻辑。对应的策略测试 scripts/release_control/release_promotion_policy_test.py 也把「Exact rollback reinstall command: ./scripts/install.sh --version v6.2.1」等记录文本断言为校验目标,说明这些记录文件本身就是 resolver 与测试读取的对象。
Telemetry Evidence:隐私安全的生产遥测报告
放行的依据是「canonical, privacy-safe production telemetry report」。关键约束:报告查询的是 pulse-license 上的伪匿名聚合 heartbeat 行(只读),绝不把遥测与账号、许可证、人员或基础设施标识符关联。这正是 scripts/telemetry_adoption_report.py 的职责所在——它是生成该报告的唯一工具。
文档给出的精确报告命令(两条,分别针对 rc.5 与 rc.6):
python3 scripts/telemetry_adoption_report.py \
--ssh-host root@pulse-license \
--since-days 14 \
--target-version 6.3.0-rc.5 \
--format json
python3 scripts/telemetry_adoption_report.py \
--ssh-host root@pulse-license \
--since-days 14 \
--target-version 6.3.0-rc.6 \
--format json
结合 telemetry_adoption_report.py 的 CLI(parse_args,第 3936-3974 行)可以把每个参数落到源码:
| 参数 | 源码默认值 / 行为 | 说明 |
|---|---|---|
--ssh-host |
无默认 | 通过 SSH 在远端(如 root@pulse-license)运行内联 SQLite 脚本,只把「每安装的最新行 + 紧凑按安装事实」跨网络传回,不搬运完整 heartbeat 历史(fetch_rows_remote) |
--since-days |
默认 7,且 >=3 才允许(main 中 raise SystemExit("--since-days must be at least 3 ...")) |
源窗口;v6.3.0 决策用 14 天 |
--target-version |
默认取最新 stable,回退最新 RC | 高亮目标版本的最新态覆盖与同版本跟进分析 |
--baseline-version |
无 | 可选早期版本,用于 schema 门控的 alert-quality 比较 |
--github-repo |
rcourtman/Pulse |
校验「实际上已发布」的 release tag |
--include-mock-fleet |
默认排除 | 排除 mock fixture fleet(120×N Kubernetes pods + 7×N VMware hosts 模式)以免污染 adoption 读数 |
--format |
text / json 二选一 |
v6.3.0 决策用 json |
报告涉及的数据库是 licenses.sqlite(默认路径 /var/lib/pulse-license/licenses.sqlite),表为 telemetry_pings。脚本核心是三层聚合:
- 版本规范化:
normalize_reported_version()剥离v前缀、识别git describe形式与 SemVer、把手动构建/dev 构建归类到dev通道,防止污染发布报告。 - 安装级事实:远端 SQL 用窗口函数按
install_id取最新行,并针对每个目标版本计算 heartbeat 数、同版本连续心跳对、首心跳基线计数与逐信号增减量。 - mock 排除:
is_mock_fleet_row()用 Kubernetes pod 数与 VMware host 数的倍数指纹剔除测试环境。
v6.3.0 决策引用的三个度量值(测量完成 2026-08-22T09:19:36Z、最新遥测行同一时刻、数据库人口 379,909 行来自 27,539 个轮换伪匿名安装 ID)都可溯源到 db_stats 汇总(MAX(received_at)、COUNT(*)、COUNT(DISTINCT install_id))。
消毒聚合快照:rc.6 与 rc.5 的姿态
文档给出了两份消毒后的聚合快照。注意这些数字是 2026-08-22 时点的历史事实,用于说明该决策的审阅范围,不代表任何持续性数据。
rc.6(被晋升的候选)
- 18 个活跃安装:10 个二进制 + 8 个 Docker
- 35 条目标版本 heartbeat;其中 3 个安装在测量时已有更新的同版本 heartbeat
- 滚动窗口更新尝试 56 次、成功 56 次、失败 0 次
- 回滚、向前离开、未分类版本迁移均为 0
- 更新失败、通知失败类别、已批准动作失败、卡在执行中的动作等「跟进增量」均为 0
rc.5(前一候选)
- 观察到 7 个安装:6 个仍停留在 rc.5,1 个推进到 rc.6
- 10 条目标版本 heartbeat;2 个安装有同版本跟进
- 无回滚或未分类版本迁移
- 唯一一次滚动窗口更新失败出现在首个 heartbeat 上,且任何同版本跟进都没有增加,因此报告不把它归因于 rc.5
- 通知失败类别、已批准动作失败、卡在执行中的动作的跟进增量均为 0
报告自身的局限(被纳入已接受风险)
文档明确承认:样本量不大、rc.6 比正常 72 小时窗口更年轻、报告是粗粒度运维遥测而非崩溃分析、首个 heartbeat 的滚动计数器只是基线。这些局限是「已接受风险」的组成部分,而不是被包装成更强证据。这正是该记录最值得借鉴之处:它把证据边界与决策边界分开陈述,owner 是在明知局限的情况下做一次性风险接受。
从源码结构看,TARGET_RELEASE_ACTIVITY_COUNT_FIELDS(第 1097-1123 行)定义了「同版本跟进」要审计的计数器集合,涵盖 alerts、notification、audit、report、update 以及全部 pulse_intelligence_* 字段;_summarize_target_release_followup_analysis()(第 3047-3185 行)则实现「首心跳仅作基线、同版本连续心跳才构成归属、计数器减少单独报告绝不与增加相抵」的解读规则——这些规则保证了 v6.3.0 决策中「滚动窗口失败不归因于 rc.5」的断言在算法层面成立。
决策记录与发布证明、排练记录的相互印证
放行决策不是孤立的。同一日期还有三份可交叉验证的记录:
-
v6.3.0-stable-publication-proof-2026-08-22.md(发布证明):公开的 stable release、exact source commitca311323e96392efe18038707884283cd59aa71e、来自rc.6的晋升谱系、回滚目标v6.2.1。证明给出了三段 GitHub Actions 记录:exact-SHA 的 Release Dry Run32566890805(success)、发布激活运行32568823801(success)、权威收敛运行32569698430(success)。发布被确认为 stable(draft=false, prerelease=false),注释 tag 指向精确源 commit,包含 218 个资产与release-activation.json,并通过./scripts/validate-published-release.sh v6.3.0 rcourtman/Pulse逐文件校验checksums.txt、每文件 SHA-256 sidecar 与必需 SSH 签名 sidecar。它还披露了收敛过程中的一次失败与修复(激活派发运行32569347839因激活标记 404 在获取全局客户推广租约前失败、所有可变客户面任务被跳过,随后由治理继任者32569698430采用已完成原 owner 的已提交标记并全项通过)。末尾还记录了该版本 Windows 未签名例外及其版本边界。 -
rc-to-ga-promotion-readiness-rehearsal-2026-08-22.md(预发布到 GA 排练记录):机器生成的排练摘要元数据信封:Hotfix exception: true,hotfix reason 原文为「Release owner approved the v6.3.0 cutoff after clean privacy-safe production telemetry from rc.5 and rc.6 and accepted the shortened rc.6 soak and bounded post-RC changes」;Prerelease soak hours at rehearsal time: 15;Windows Authenticode required: false;Unsigned Windows exception: true。这份记录由scripts/release_control/internal/record_rc_to_ga_rehearsal.py从指定 run 物化,是「hotfix_exception=true + Windows 例外」同时在元数据层落地的证据。 -
v6.3.0-unsigned-windows-owner-approval-2026-08-22.md(Windows 签名例外):见下一节。
把三份记录放在一起读:cutoff 决策授权「从 rc.6 直接晋升 stable」;排练记录在 dry-run 层面验证「该晋升元数据可被工作流接受」;发布证明则证明「同一 SHA 在 dry run、激活、收敛三个环节全部通过后真正公开」。三份文件互为审计链的上下游,也正好解释了为何决策记录要求「exact pushed SHA must pass the no-publication Release Dry Run before the same SHA is dispatched」。
Windows 签名边界:独立的、版本绑定的例外
文档最后一段专门划清边界:本次 cutoff 决策本身没有豁免 Windows 签名。release owner 随后另行记录了版本绑定的 v6.3.0 unsigned-Windows 决策(v6.3.0-unsigned-windows-owner-approval-2026-08-22.md)。该决策只改变 Authenticode 要求,保留 exact-SHA、checksum、detached signature、manifest 与 published-digest 控制。
补充记录的细节包括:决策日期、发布版本、晋升的预发布版本、回滚目标与精确回滚命令均与 cutoff 记录一致;明确「这是版本绑定的风险接受,不是 Authenticode 成功的证据,也不是后续版本的常设例外」;stable v6.3.1 及以后恢复强制 Authenticode(除非另行记录显式、版本绑定的 owner 决策);并强调该签名决策独立于 v6.3.0 的 telemetry 背书 cutoff 与缩短 soak 批准,「两个例外互不扩大」。
这一点在 RELEASE_PROMOTION_POLICY.md 规则 14 中成为正式策略条目,并且 resolve_release_promotion.py 中 WINDOWS_AUTHENTICODE_AVAILABLE = False、WINDOWS_AUTHENTICODE_STANDING_UNSIGNED_MIN_VERSION = (6, 3, 2) 表明从 v6.3.2 起进入了「Standing unavailable」状态,进一步的策略演进可见 windows-authenticode-unavailable-owner-policy-2026-08-25.md。
放行后的约束与可复现的回滚路径
决策记录中的「Exact rollback reinstall command」不是摆设,它与 install.sh 的 --version 语义直接对应:install.sh --version vX.Y.Z 精确固定版本安装,install.sh 源码(第 5879-5881 行)将 --version 解析为精确版本参数;在升级路径中 --version 也是「刻意回滚」的唯一合法途径(第 5276 行「use --version only for a deliberate rollback」)。因此 ./scripts/install.sh --version v6.2.1 是从 v6.3.0 回滚到上一个 stable 的精确、可执行命令。
结合 RELEASE_PROMOTION_POLICY.md 的 Rollback Rules:不能删除或重写已发布的 tag 来掩盖坏版本,必须用更新版本加上显式指导来取代;前一个 stable 版本必须保持可通过精确版本 pin 安装,直到替代 stable 被信任。v6.3.0 记录中的回滚目标与命令,就是这条规则的实例化。
小结:该记录的方法论价值
v6.3.0-stable-cutoff-owner-approval-2026-08-22.md 是一份信息密度极高的治理记录。它示范了:
- 证据与决策分离:telemetry 快照 + 明确局限 → owner 的一次性风险接受,而不是把弱证据说成强证据;
- 豁免与流程不分离:
hotfix_exception=true通过既有 resolver 检查链(scripts/release_control/resolve_release_promotion.py)落地,豁免不绕过门禁; - 边界显式化:内容 cutoff 只允许 release 元数据变更;Windows 签名例外单独记录、版本绑定、独立于 cutoff 决策;
- 可审计、可复现:报告命令、回滚命令、三份同日记录(cutoff / rehearsal / publication proof)构成完整审计链。
对需要在自己的发布治理中引入「telemetry 数据驱动 + owner 风险接受」模式的团队,这份记录连同 Release Promotion Policy、Telemetry Adoption Report 脚本 与 Promotion Resolver 是一套可以直接参照的完整实现与文档范本。