SHA256
事故经过(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 速查表同步更新。
This commit is contained in:
+27
-2
@@ -371,6 +371,7 @@ export no_proxy='*' NO_PROXY='*'
|
||||
mkdir -p "$STATE_DIR"
|
||||
TARGET=${1:-$(git -C "$REPO_DIR" rev-parse HEAD)}
|
||||
PREV=$(cat "$STATE_FILE" 2>/dev/null || true)
|
||||
HASH_FILE="${STATE_DIR}/custom-hash" # 上次成功部署时 custom/ 的指纹
|
||||
|
||||
exec 9>"${STATE_DIR}/lock" # workflow 的 concurrency 之外再加一道
|
||||
flock -n 9 || { echo "[auto-deploy] 已有部署在跑, 退出"; exit 0; }
|
||||
@@ -378,10 +379,20 @@ flock -n 9 || { echo "[auto-deploy] 已有部署在跑, 退出"; exit 0; }
|
||||
echo "[auto-deploy] 目标 ${TARGET} (上次成功: ${PREV:-无})"
|
||||
cd "$REPO_DIR"
|
||||
|
||||
deploy() {
|
||||
# customization/custom/ 的指纹: 模板、静态页、生成的语言文件都在里面, 都是启动时加载的
|
||||
custom_hash() {
|
||||
(cd customization/custom && find . -type f -exec sha256sum {} + | sort | sha256sum | cut -d' ' -f1)
|
||||
}
|
||||
|
||||
deploy() { # deploy force = 无条件重启(回滚路径用)
|
||||
python3 customization/build.py # 生成语言文件 + 规范 custom/ 权限(容器用户要能读)
|
||||
python3 customization/build.py --check # 生成物/权限校验, 不过就中止, 不碰容器
|
||||
( cd deploy && docker compose up -d ) # 幂等: 只有配置/镜像变化时才重建
|
||||
# ★ 必须和【上次成功部署的指纹】比, 不能只比 build.py 前后 —— 后者只能发现语言
|
||||
# 文件变化, 纯模板改动前后一模一样, 于是永远不重启、容器继续用旧模板(详见下方说明)
|
||||
if [[ -n "${1:-}" || $(custom_hash) != "$(cat "$HASH_FILE" 2>/dev/null)" ]]; then
|
||||
( cd deploy && docker compose restart gitea )
|
||||
fi
|
||||
}
|
||||
|
||||
verify() {
|
||||
@@ -393,12 +404,13 @@ rollback() {
|
||||
[[ -z "${PREV}" ]] && { echo "[auto-deploy] 无历史版本可回退, 保持现状"; return 0; }
|
||||
echo "[auto-deploy] 回滚到 ${PREV}"
|
||||
git checkout --detach "$PREV"
|
||||
deploy || true
|
||||
deploy force || true # 强制重启: 失败那次可能已用新模板重启过容器
|
||||
verify || true
|
||||
}
|
||||
|
||||
if deploy && verify; then
|
||||
echo "$TARGET" > "$STATE_FILE"
|
||||
custom_hash > "$HASH_FILE" # 记下这次成功部署的指纹, 供下次比较
|
||||
echo "[auto-deploy] ✅ 部署成功 ${TARGET}"
|
||||
else
|
||||
echo "[auto-deploy] ❌ 部署或验证失败, 开始回滚"
|
||||
@@ -407,6 +419,19 @@ else
|
||||
fi
|
||||
```
|
||||
|
||||
> **为什么非要 `restart`(2026-09-22 踩到的坑)**:模板与语言文件是 Gitea **启动时**加载的,
|
||||
> 而 `docker compose up -d` 在 compose 配置没变时**不会重建容器**。最早的实现比较的是
|
||||
> `build.py` 运行前后的指纹——那只会在语言文件被重新生成时才变;**纯模板改动**(改文案、
|
||||
> 换链接)前后完全一样,于是从不重启,容器继续用旧模板,`check.sh` 断言失败 → 整个部署
|
||||
> 被判失败并回滚(「提问指南」换地址那个提交就是这样被回滚的)。改成把指纹记在
|
||||
> `.state/custom-hash` 里、与**上次成功部署**比较后,模板改动会触发重启。
|
||||
>
|
||||
> `restart` 还顺带修一个 bind mount 的坑:挂载**源目录**被「删掉再建」(例如某个提交把
|
||||
> `custom/public/` 下的文件删光了,git 顺手删掉空目录)后,容器里挂的仍是**旧 inode**,
|
||||
> 看到的是一个空目录——只有重新 start 才会解析到新目录。同一次事故里线上的
|
||||
> `/QA/assets/tjhlp/ask-guide.html` 就是这么变成 404 的(已在预览上复现并验证 restart 能修)。
|
||||
> CI 若只更新了文档/脚本(`custom/` 没动),指纹相同则不重启,省掉一次无谓的停机。
|
||||
|
||||
落库前的两个小动作:`.gitignore` 加 `deploy/.state/`、`deploy/runner/data/`、
|
||||
`deploy/runner/.env`;给 `auto-deploy.sh` 加可执行位(`git` 只记可执行位)。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user