fix(deploy): t_debe2002 评审夹带闸门结构性修复 + 部署清单自证版本
- AC1 窗口算法:latest 取最新已批准祖先(rev-list HEAD 首命中)而非列表序首最老祖先, 修掉 18 条误判(实际未评审仅 4 条源码提交)。 - AC2 ①:只改批准清单文件的部署卫生提交自动放行 + 批准清单文件移出洁净判据, 打通 --mark-approved → deploy.sh 一次跑通的正规路径。 - AC6/AC7:修掉 2 处 die 消息里反引号命令替换注入(错误路径不再执行副作用)。 - AC8 ③:新增 ~/.hermes/state/zhiyi-deploy-manifest.jsonl 部署清单 + --verify 自证版本。 - AC3:批准清单补档 4 条源码提交(37890e30/772a597a/1f30474c/a1021bb7),各带卡 done 依据。
This commit is contained in:
@@ -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
|
||||
|
||||
+93
-7
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user