docs: update hwlab gitea source authority references

2026-07-06 00:17:49 +00:00
parent 379d920a02
commit f7bed4527f
4 changed files with 7 additions and 7 deletions
@@ -40,7 +40,7 @@ bun scripts/cli.ts hwlab nodes control-plane refresh --node <node> --lane v03 --

 `control-plane apply --confirm` 是 node/lane 控制面更新入口：先从 `config/hwlab-node-control-plane.yaml` 收敛 node-local infra、git-mirror ConfigMap、RBAC、Tekton/Argo 前置对象，再应用 source-render 的 runtime namespace、Pipeline 和 Argo Application。node-scoped git-mirror 脚本只有 infra manifest 是权威来源；不要把 HWLAB source render 生成的 `devops-infra/git-mirror.yaml` 当作正式 apply 来源。

-`trigger-current --confirm --wait` 是 node/lane CI/CD 一键入口：按 YAML 解析 source head，执行 k8s git-mirror source snapshot sync 和必要 pre-flush，刷新 control-plane，创建或复用 commit-pinned PipelineRun，等待 PipelineRun 终态，并在终态成功后继续执行 post-flush、GitOps/Argo、runtime readiness 和 public `/health` closeout。
+`trigger-current --confirm --wait` 是 node/lane CI/CD 一键入口：按 YAML `sourceAuthority` 解析并同步 source snapshot，legacy lane 执行 k8s git-mirror source snapshot sync，Gitea/PaC 迁移 lane 执行受控 Gitea mirror sync 并读取 immutable snapshot ref；随后执行必要 pre-flush，刷新 control-plane，创建或复用 commit-pinned PipelineRun，等待 PipelineRun 终态，并在终态成功后继续执行 post-flush、GitOps/Argo、runtime readiness 和 public `/health` closeout。

 120 秒是同一条 CLI 的端到端预算，不是每个子阶段各等一轮。嵌套 git-mirror sync/flush 必须按剩余预算裁剪并跳过多次 retry；状态探测也必须按剩余预算收窄。超预算时 CLI 返回 `pending` warning，输出阶段分解、PipelineRun 状态、GitOps flush revision、Argo observed/target revision、runtime/public readiness、pending TaskRun/Pod drill-down 和下一条受控 status 命令。PipelineRun 已成功但 Argo/runtime/public 仍在收敛时，状态原因应落在 Argo/runtime closeout，不再泛化成 CI TaskRun pending。

@@ -1,6 +1,6 @@
 # Git Mirror

-Git mirror 是 HWLAB/AgentRun CI/CD 的 source authority 和 GitOps flush 入口。不要回退到 operator host git、目标 host fixed workspace 或第二套 source resolver。
+Git mirror 是 legacy lane 的 source authority 和迁移期 GitOps flush 入口；Gitea/PaC 迁移 lane 的 source authority 是 Gitea controlled mirror 和 immutable snapshot ref，legacy git-mirror 只承担 GitOps flush，除非后续 issue 明确迁移 GitOps writeback。不要回退到 operator host git、目标 host fixed workspace 或第二套 source resolver。

 ## HWLAB Git Mirror

@@ -29,7 +29,7 @@ PipelineRun `gitops-promote` 如果报 git mirror 控制面漂移、refs 不一

 手动 trigger closeout 不能只看 PipelineRun `Completed`。必须继续查 `control-plane status --pipeline-run <name>` 和 `git-mirror status`；node-scoped `trigger-current --confirm --wait` 会自动做必要的 mirror pre/post flush，但 closeout 仍要确认最终 `pendingFlush=false`、`githubInSync=true`。如果 lower-level 手工路径或旧 job 留下 `pendingFlush=true`，执行 `git-mirror flush --confirm --wait` 到 `pendingFlush=false`。

-`trigger-current --node D601|D518|JD01 --lane v03 --confirm --wait` 的 source selection 必须走 k8s git-mirror source snapshot：confirmed trigger 先执行受控 `git-mirror sync`，sync 在 mirror cache 中为本轮 branch tip 创建不可变 `refs/unidesk/snapshots/hwlab-node-runtime/<branch>/<commit>`，随后 trigger/status/build 只读取该 snapshot ref 作为 authoritative source。旧 `source-render` / `local-git-clone-worktree` / 可变 branch ref 追 branch tip 的问题不得再用固定 worktree fetch/pull 修复。
+`trigger-current --node D601|D518|JD01 --lane v03 --confirm --wait` 的 source selection 必须走 YAML `sourceAuthority` 解析出的受控 source snapshot：legacy lane 先执行受控 `git-mirror sync`，在 mirror cache 中为本轮 branch tip 创建不可变 `refs/unidesk/snapshots/hwlab-node-runtime/<branch>/<commit>`；Gitea/PaC 迁移 lane 先执行受控 Gitea mirror sync，并读取 Gitea immutable snapshot ref。随后 trigger/status/build 只读取该 snapshot ref 作为 authoritative source。旧 `source-render` / `local-git-clone-worktree` / 可变 branch ref 追 branch tip 的问题不得再用固定 worktree fetch/pull 修复。

 node-scoped lane 可能在本次 PR 合并后又被后续 PR 推进。`control-plane status --pipeline-run <name>` 是定点观察某个 PipelineRun，但输出里的当前 `sourceHead` / `summary.sourceCommit` 可能已经是最新 branch tip。closeout 必须同时记录 PR merge commit、PipelineRun 名称/状态、Argo sync revision、当前 branch tip，并证明最新 tip 包含本次 PR。