diff --git a/scripts/deploy-approved-commits.txt b/scripts/deploy-approved-commits.txt index bf9ce5e..6bcd093 100644 --- a/scripts/deploy-approved-commits.txt +++ b/scripts/deploy-approved-commits.txt @@ -9,3 +9,13 @@ b8f7ddb53ce056a1ac86468a8e9a7557c71922f0 c57f557ab8d126c7ef031e63402abaa1f6602155 aaeaf2b7ec9304b851089cbe64ddda0a5916d99f a2be088cba59c95901b22d855dea9b6df3bf3a80 +# t_debe2002 AC3 补档(2026-10-19):修正窗口算法后真实未评审区间 = a2be088c..HEAD 的 4 条源码提交(逐条归因): +# 5a5d22aa ← t_5d28ad74 已 done(且为当前 HEAD,其代码即已上线二进制 b91b75d8 的构建源) +# 0fa2f25d ← t_7ba5e479 已 done(并已确认出现在抢救二进制 predeploy-014059 的 vcs.revision=0fa2f25d) +# 71a591ba ← t_789898bd 已 done +# d21258ba ← t_7c0538eb 已 done +# 第 5 条 f3b004b8(仅改本清单文件的部署卫生提交)由 AC2 选项① 自动放行,无需人工打点。 +5a5d22aa9b9efde2459905057daa37e13c7e093a +0fa2f25d0d8f201e079ae13f986f554effb5c45e +71a591baa43923792db0551867ac6c8d3d7633c2 +d21258ba0c130b4ea93cab8891fab586866c2517 diff --git a/scripts/deploy.sh b/scripts/deploy.sh index 83850e2..f1fd34e 100755 --- a/scripts/deploy.sh +++ b/scripts/deploy.sh @@ -22,10 +22,13 @@ ALLOW_DIRTY=0 ALLOW_UNREVIEWED=0 # --mark-approved:把当前 HEAD 记录为「已批准部署基线」(评审通过后手动打点,独立动作,不构建) MARK_APPROVED=0 +# --verify:只校验「运行二进制 sha ∈ 部署清单」的自证版本(AC8 选项3,独立动作,不构建/不安装/不重启) +VERIFY_MANIFEST=0 for _a in "$@"; do [ "$_a" = "--allow-dirty" ] && ALLOW_DIRTY=1 [ "$_a" = "--allow-unreviewed" ] && ALLOW_UNREVIEWED=1 [ "$_a" = "--mark-approved" ] && MARK_APPROVED=1 + [ "$_a" = "--verify" ] && VERIFY_MANIFEST=1 done # 构建产物(持久路径,均已 gitignore) @@ -41,6 +44,12 @@ HEALTH_URL="${HEALTH_URL:-http://127.0.0.1:7821/health}" # 已批准部署清单文件(**tracked**,审批历史进 git,落盘可审): # 每行一个「评审通过」的 commit SHA,追加式。见 preflight_reviewed_commits —— 部署夹带闸门的比对基准。 APPROVED_FILE="$REPO_DIR/scripts/deploy-approved-commits.txt" +# t_debe2002 AC8 选项3:部署清单 —— 记录每次安装的 二进制 sha ↔ commit,使已上线二进制可自证版本。 +# 背景:linked worktree 构建时 Go 不写 vcs.revision(AC8 根因),仅靠 vcs stamp 无法反查进程跑的 commit; +# 清单在 install 时记录 sha↔HEAD,verify 时用「当前运行 sha 能在清单里查到对应 commit」自证版本。 +# 位置 ~/.hermes/state/(持久,非 git tracked;append-only,裁剪到最近 MANIFEST_MAX_LINES 条)。 +MANIFEST_FILE="$HOME/.hermes/state/zhiyi-deploy-manifest.jsonl" +MANIFEST_MAX_LINES=200 log() { printf '\033[1;34m[deploy]\033[0m %s\n' "$*"; } die() { printf '\033[1;31m[deploy:FAIL]\033[0m %s\n' "$*" >&2; exit 1; } @@ -90,7 +99,13 @@ preflight_clean_tree() { return 0 fi local dirty - dirty="$(git -C "$REPO_DIR" status --porcelain 2>/dev/null || true)" + # t_debe2002 AC2:把批准清单文件从「洁净判据」里排除 —— --mark-approved 会往它追加一行, + # 若计入洁净检查,追加后工作树即脏 → 下一次构建被自己拦下 → 正规流程永远跑不通(结构性死锁)。 + # 该文件是「部署台账」非「生产代码」,其改动不会编进二进制,故不参与洁净判据。 + # 注意:`|| true` 必须放在子括号里 —— `a || b | c` 的 `|` 优先于 `||`,解析成 `a || (b | c)`, + # 当 a 成功时 grep 分支不执行 ⇒ 输出未过滤(t_debe2002 实测)。写成 `(a || true) | c` 才让 grep 作用于 a 的输出。 + # 再注意:grep -v 匹配不到行时退出码=1,在 $() 里会把非零退出码带给赋值 ⇒ set -e 误杀;末尾再挂 `|| true` 兜底。 + dirty="$( ( git -C "$REPO_DIR" status --porcelain 2>/dev/null || true ) | grep -v '^ M scripts/deploy-approved-commits.txt$' || true )" if [ -n "$dirty" ]; then printf '%s\n' "$dirty" | sed 's/^/ /' >&2 die "工作树不洁净 → 拒绝构建(会把在途改动编进生产二进制,部署后校验和仍会通过,无法事后察觉)。 @@ -115,7 +130,11 @@ preflight_reviewed_commits() { head="$(git -C "$REPO_DIR" rev-parse HEAD 2>/dev/null || true)" [ -n "$head" ] || die "无法解析 HEAD($REPO_DIR 不是有效 git 仓库?)" if [ ! -f "$APPROVED_FILE" ]; then - die "无已批准部署清单($APPROVED_FILE 不存在)→ 拒绝构建。\n 处置:① 先 `./scripts/deploy.sh --mark-approved` 把当前 HEAD 追加进批准清单(评审通过后打点);\n ② 确需跳过请显式加 --allow-unreviewed 并在卡上记录原因。" + # t_debe2002 AC6: 反引号在双引号内会被 bash 当命令替换执行 ⇒ die 消息里的命令示例被真实执行。 + # 改为单引号 + printf '%s' 传参(die 内部 printf 单引号参数不会执行反引号)。下同。 + die '无已批准部署清单('"$APPROVED_FILE"' 不存在)→ 拒绝构建。 + 处置:① 先 ./scripts/deploy.sh --mark-approved 把当前 HEAD 追加进批准清单(评审通过后打点); + ② 确需跳过请显式加 --allow-unreviewed 并在卡上记录原因。' fi approved="$(sed -e 's/[[:space:]]*#.*$//' -e '/^[[:space:]]*$/d' "$APPROVED_FILE")" [ -n "$approved" ] || die "已批准部署清单为空:$APPROVED_FILE" @@ -125,9 +144,17 @@ preflight_reviewed_commits() { [ -n "$a" ] && git -C "$REPO_DIR" cat-file -e "$a^{commit}" 2>/dev/null || echo "$a" done)" [ -z "$bad" ] || die "批准清单含仓库中不存在的 commit:$(printf '%s\n' "$bad" | tr '\n' ' ')\n 可能被 reset/rebase 抹掉 → 拒绝构建,需人工复核批准清单。" - # 构建范围 = HEAD 相对清单中一个已批准**祖先**提交的推进量(取列表序首祖先,窗口偏保守=安全) - latest="$(printf '%s\n' "$approved" | while read -r a; do - git -C "$REPO_DIR" merge-base --is-ancestor "$a" "$head" 2>/dev/null && { echo "$a"; break; } + # 构建范围 = HEAD 相对清单中「最新」的已批准**祖先**提交的推进量。 + # 原缺陷(t_debe2002 AC1/AC3):取「列表序首」祖先 = 清单里最老那条(600fb2f)⇒ + # git rev-list 最老祖先..HEAD 窗口暴增至全量(实测 22 条),把已批准的中间提交也误判为未评审(18 条)。 + # 修正:用 `git rev-list HEAD`(从 HEAD 起逆向)逐条比对,取「第一个」落在批准清单里的提交 = 最新已批准祖先; + # 若 HEAD 本身已在清单 ⇒ 直接命中 HEAD ⇒ 窗口为空 ⇒ 通过(天然满足「排除 HEAD 自身」)。 + # 注意:rev-list 输出先存变量再 while 迭代 —— 若直接 `git rev-list | while ...; break`, + # break 会关掉管道上游 ⇒ git 收 SIGPIPE ⇒ set -o pipefail 下整个管道返非零 ⇒ 误杀脚本(t_debe2002 实测 exit=141)。 + local revlog + revlog="$(git -C "$REPO_DIR" rev-list "$head" 2>/dev/null || true)" + latest="$(printf '%s\n' "$revlog" | while read -r c; do + printf '%s\n' "$approved" | grep -qx "$c" && { echo "$c"; break; } done)" if [ -z "$latest" ]; then # 没有任何批准提交是 HEAD 的祖先 ⇒ HEAD 之前全是未评审 ⇒ 除非 HEAD 恰在某批准提交上 @@ -144,6 +171,16 @@ preflight_reviewed_commits() { unreviewed="$(printf '%s\n' "$unreviewed" | while read -r c; do printf '%s\n' "$approved" | grep -qx "$c" || echo "$c" done | sed '/^$/d')" + # t_debe2002 AC2 选项①:自动放行「只改批准清单文件的部署卫生提交」—— + # 变更集 ⊆ {scripts/deploy-approved-commits.txt} 的提交(如 --mark-approved 结果被 commit), + # 视作部署卫生操作,不要求人工评审(它不改变任何生产代码)。 + unreviewed="$(printf '%s\n' "$unreviewed" | while read -r c; do + [ -n "$c" ] || continue + chg="$(git -C "$REPO_DIR" show --name-only --pretty=format: "$c" 2>/dev/null | sed '/^$/d')" + if [ -z "$chg" ] || printf '%s\n' "$chg" | grep -qvx 'scripts/deploy-approved-commits.txt'; then + echo "$c" + fi + done | sed '/^$/d')" if [ -z "$unreviewed" ]; then log "✔ 评审夹带检查通过(HEAD 范围内提交均已在批准清单内)" return 0 @@ -151,7 +188,9 @@ preflight_reviewed_commits() { n="$(printf '%s\n' "$unreviewed" | wc -l | tr -d ' ')" echo "⚠️ 构建范围含 $n 个**未评审**提交(不在已批准部署清单 $APPROVED_FILE 内):" >&2 printf '%s\n' "$unreviewed" | sed 's/^/ /' >&2 - die "拒绝构建:构建范围夹带未评审提交。\n 处置:① 先评审这批提交,再 `./scripts/deploy.sh --mark-approved` 把 HEAD 追加进批准清单;\n ② 确需带未评审提交部署则显式加 --allow-unreviewed 并在卡上记录原因。" + die '拒绝构建:构建范围夹带未评审提交。 + 处置:① 先评审这批提交,再 ./scripts/deploy.sh --mark-approved 把 HEAD 追加进批准清单; + ② 确需带未评审提交部署则显式加 --allow-unreviewed 并在卡上记录原因。' } do_build() { @@ -177,6 +216,7 @@ do_install() { systemctl --user start "$SVC_GO" systemctl --user start "$SVC_RUST" sleep 2 + write_manifest } # bi-temporal e2e 闸门(2026-10-14 加): @@ -210,15 +250,61 @@ verify_e2e_bitemporal() { log "✔ bi-temporal e2e 闸门通过(三列经真实 LanceDB 写→读回 完整往返)" } +# t_debe2002 AC8 选项3:部署清单 write/verify —— 见 MANIFEST_FILE 常量注释。 +# 格式(tab 分隔 jsonl):ts \t go_binary_sha256 \t git_HEAD \t dirty \t builder +# 写入时机:do_install 末尾(已 install 完 + 服务已起,$INSTALL_GO 即本次部署二进制)。 +# 校验时机:--verify 独立动作 + do_verify 全量路径末尾。 +write_manifest() { + local ts sha head dirty builder + ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)" + sha="$(sha256sum "$INSTALL_GO" 2>/dev/null | awk '{print $1}')" + head="$(git -C "$REPO_DIR" rev-parse HEAD 2>/dev/null || echo unknown)" + dirty="$( ( git -C "$REPO_DIR" status --porcelain 2>/dev/null || true ) | grep -v '^ M scripts/deploy-approved-commits.txt$' || true )" + [ -z "$dirty" ] && dirty="clean" || dirty="dirty" + builder="${BUILD_REASON:-deploy.sh}" + mkdir -p "$(dirname "$MANIFEST_FILE")" + printf '%s\t%s\t%s\t%s\t%s\n' "$ts" "$sha" "$head" "$dirty" "$builder" >> "$MANIFEST_FILE" + # append-only 台账,裁剪到最近 MANIFEST_MAX_LINES 条 + tail -n "$MANIFEST_MAX_LINES" "$MANIFEST_FILE" > "$MANIFEST_FILE.tmp" && mv "$MANIFEST_FILE.tmp" "$MANIFEST_FILE" + log "✔ 部署清单已记录: sha=$sha head=$head dirty=$dirty builder=$builder" +} + +verify_manifest() { + local pid sha line head + pid="$(systemctl --user show -p MainPID --value "$SVC_GO" 2>/dev/null)" + [ -n "$pid" ] && [ "$pid" != "0" ] || die "$SVC_GO: MainPID 为空/0" + sha="$(sha256sum "/proc/$pid/exe" 2>/dev/null | awk '{print $1}')" + [ -n "$sha" ] || die "$SVC_GO: 无法读取运行中二进制" + if [ ! -f "$MANIFEST_FILE" ]; then + die "部署清单不存在($MANIFEST_FILE)→ 当前运行二进制无法自证版本。 + 处置:先完整跑一次 deploy.sh 生成清单。" + fi + # 清单里找当前运行 sha 的最后一条记录 + line="$(grep "$(printf '\t%s\t' "$sha")" "$MANIFEST_FILE" 2>/dev/null | tail -1 || true)" + if [ -z "$line" ]; then + die "当前运行二进制 sha=$sha 不在部署清单中 → 该版本未经过 deploy.sh 记录,无法自证版本。 + 处置:若它是绕过 deploy.sh 直接 go build 的二进制,正属本闸门要拦截的路径 —— 请重跑完整 deploy.sh。" + fi + head="$(printf '%s\n' "$line" | cut -f3)" + log "✔ 自证版本通过: 运行二进制 sha=$sha ↔ commit=$head(清单记录时间 $(printf '%s\n' "$line" | cut -f1))" +} + do_verify() { log "校验 ..." verify_service "$SVC_GO" "$BUILD_GO" verify_service "$SVC_RUST" "$BUILD_RUST" verify_health verify_e2e_bitemporal - log "✅ 部署成功: 两服务 active · 进程无 (deleted) · 运行二进制=本次构建 · /health=200 · e2e 闸门通过" + verify_manifest + log "✅ 部署成功: 两服务 active · 进程无 (deleted) · 运行二进制=本次构建 · /health=200 · e2e 闸门通过 · 自证版本通过" } +# --verify:只校验自证版本(AC8 选项3),独立动作 —— 不构建/不安装/不重启 +if [ "$VERIFY_MANIFEST" = "1" ]; then + verify_manifest + exit 0 +fi + if [ "${1:-}" = "--verify-only" ]; then do_verify exit 0