Skip to content

docs: 更正 Pages 迁移的操作顺序 - #23

Merged
Leaderxin merged 1 commit into
masterfrom
docs/website-pages-notes
Oct 10, 2026
Merged

Leaderxin merged 1 commit into
masterfrom
docs/website-pages-notes

Conversation

@Leaderxin

Copy link
Copy Markdown
Owner

补 #22 合并后才暴露出来的一段。

CLAUDE.md 里原本写的迁移顺序是「先合并、再切 build_type、然后立刻触发部署」,实际照做会踩一次竞态:push 到 master 会同时触发两条路 —— build_type 还是 legacy 时 GitHub 用自己的构建器从 master:/docs 出一版,工作流也提交一版部署,谁后落地谁赢。

实测结果:

07:22:54  push 到 master → legacy 构建启动
07:23:13  Actions 部署报成功
07:23:16  legacy 构建完成(22s)—— 晚 3 秒,赢了

症状很有迷惑性:deploy job 报绿、pages/builds/latest 也是一条成功的构建,但站点内容仍是旧的。当时排查了 9 分钟才排除掉 CDN 缓存这个可能。

正确顺序是切完 build_type 之后再手动跑一次 gh workflow run pages.yml(此后不会再有新的 legacy 构建,跑一次就站住)。文档里补了症状与排查入口(gh api repos/{owner}/{repo}/pages/builds/latest 看 commit 是不是刚推的那个)。

纯文档修正,不动代码。

原文写的「先合并、再切 build_type、然后触发部署」是错的,照做会踩一次
竞态:push 到 master 会同时触发 legacy 构建(从 master:/docs 出,因为那时
build_type 还是 legacy)与工作流的部署,谁后落地谁赢。实测 legacy 那次晚
3 秒完成,把 Actions 的部署盖掉了 —— 症状是 deploy job 报绿但站点内容没变。

真实顺序是:切完 build_type 之后再手动跑一次 gh workflow run pages.yml。
@Leaderxin
Leaderxin merged commit 4f72d45 into master Oct 10, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant