docs: 允许调试期取消旧 CI 事件

This commit is contained in:
pikastech
2026-07-21 20:13:56 +02:00
parent e470b08b70
commit f1dd8dc125
3 changed files with 19 additions and 0 deletions
+6
View File
@@ -286,6 +286,12 @@ bun scripts/cli.ts hwlab nodes control-plane legacy-cicd --help
再由修复 PR 的手动 plan/trigger 交付;临时 patch 必须撤销或被声明式交付覆盖;
- 只读 status/history/events/logs/debug-step 仍是默认定位入口,
`closeout` 只属于显式 compatibility diagnostics,不得进入默认观察或恢复路径。
- CI/CD 不稳定或首次部署调试阶段允许直接取消已确认的旧执行对象或旧事件:
- 必须先用运行面 identity、source commit、创建时间和后继事件证明目标已经过时,且已有更新事件承担同一交付意图;
- 取消只终止该旧 PipelineRun、TaskRun 或事件的继续执行和资源占用,不得删除业务数据、GitOps desired state、Argo Application、Secret 或 source/ref authority
- 旧对象仍占用 repository concurrency、阻塞更新事件或已知会执行错误参数时,无需等待其自然超时;
- 优先使用现有受控取消入口;该入口不可用且控制面本身处于调试恢复期时,允许按 `$unidesk-daddev` P2 对精确对象执行一次直接取消,并记录取消前后状态;
- 取消只是调试期队列解阻,不是交付成功证据;最终仍须由 owning YAML、正常 source event、PaC、GitOps/Argo 和 runtime 自动链收敛。
- CI/CD、GitOps、rollout、PipelineRun、Argo、git-mirror 和 AgentRun 的观察、诊断与控制必须走受控 CLI;不要用裸 `kubectl``argo``tkn``curl` 当正式控制入口。PaC migrated consumer 只允许 `release plan` 后由 `release trigger --confirm` 发送 webhook。
- CI/CD 校验默认不得阻塞交付:
- 除非用户明确要求某项校验成为门禁,禁止新增会让 Pipeline、artifact、GitOps promote、Argo reconcile、runtime rollout 或 `/health` closeout 失败的配置一致性、版本、契约、schema、preflight 或跨对象校验;
@@ -116,6 +116,13 @@ bun scripts/cli.ts hwlab g14 control-plane cleanup-released-pvs \
- 对象不存在返回 `target-pipelinerun-not-found`
- 对象未完成返回 `target-pipelinerun-not-terminal`
- 调试期旧执行取消:
- CI/CD 不稳定或首次部署调试期间,先核对对象的 repository、consumer、source commit、创建时间、状态和更新事件 identity;
- 已被更新事件明确替代的旧 PipelineRun、TaskRun 或旧事件仍在占用并发槽、阻塞队列或执行已知错误输入时,可以直接取消,不必等待 hard timeout
- 取消必须精确到单个旧对象,只终止执行和释放资源,不删除 GitOps desired state、Argo Application、runtime workload、业务数据、Secret 或 source/ref
- 优先走受控取消入口;入口缺失或自身故障时,按 `$unidesk-daddev` P2 记录 identity、取消动作、终态和后继事件恢复证据;
- 更新事件开始执行只证明队列解阻,最终验收仍以正常 PaC、GitOps/Argo 和 runtime 自动链收敛为准。
- 大型 PipelineRun 造成 Kine/SQLite 压力时:
- cleanup 只属于控制面快速缓解;
- 长期修复必须消除 renderer 中重复内联的 `taskSpec`,并通过 PR 合并后的 plan 与手动 webhook 验收;