docs: 收敛 PaC registry 状态说明

This commit is contained in:
Codex
2026-07-13 11:01:42 +02:00
parent f130598ca2
commit 40cdb9466d
2 changed files with 13 additions and 1 deletions
+4 -1
View File
@@ -40,7 +40,10 @@ bun scripts/cli.ts agentrun control-plane legacy-cicd --help
bun scripts/cli.ts hwlab nodes control-plane legacy-cicd --help
```
节点级只读状态必须优先用 `cicd status --node <NODE>`。它从 `config/platform-infra/pipelines-as-code.yaml` 找到该 node 的所有当前 PaC consumer,一次性汇总 PipelineRun、Argo/GitOps、runtime readiness 和诊断;不要再靠阅读源码或手动拼三条 consumer 命令来回答 “NC01 的 CI/CD 流水线情况”。text 输出在零 consumer、ready、warning 与失败时均返回非空 typed 摘要和精确下钻命令;GitOps-only consumer 的 registry 显示 `N/A`,只有 owning YAML 为该 consumer 对应 pipeline 声明 image repository 时,registry missing 才是 blocker。`platform-infra pipelines-as-code status --target <NODE> --consumer <id>` 只作为单 consumer drill-down。
- 节点级只读状态
- 优先用 `cicd status --node <NODE>`
- 单 consumer 再用 `platform-infra pipelines-as-code status --target <NODE> --consumer <id>` 下钻;
- 状态输出与 registry applicability 的长期判定见 [references/gitea-pac.md](references/gitea-pac.md)。
- 新增 PaC consumer 的首次引导:
- 先执行一次 `pipelines-as-code bootstrap --dry-run`
@@ -78,6 +78,15 @@ bun scripts/cli.ts platform-infra pipelines-as-code bootstrap --target <NODE> --
- 只有归属或 TaskRun 断点不清楚时再用 `history --id``debug-step --id`
- 默认不使用 `--full``--raw`,避免把大对象带回本机;
- consumer 声明 `sourceArtifact` 且需要精确提交验收时,最后执行一次 `source-artifact verify-runtime`
- node 状态摘要必须保持可读且可下钻:
- text 输出在零 consumer、ready、warning 与失败时都返回非空 typed 摘要;
- 摘要只给出与当前状态匹配的精确下钻命令;
- 不要求操作者阅读源码或手工拼接多个 consumer 命令。
- registry applicability 只由 owning YAML 决定:
- consumer 对应 pipeline 声明 image repository 时,registry 状态适用;
- 适用的 registry 缺失是 blocker
- GitOps-only consumer 未声明 image repository 时,registry 显示 `N/A`
- 不得因 registry 不适用而把 GitOps-only consumer 判为失败。
## PaC 源码侧制品同步