SHA256
deploy / deploy (push) Successful in 11s
事故经过(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 速查表同步更新。
132 lines
6.1 KiB
Bash
Executable File
132 lines
6.1 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
# 定制生效断言 —— 对任意实例跑一遍, 预览与生产共用。
|
||
# 用法:
|
||
# customization/check.sh http://127.0.0.1:2081 # 预览
|
||
# customization/check.sh https://cpp.tongji.sh/QA # 生产(CI 里也调这个)
|
||
#
|
||
# 退出码: 0 全通过 / 1 有断言失败 / 2 用法错误。
|
||
# 只读: 只发 GET, 不改任何东西。
|
||
set -uo pipefail
|
||
|
||
BASE_URL="${1:-}"
|
||
if [[ -z ${BASE_URL} ]]; then
|
||
sed -n '2,9p' "$0"
|
||
exit 2
|
||
fi
|
||
BASE_URL="${BASE_URL%/}"
|
||
ORIGIN="$(printf '%s' "${BASE_URL}" | sed -E 's#(^https?://[^/]+).*#\1#')"
|
||
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||
|
||
fail=0
|
||
ok() { printf ' ✓ %s\n' "$1"; }
|
||
bad() {
|
||
printf ' ✗ %s\n' "$1"
|
||
fail=1
|
||
}
|
||
skip() { printf ' – %s\n' "$1"; }
|
||
|
||
tmp="$(mktemp -d)"
|
||
trap 'rm -rf "${tmp}"' EXIT
|
||
# --noproxy: 验证目标都在内网, 走代理只会把 200 变成 502(见 deploy/README.md 陷阱 5)
|
||
curl_() { curl -sS --noproxy '*' --max-time 20 "$@"; }
|
||
|
||
echo "== 定制检查 ${BASE_URL} =="
|
||
|
||
# --- 首页 -------------------------------------------------------------------
|
||
if ! curl_ -fsS -H 'Accept-Language: zh-CN' "${BASE_URL}/" -o "${tmp}/home.html"; then
|
||
echo " ✗ 首页打不开(HTTP 非 2xx), 后面不再检查"
|
||
exit 1
|
||
fi
|
||
ok "首页可访问"
|
||
|
||
grep -q "先搜索,再提问" "${tmp}/home.html" &&
|
||
ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容"
|
||
grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${tmp}/home.html" &&
|
||
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" &&
|
||
ok "页脚已无 Powered by Gitea" || bad "页脚仍有 Powered by"
|
||
! grep -q "docs.gitea.com" "${tmp}/home.html" &&
|
||
ok "页面已无 docs.gitea.com 外链" || bad "仍有 docs.gitea.com 外链"
|
||
grep -q 'name="description" content="同济大学高级语言程序设计课程答疑平台"' "${tmp}/home.html" &&
|
||
ok "meta description 已替换" || bad "meta description 未替换"
|
||
|
||
# --- 与课程官网的联动 -------------------------------------------------------
|
||
grep -q "https://cpp.tongji.sh/Website/" "${tmp}/home.html" &&
|
||
ok "首页/导航栏已链接课程官网" || bad "首页没有课程官网链接"
|
||
grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${tmp}/home.html" &&
|
||
ok "首页已链接官网提问指南" || bad "首页没有官网提问指南链接"
|
||
! grep -q "Website/ask-question/\|Website/faq/\|Website/contact\"" "${tmp}/home.html" &&
|
||
ok "没有指向官网已迁移/失效的旧地址" ||
|
||
bad "仍有旧地址(ask-question / faq / contact 无 .html)"
|
||
# 站内提问指南页已按决定删除: 提问指南只在官网保留一份
|
||
if curl_ -fsS -o /dev/null "${BASE_URL}/assets/tjhlp/ask-guide.html" 2>/dev/null; then
|
||
bad "平台内还留着 ask-guide.html(提问指南应只在官网)"
|
||
else
|
||
ok "平台内提问指南页已删除"
|
||
fi
|
||
|
||
# --- 中文术语与登录页 -------------------------------------------------------
|
||
if curl_ -fsS -H 'Accept-Language: zh-CN' "${BASE_URL}/user/login" -o "${tmp}/login.html"; then
|
||
ok "登录页可访问"
|
||
grep -q "管理员登录" "${tmp}/login.html" &&
|
||
ok "登录页有独立的「管理员登录」卡片" || bad "登录页缺少管理员登录卡片"
|
||
! grep -q "webauthn-error\|signin-passkey" "${tmp}/login.html" &&
|
||
ok "登录页已无空的通行密钥(WebAuthn)方框" || bad "登录页仍有通行密钥区块"
|
||
# OIDC 入口: 配了认证源的实例才会渲染 external-login-navigator
|
||
if grep -q 'id="external-login-navigator"' "${tmp}/login.html"; then
|
||
href="$(grep -o 'href="[^"]*/user/oauth2/[^"]*"' "${tmp}/login.html" | head -1 |
|
||
sed -E 's/^href="//; s/"$//')"
|
||
if [[ -z ${href} ]]; then
|
||
bad "登录页有认证源区块但没解析出 OAuth2 链接"
|
||
else
|
||
code="$(curl_ -o /dev/null -w '%{http_code}' "${ORIGIN}${href}")"
|
||
# 307 = 认证源注册成功并跳转统一身份认证; 404 = 认证源没注册上(见 README 陷阱 6)
|
||
[[ ${code} == 307 ]] &&
|
||
ok "OIDC 入口 ${href} 返回 307(跳转统一身份认证)" ||
|
||
bad "OIDC 入口返回 ${code}, 期望 307(404 = 认证源没注册上)"
|
||
fi
|
||
else
|
||
skip "该实例未配置认证源, 跳过 OIDC 入口检查(预览实例属此情况)"
|
||
fi
|
||
else
|
||
bad "登录页打不开"
|
||
fi
|
||
|
||
# 术语: 中文界面里不该再出现「工单」
|
||
if curl_ -fsS -H 'Accept-Language: zh-CN' -o "${tmp}/issues.html" \
|
||
"${BASE_URL}/course-team/tjhlp-gitea/issues"; then
|
||
! grep -q "工单" "${tmp}/issues.html" &&
|
||
ok "Issue 列表页中文界面已无「工单」" || bad "Issue 列表页仍有「工单」"
|
||
else
|
||
skip "读不到 issue 列表页(需要登录?), 跳过「工单」检查"
|
||
fi
|
||
|
||
# --- 仓库内文件(在 checkout 里跑时才有意义) --------------------------------
|
||
if [[ -d ${ROOT}/issue-templates ]]; then
|
||
! grep -rq "example.com" "${ROOT}/issue-templates/" &&
|
||
ok "Issue 模板已无 example.com 占位链接" || bad "Issue 模板里仍有 example.com"
|
||
fi
|
||
if [[ -f ${ROOT}/customization/custom/options/locale/locale_zh-CN.json ]]; then
|
||
! grep -q "工单" "${ROOT}/customization/custom/options/locale/locale_zh-CN.json" &&
|
||
ok "生成的 zh-CN 语言文件已无「工单」" || bad "语言文件里仍有「工单」"
|
||
fi
|
||
# 首页(登录后)的学期答疑入口卡片: 渲染结果需要登录才能看, 这里只断言模板层
|
||
# (运行时的渲染断言在 customization/preview/preview.sh check 里, 要登录)。
|
||
if [[ -f ${ROOT}/customization/custom/templates/custom/tjhlp_semester_card.tmpl ]]; then
|
||
grep -q "本学期答疑入口" "${ROOT}/customization/custom/templates/custom/tjhlp_semester_card.tmpl" &&
|
||
ok "首页答疑入口卡片模板在位" || bad "卡片模板里没有预期的内容"
|
||
grep -q 'template "custom/tjhlp_semester_card"' \
|
||
"${ROOT}/customization/custom/templates/user/dashboard/dashboard.tmpl" &&
|
||
ok "dashboard.tmpl 已 include 学期答疑入口卡片" || bad "dashboard.tmpl 没有 include 卡片"
|
||
fi
|
||
|
||
if [[ ${fail} == 0 ]]; then
|
||
echo "全部检查通过"
|
||
else
|
||
echo "存在检查未通过项"
|
||
fi
|
||
exit "${fail}"
|