docs: record D601 git mirror flush recovery

2026-06-16 06:02:34 +00:00
parent 6711b55515
commit 6f8fe9e098
2 changed files with 4 additions and 0 deletions
@@ -130,6 +130,8 @@ PipelineRun `gitops-promote` 如果报 git mirror 控制面漂移、refs 不一

 D601 `v0.3` 固定 worktree 的 fetch remote 是 node-local git mirror。GitHub PR 合并后，如果 `D601:/home/ubuntu/workspace/hwlab-v03` 中 `git fetch origin v0.3` 仍看不到最新 merge commit，先执行 `hwlab nodes git-mirror sync --node D601 --lane v03 --confirm --wait`，再在固定 worktree `git fetch origin v0.3 && git pull --ff-only origin v0.3`。`trigger-current --lane v03` 会为 PipelineRun 做 mirror pre-sync，但不替代固定 worktree 的 fetch hygiene。promotion 后若 node-local `git-mirror status` 显示 `pendingFlush=true`，执行 node-local flush 并等到 `pendingFlush=false`、`githubInSync=true`。

+D601/node-scoped mirror status 的 `githubGitops` 来自本地 mirror cache 的 `refs/mirror-stage/...`。如果 `hwlab nodes git-mirror flush --node D601 --lane v03 --confirm --wait` 的日志已经显示 `v0.3-gitops -> v0.3-gitops` 推送成功，但随后因 GitHub SSH `kex_exchange_identification` 或 fetch 确认失败导致命令 exit 44、status 仍显示 `pendingFlush=true`，不要连续盲目 flush；先执行 `hwlab nodes git-mirror sync --node D601 --lane v03 --confirm --wait` 刷新 mirror-stage，再用 status 确认 `localGitops=githubGitops`、`pendingFlush=false`、`githubInSync=true`。
+
 ---

 ## Secret 管理