跳转至

顶层阶段

顶层阶段

对于 rerun_group=all,会首先运行一个 Check for reusable validation evidence 任务。它会在相同的发布配置、覆盖策略、有效浸泡设置和验证输入下,查找最新的先前通过的完整验证。精确目标重跑使用 exact-target-full-validation-v1。某个后代的完整差异包含所选 CHANGELOG/YYYY.M.PATCH.md 且仅包含该条目、其匹配的 CHANGELOG/records/YYYY.M.PATCH.md 以及根目录 CHANGELOG.md 时,使用 split-changelog-release-v1。允许条目/记录的添加或修改以及索引修改;拒绝重命名、删除、其他发布和文档源编辑。以往的仅根目录收据保留 changelog-only-release-v1。在任一变更日志策略下,每个产品通道都会被跳过,验证器会独立地重新检查 GitHub 提交比较、不可变的父工件、子运行和调度日志。任何其他目标变更都需要全新的 Code SHA 验证。传递 reuse_evidence=false 以强制进行全新的完整运行。证据复用仅在 main 分支或规范的 SHA 固定 release-ci/* 引用上运行,其工作流提交仍属于可信的 main 谱系;其他工作流引用则会全新运行所选通道。

复用搜索在加载子运行、任务日志和执行计划之前,会先检查每个绑定的父级清单是否符合资格。不兼容的配置文件、输入、目标和非根运行会被提前拒绝。符合条件的候选者在复用之前仍需经过完整的来源和尝试验证。验证器并发读取独立的子项(最多七个),为每个尝试保留其任务数据以进行策略检查,并在报告成功或失败之前等待所有读取完成。每个子项内部的尝试和分页保持顺序执行。目标解析和复用检出仅包含其工具和发布元数据;两者都不需要完整的源代码树。

子项调度即使在其源父级失败、被取消或仍处于活动状态时,也可以复用单个已通过子项的密封收据。它最多扫描 100 个最近的调度运行,最多检查 40 个目标收据清单,并在两分钟内对每个角色最多五个匹配收据进行全面验证。其他目标和其他工具的运行不消耗五个验证预算。目标、角色、非空调度输入/默认值和候选描述符字节必须匹配;空字符串输入等同于缺失输入,因为 GitHub 会从 github.event.inputs 中省略它们。子项的 Tooling SHA 必须等于当前父级的 Tooling SHA,并且仍然是 main 的祖先。工具缺失或不同将失败关闭;不存在惰性路径例外。调度日志会解释每个被评估的拒绝原因,标识被复用的子项,并总结跳过的运行和新的调度。计划密封、收集器和最终验证会重复工具和收据检查。

完整验证通过 full-release-artifacts.yml 启动独立的 npm 和 Docker 生产者运行。只读的 openclaw-npm-preflight.yml 同时启动源代码、SDK、依赖和包准备。当单个根/核心构建和打包完成时,包内容和生命周期检查开始。早期的 openclaw-npm-package-descriptor-<run-id>-<attempt> 工件也会在资格验证继续进行时解除候选准备的阻塞。最终资格验证会合并每个成功的精确源代码证明,并密封相同的 tarball 字节。对于随附 npm-shrinkwrap.json 的旧版候选者,准备工作会在发出包描述符之前,将打包的根清单同时与 shrinkwrap 的根声明和已安装的包条目进行比对。Tarball 资格验证会重复该检查。缺少必需的运行时依赖会导致验证失败,即使 npm 会成功退出、准备好的依赖在本地消费者中掩盖了遗漏,或者重新打包的 Docker 镜像可以工作。需修复候选者的 shrinkwrap 并生成新的工件证据;资格验证从不修复冻结的包字节。SDK 消费者安装保留其较小的依赖上下文。最终清单会在 publicationArtifacts.npmPreflight 中记录其不可变描述符。常规最终发布会为当前 npm beta 和 latest 的先前版本提供单独的 SDK 兼容性报告,并共享同一目标快照。发布会选择其通道的报告和确认,而无需重新构建。Beta 预发布和扩展稳定目标保留其所需通道。

当发布选择官方 npm 插件时,完整发布验证还会以仅工件模式针对确切的 Release SHA 调度 plugin-npm-release.yml。该所有者会打包每个选定的插件,验证并读回生成的 tarball,并在 publicationArtifacts.pluginNpm 中密封聚合描述符。发布决策在通过之前需要该描述符。准备好的发布会采用那些确切的工件 ID、摘要、生产者运行和尝试;它不会在完整发布验证之后重新打包插件 npm 候选者。因此,仅源代码文件和夹具无法触发工件检查,除非 npm 实际将它们包含在发布的 tarball 中。

对于直接调度的 OpenClaw NPM Release 仅预检运行,如果在源代码检查和包准备成功之后资格验证失败,则重新运行失败的资格验证任务。它会复用先前尝试中确切成功的生产者任务和包字节,即使该尝试失败或被取消。失败或未完成的生产者任务仍然不符合条件。最终的 npm 发布仍然要求当前生产者运行成功完成,并且每个保留的证明任务仍然是有效的成功任务。完整发布验证(FRV)拥有的独立生产者支持相同的定向恢复;父级会采用已验证的收据,而无需重新构建成功的打包工作。

docker-release-prepare.yml 为两种原生架构进行构建,保留 OCI 索引及其 SBOM/来源信息,并在批准之前运行镜像冒烟检查。OCI 导出对新的层使用 gzip 压缩级别 1,并复用缓存的层而不强制重新压缩,从而保留冒烟检查和升级所使用的镜像格式。

默认镜像和浏览器镜像共享构建器的本地缓存。准备阶段不会传输远程构建缓存:新的来源时间戳会使应用层失效,且实测的传输成本高于复用运行时环境所节省的开销。全新的 runner 会重建该环境,包括可变的 Debian 和 npm 更新;密封的 OCI 工件仍然是发布时可复用的输入。

托管虚拟机在作业结束时回收其本地构建器,因此工件上传后,构建器卷的删除不会延迟密封。

最终清单记录 publicationArtifacts.docker。准备阶段既没有发布密钥,也不具备 registry 写入权限。批准后,Docker Release 验证源/标签、生产者、工件哈希和镜像摘要,然后将这些字节提升到 GHCR 和 Docker Hub。发布锁涵盖 registry 写入和选择器提升。没有已准备镜像的历史证据在提升前使用相同的准备工作流。

如果 Docker 准备成功但发布在同一工作流运行中失败,请重新运行失败的发布作业。新的发布者尝试会验证原始成功的准备作业和密封工件,而无需重新构建。单独的发布者运行仍然要求原始生产者尝试处于活动状态或已成功;它无法通过此重试路径采用失败的生产者尝试。

全新的面向包的验证会将准备好的根/核心包传递给独立的候选生产者,由其调用 Full Release Candidate。其 registry 承载精确的未发布核心依赖和选定插件。安装程序在解析根包之前启动该 registry,涵盖 npm、pnpm、Bun 和跨操作系统通道。已发布的基线版本仍可通过上游 registry 获得。Plugin Prerelease 和 OpenClaw Release Checks 各自立即调度一个独立阶段,而其候选阶段则等待获取。两个候选阶段在使用前都会验证相同的包 SHA、工件 ID、服务摘要、生产者运行尝试和 Docker 归档摘要。与包无关的裸 Docker 层使用内容寻址的 GHCR 缓存;候选特定的镜像保持为不可变的 GitHub 工件。带有显式已发布包规范的定向运行则保留现有的包路径。

准备阶段还会生成一个规范请求摘要和一个七天的 full-release-candidate-v2-<request-sha256> 证据工件。其有界清单绑定精确的目标和 Tooling SHA、发布与浸泡策略、有效的幸存者基线和场景、准备计划摘要、排序后的插件包集合、生产者与发布者的 workflow/job/run 身份,以及包、registry 和镜像工件的身份与过期时间戳。执行计划对该证据进行密封。在准备候选之前,对于相同的规范请求和精确准备的 npm tarball 摘要,总控流程只有在重新验证了精确的 workflow 运行、发布者作业身份、归档摘要、清单、生产者尝试与作业,以及每个包、registry 和镜像工件的实时元数据之后,才能复用剩余生命周期至少十四小时的最新工件。已证实的缺失会创建新的候选。有界查找的不确定性和选择后的失败均属阻塞性问题,因此运行不能静默切换候选。即使源 SHA 未更改,不同的已准备 tarball 也需要新的候选。完整验证仅在包资格认证和 Docker 准备也成功后才算成功;仅凭产品 Release Decision 通过本身并不授权发布。

每种发布类型都会在强制性的 Docker 镜像准备中,于两个原生架构上验证 runtime-assets Docker 目标。

阶段 详细信息
目标解析 作业: Resolve target ref
子工作流: 无
证明: 解析发布分支、标签或完整提交 SHA,并记录所选输入。
重试: 如果此步骤失败,请重新运行总控流程。
发布准备 作业: Prepare release npm artifacts、Qualify release npm artifacts、Prepare plugin npm artifacts 和 Prepare release Docker artifacts
子工作流: 独立的核心 npm、插件 npm 和 Docker 生产者运行
证明: 在发布前对精确的根/核心及选定插件 npm tarball 加上两个原生 Docker 架构进行资格认证。父级重试会恢复原始生产者记录和收据。
重试: 在原始生产者运行上重试失败的 npm 资格认证作业,保留成功的准备结果,并让父级收集已验证的收据。
阶段 详情
共享候选版本 作业: Acquire full release candidate
子工作流: Full Release Artifacts 调用 Full Release Candidate,后者复用受信任候选版本,或在已证明缺失时准备一个候选版本
证明: 验证确切的 npm tarball、注册表、功能镜像以及生产者/发布者绑定。准备在原始 npm 字节就绪后、资格验证完成前开始。
重跑: 使用同一候选版本重跑受影响的包、插件预发布、跨操作系统或实时/E2E 组。
Vitest 和普通 CI 作业: Run normal full CI
子工作流: CI
证明: 针对目标 ref 验证所选 CI 图。npm-beta-v1 和 npm-stable-v1 保留 Linux/macOS/Windows Node、插件和通道契约、Node 兼容性、检查、构建产物冒烟、文档、Python 技能以及 Control UI;它们推迟 macOS Swift/OpenClawKit、iOS、Android 和原生 i18n。其他覆盖策略使用完整 CI。
重跑: rerun_group=ci。
插件预发布 作业: Run plugin prerelease independent validation 和 Run plugin prerelease candidate validation
子工作流: Plugin Prerelease
证明: 独立的静态和代理式覆盖可以在获取之前开始,而依赖候选版本的 Docker 泳道会消费密封的包和插件注册表身份。
重跑: rerun_group=plugin-prerelease。
发布检查 作业: Run release checks independent validation 和 Run release checks candidate validation
子工作流: OpenClaw Release Checks
证明: 独立的安装、QA 和实时覆盖可以在获取之前开始,而包、跨操作系统以及依赖候选版本的 Docker 泳道会消费密封的候选版本。稳定版和完整版配置保留详尽的实时/E2E 和发布路径覆盖。
重跑: 对失败面进行分类,并选择一个具体的发布检查组。
包 Telegram 作业: Run package Telegram E2E
子工作流: NPM Telegram Beta E2E
证明: 当设置 release_package_spec 或 npm_telegram_package_spec 时,执行聚焦的已发布包 Telegram E2E。npm-beta-v1 推迟此子工作流;显式 npm-telegram 和 soak 保留它。Package Acceptance 在选中时负责未发布候选版本的 Telegram 证明。
重跑: 使用 release_package_spec 或 npm_telegram_package_spec 执行 rerun_group=npm-telegram。
产品性能 作业: Run product performance evidence
子工作流: OpenClaw Performance
证明: 针对目标 SHA 执行发布配置性能(profile=release、repeat=3、publish_reports=false)。除 npm-beta-v1 外,all 或显式 performance 会选中它;选中的回归在所有配置中都会阻塞。选中的子工作流仍会完成,并证明其报告发布者被跳过。
重跑: rerun_group=performance。
发布决策 作业: Release Decision
子工作流: 无
证明: 轮询确切记录的子运行 ID 和尝试次数,执行发布策略,并发布与尝试次数绑定的决策工件。决定性失败会变为 blocked_diagnostics_running,而不相关的子诊断继续运行。
重跑: 仅修复或重跑阻塞面。
诊断排空 作业: Diagnostic Drain
子工作流: 无
证明: 在 fail_fast=false 时,跟踪每个选中的确切子工作流直至终止,且不取消,并写入计时、失败任务、运行尝试和 Tooling-SHA 证据。收集器取消则会立即写入包含活动子工作流身份的 cancelled_with_children 交接。
重跑: 仅对 orchestration_error 恢复收集;产品失败不会使排空无效。
阶段 详情
执行计划 作业: Seal release execution plan
子工作流: 无
证明: 在稳定的运行绑定工件中持久化原始父级尝试、精确的子级身份和标题、所需覆盖范围、门禁、复用身份,以及带有精确生产者和发布者绑定的全新候选请求。第二次尝试的收集器恢复会恢复此工件,而不是重新调度。
重跑: 仅恢复现有计划;缺失计划属于编排错误。
总验证器 作业: Verify full validation
子工作流: 无
证明: 下载不可变的执行计划以及精确的尝试绑定的 Release Decision 和 Diagnostic Drain 工件,验证它们的共同摘要和父级元组,并且仅接受严格的绿色决策加上终态排空。
重跑: 恢复现有收集器,或仅重跑失败的产品表面;验证器从不重新分类或重新调度子级。

七个子级调度作业仅负责调度和精确身份捕获。它们输出子级运行 ID、运行尝试和 URL,然后结束。Release Decision 负责阻塞答案;Diagnostic Drain 负责完整的终态证据。不可变执行计划负责跨收集器尝试的子级身份。决策状态是 qualifying、blocked_diagnostics_running、passed、blocked_complete、orchestration_error 或 cancelled_with_children 之一。持续的 GitHub API 失败属于编排错误。如果子级的工作流路径、显示标题、ref、Tooling SHA 或运行 ID 发生变化,则属于不同的来源不匹配。单调更新的尝试仅通过 继续失败的验证 中的复合尝试规则接受。

blocked_diagnostics_running 对立即诊断是安全的,但在 Diagnostic Drain 达到终态之前不适合重试。orchestration_error 授权针对相同精确子级身份的收集器恢复,绝不重新调度测试。blocked_complete 表示诊断已完成;它不声称排空仍在运行。

当被选中时,总验证器以仅工件模式调度产品性能。OpenClaw Performance 仅允许计划运行或显式设置 publish_reports=true 的手动调度发布报告。仅工件保护必须成功完成,以证明发布者作业保持跳过。所选性能子级的证据记录 controls.performanceReportPublication=artifact-only;每当选中该子级时,验证器和复用选择器都要求匹配的规范化性能子级证明。npm-beta-v1 将性能记录为延迟,而不是调度一个其结果仍需要终态证据的子级。

验证器将规范清单上传为 full-release-validation-<run-id>-<run-attempt>。证据工具在下载该精确工件 ID 之前,会验证其工件 ID、摘要、生产者运行和尝试。它会限制下载的 ZIP 大小,将其字节与 REST sha256: 摘要进行验证,并流式传输唯一允许的有界清单条目,而不解压归档。为旧版发布消费者保留稳定名称别名。验证器始终优先选择带尝试限定的工件,并且仅对尝试 1 的清单 v2 生产者接受稳定名称。它拒绝后续尝试和清单 v3 使用该稳定名称,因此一旦生产者发出清单 v3,别名就不再适用。

并发以 Validation SHA、Tooling SHA、重跑组、发布配置和有效浸泡覆盖率为键,并且不会取消较旧的运行。Release Checks 子级也分离配置和有效浸泡,从而在两个工作流级别保持独立准入。Stable/full 将浸泡规范化为启用,因此显式启用它不会接受重复请求。父级取消或超时会保留已采用的身份检查子级继续运行,并在状态收集器能够完成其取消交接时记录 cancelled_with_children。当某个精确子级不再有用时,显式取消它。当 SHA 固定的辅助程序已经拥有父级时,不要运行第二个前台监视器;仅在辅助程序已返回或父级被单独调度后,才使用 release-ci-summary --watch。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw