From 53116f7a23797be6f67db69822ac196633ae0c02bde3e133cf957ac61bee16d4 Mon Sep 17 00:00:00 2001 From: Maoayo233 Date: Wed, 23 Sep 2026 01:52:58 +0800 Subject: [PATCH] =?UTF-8?q?fix(ci):=20=E9=83=A8=E7=BD=B2=E6=97=B6=E5=BF=85?= =?UTF-8?q?=E9=A1=BB=E9=87=8D=E5=90=AF=20gitea=20=E2=80=94=E2=80=94=20?= =?UTF-8?q?=E6=8C=87=E7=BA=B9=E8=A6=81=E4=B8=8E=E4=B8=8A=E6=AC=A1=E6=88=90?= =?UTF-8?q?=E5=8A=9F=E9=83=A8=E7=BD=B2=E6=AF=94,=20=E8=80=8C=E4=B8=8D?= =?UTF-8?q?=E6=98=AF=20build.py=20=E5=89=8D=E5=90=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 事故经过(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 速查表同步更新。 --- customization/check.sh | 3 ++- customization/preview/preview.sh | 3 ++- deploy/README.md | 2 ++ deploy/ci-cd.md | 29 +++++++++++++++++++++++-- deploy/scripts/auto-deploy.sh | 37 ++++++++++++++++++++++++-------- 5 files changed, 61 insertions(+), 13 deletions(-) diff --git a/customization/check.sh b/customization/check.sh index 6111464..0e8ed07 100755 --- a/customization/check.sh +++ b/customization/check.sh @@ -42,7 +42,8 @@ ok "首页可访问" grep -q "先搜索,再提问" "${tmp}/home.html" && ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容" grep -q "http://10.80.42.185/Website/qa/ask/" "${tmp}/home.html" && - ok "导航栏/首页已指向官网提问指南(/Website/qa/ask/)" || bad "没找到官网提问指南链接" + ok "导航栏/首页已指向官网提问指南(/Website/qa/ask/)" || + bad "没找到官网提问指南链接(页面还是旧模板? 模板改动要重启 gitea 才生效)" ! grep -q "painless\|极易搭建\|Easy to install\|Cross-platform" "${tmp}/home.html" && ok "首页已无 Gitea 功能介绍" || bad "首页仍有 Gitea 功能介绍文案" ! grep -qi "powered by" "${tmp}/home.html" && diff --git a/customization/preview/preview.sh b/customization/preview/preview.sh index 3f18f0e..db95a9d 100755 --- a/customization/preview/preview.sh +++ b/customization/preview/preview.sh @@ -127,7 +127,8 @@ check) grep -q "先搜索,再提问" "${html}" && ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容" grep -q "http://10.80.42.185/Website/qa/ask/" "${html}" && - ok "导航栏/首页已指向官网提问指南(/Website/qa/ask/)" || bad "没找到官网提问指南链接" + ok "导航栏/首页已指向官网提问指南(/Website/qa/ask/)" || + bad "没找到官网提问指南链接(页面还是旧模板? 模板改动要重启 gitea 才生效)" ! grep -q "painless\|极易搭建\|Easy to install\|Cross-platform" "${html}" && ok "首页已无 Gitea 功能介绍" || bad "首页仍有 Gitea 功能介绍文案" ! grep -qi "powered by" "${html}" && ok "页脚已无 Powered by Gitea" || bad "页脚仍有 Powered by" diff --git a/deploy/README.md b/deploy/README.md index 5464e50..6e373dd 100644 --- a/deploy/README.md +++ b/deploy/README.md @@ -816,6 +816,8 @@ if SecretKey == "" { | `docker build` 报 `lookup auth.docker.io ... i/o timeout` | §4.3 | 先 `docker pull` 基础镜像 | | `docker pull` 报 `i/o timeout` | §4.3 | 代理 drop-in 没生效, `systemctl show docker -p Environment` | | 容器 healthy 但站点 503 | `docker compose logs gitea` | 多为 `.env` 里 DB 密码与既有数据不一致 | +| CI 部署"成功"但页面还是旧模板 / 部署回滚 | `ci-cd.md` §5.2 | `custom/` 变了却没重启容器(或挂载源目录被换过 inode), 见该节说明 | +| `/QA/assets/...` 下自己放的静态文件 404 | — | 挂载的 `custom/public` 目录被删除重建过, `docker compose restart gitea` 重新挂载 | --- diff --git a/deploy/ci-cd.md b/deploy/ci-cd.md index 1dce65b..15805a5 100644 --- a/deploy/ci-cd.md +++ b/deploy/ci-cd.md @@ -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` 只记可执行位)。 diff --git a/deploy/scripts/auto-deploy.sh b/deploy/scripts/auto-deploy.sh index f7acffb..7c40cf9 100755 --- a/deploy/scripts/auto-deploy.sh +++ b/deploy/scripts/auto-deploy.sh @@ -4,14 +4,17 @@ # ./auto-deploy.sh # 部署当前 checkout # ./auto-deploy.sh # 部署指定提交 # -# 流程: build.py(生成+校验) → docker compose up -d → 验证(verify.sh + check.sh) -# 任一步失败 → 回滚到 deploy/.state/last-deployed 记录的上一个成功提交。 +# 流程: build.py(生成+校验) → docker compose up -d → custom/ 与上次成功部署的指纹不同 +# 就重启 gitea(模板/语言文件是启动时加载的) → 验证(verify.sh + check.sh) +# → 成功则记下 .state/{last-deployed,custom-hash} +# 任一步失败 → 回滚到 deploy/.state/last-deployed 记录的上一个成功提交并强制重启。 # 只动代码与挂载文件; 数据库/`.env`/备份目录全程不参与(见 deploy/ci-cd.md §6)。 set -euo pipefail REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)" STATE_DIR="${REPO_DIR}/deploy/.state" STATE_FILE="${STATE_DIR}/last-deployed" +HASH_FILE="${STATE_DIR}/custom-hash" # 上次成功部署时 customization/custom/ 的指纹 PUBLIC_URL="${GITEA_PUBLIC_URL:-http://10.80.42.185/QA}" # 本机/内网回环验证不能走代理, 否则会把 200 变成 502(见 deploy/README.md 陷阱 5) @@ -65,7 +68,11 @@ cd "${REPO_DIR}" # customization/custom/ 的指纹: 模板、静态页、生成的语言文件都在里面。 # 这些是 Gitea 启动时加载的, 变了必须重启容器才生效(README §3), 而 `compose up -d` -# 只在 compose 配置变化时才重建 —— 所以这里自己比指纹, 变了就 restart。 +# 只在 compose 配置变化时才重建容器 —— 所以自己比指纹, 变了就 restart。 +# ⚠️ 比的是【与上次成功部署的指纹】(.state/custom-hash), 不是 build.py 前后: +# 后者只能发现语言文件被重新生成, 纯模板改动前后完全一样 → 永远不重启 → 容器继续 +# 用启动时加载的旧模板 → check.sh 断言失败 → 整个部署回滚。2026-09-22 实际踩到 +# (「提问指南」换地址那个提交就这么被回滚了)。 custom_hash() { (cd customization/custom && find . -type f -exec sha256sum {} + | sort | sha256sum | cut -d' ' -f1) } @@ -92,16 +99,27 @@ prepare_custom_dirs() { } deploy() { - local before after + local force="${1:-}" now last prepare_custom_dirs || return 1 - before="$(custom_hash)" "${PY}" customization/build.py || return 1 # 生成语言文件 + 规范 custom/ 权限 "${PY}" customization/build.py --check || return 1 # 生成物/权限校验, 不过就中止, 不碰容器 - after="$(custom_hash)" + now="$(custom_hash)" (cd deploy && docker compose up -d) || return 1 # 幂等: 只有配置/挂载/镜像变化时才重建 - if [[ ${before} != "${after}" ]]; then - echo "[auto-deploy] custom/ 有变化(模板/静态页/语言文件), 重启 gitea 使其生效" + last="$(cat "${HASH_FILE}" 2>/dev/null || true)" + if [[ -n ${force} || ${now} != "${last}" ]]; then + if [[ -n ${force} ]]; then + echo "[auto-deploy] 回滚路径: 重启 gitea, 让回退后的模板/语言文件生效" + else + echo "[auto-deploy] custom/ 与上次成功部署不同, 重启 gitea 使模板/语言文件生效" + fi + # 用 restart 而不是 up -d: compose 配置没变时 up -d 不重建容器, 而模板/语言文件 + # 是启动时加载的。restart 还会【重新解析 bind mount】—— 挂载源目录被「删掉再建」 + # (例如某个提交把 public/ 下的文件删光了, git 会顺手删掉空目录)之后, 容器里 + # 仍然挂着旧 inode(一个空目录), 只有重新 start 才会挂到新目录上。 + # 2026-09-22 实际踩到: 线上 /QA/assets/tjhlp/ask-guide.html 变成 404。 (cd deploy && docker compose restart gitea) || return 1 + else + echo "[auto-deploy] custom/ 与上次成功部署一致, 不重启" fi } @@ -124,7 +142,7 @@ rollback() { # -f: 旧版本里可能没有 deploy/runner/* 这类文件, 它们在新版本是"未跟踪文件", # 会挡住普通 checkout(实测), 这里直接覆盖 git checkout -f --detach "${PREV}" - deploy || true + deploy force || true # force: 失败的那次可能已经用新模板重启过容器, 必须再重启回去 verify || true } @@ -133,6 +151,7 @@ pipeline() { deploy && verify; } if pipeline; then echo "${TARGET}" >"${STATE_FILE}" + custom_hash >"${HASH_FILE}" # 记下本次成功部署的 custom/ 指纹, 供下次比较 echo "[auto-deploy] ✅ 部署成功 ${TARGET}" else echo "[auto-deploy] ❌ 部署或验证失败, 开始回滚"