事故经过(2026-09-22): 「提问指南」换地址那个提交推送后 CI 挂了, auto-deploy 回滚。 check.sh 报「没找到官网提问指南链接 / 仍有旧地址」—— 但脚本确实把部署克隆同步到了新 提交、语言文件也重新生成了。原来 deploy() 比较的是 build.py 运行【前后】的指纹: 那只能 发现语言文件被重新生成, 纯模板改动前后完全一样 → 从不重启 → 容器继续用启动时加载的旧 模板 → 断言失败 → 整个部署被判失败并回滚。也就是说: 任何只改模板的提交都必然挂 CI。 修法: 把指纹记在 deploy/.state/custom-hash 里, 与【上次成功部署】的指纹比较, 不同就 restart gitea(restart 而不是 up -d: compose 配置没变时 up -d 不重建容器)。rollback 路径 改成 deploy force 无条件重启 —— 失败的那次可能已经用新模板重启过容器, 回滚必须再重启 回去, 顺便也修好下面这个副作用。 顺带修一个 bind mount 的坑: 挂载【源目录】被「删掉再建」后容器里挂的还是旧 inode(空 目录)。这次事故里 public/ 下的文件被删光、git 顺手删掉空目录, 于是线上 /QA/assets/tjhlp/ask-guide.html 变成 404。已在预览上复现([B] 404 → restart 后 [C] 200), restart 会重新解析挂载, 所以上面的修法同时把它修好。 验证(不碰生产的沙箱, 假 docker + 桩 verify/check): 1 全新状态首次部署 → up -d + restart ✓ 2 什么都没改再部署 → 不重启 ✓ 3 只改一个模板文件 → 重启 ✓(这次的回归点) 4 之后再来一次 → 不重启 ✓ 5 check 失败 → 回滚 → checkout PREV + 强制 restart ✓, 状态文件不被污染 ✓ 另外 check.sh / preview.sh 的失败信息里加了「模板改动要重启才生效」的提示, 并把 ci-cd.md §5.2(脚本清单+为什么必须 restart)与 README §12 速查表同步更新。
按 deploy/ci-cd.md 方案把除推送触发之外的东西都准备好: - customization/check.sh <base-url>: 把 preview.sh check 里的"定制生效"断言抽成 任意实例可跑的脚本(首页/页脚/meta/官网链接/登录页两张卡/无通行密钥方框/ 无「工单」/无 example.com), 另加生产才有的 OIDC 入口 307 断言(404 = 认证源没注册上)。 实测对生产 17/17 通过。 - deploy/scripts/auto-deploy.sh: build.py -> compose up -d -> verify.sh + check.sh, 失败自动回滚到 deploy/.state/last-deployed; flock 串行; 结束时把 clone 所有权还给 ymy(job 容器里是 root); 内网验证强制不走代理。 - deploy/runner/{compose.yaml,config.yaml,.env.example}: act_runner v0.6.1 跑在容器里 (不需要 root), network: host + 同路径挂载部署克隆 + 宿主 docker CLI/compose 插件, capacity 1 保证部署串行。 - .gitea/workflows/deploy.yml: push main + workflow_dispatch, [skip deploy] 跳过, concurrency 串行, 只做"同步到 github.sha + 调 auto-deploy.sh"。 - .gitignore: deploy/.state/、deploy/runner/{.env,data/}。 依据见 deploy/ci-cd.md(含全部实测证据与待确认项)。