381 lines
22 KiB
Bash
Executable File
381 lines
22 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
# 织忆 MemoryWeave 统一部署脚本 — build two + install two + restart two + verify
|
||
# 2026-10-08 · t_f57b8bbf · 根治「重启 zhiyid 不重启 sidecar → Rust 改部署后 sidecar 跑旧二进制静默故障」事故
|
||
#
|
||
# 用法:
|
||
# ./scripts/deploy.sh 完整部署: 构建两+装两+停两+启两+校验
|
||
# ./scripts/deploy.sh --verify-only 只跑校验(不构建/不安装/不重启)—— 反例测试/人工体检用
|
||
# ./scripts/deploy.sh --mark-approved 评审通过后把当前 HEAD 追加进已批准部署清单(独立动作,不构建)
|
||
# ./scripts/deploy.sh --allow-unreviewed 显式承担「构建范围含未评审提交」的风险(默认拒绝)
|
||
# make deploy = ./scripts/deploy.sh
|
||
#
|
||
# 🔴 部署前必须核对夹带(2026-10-17 t_3f83df64):构建基准 HEAD 相对 scripts/deploy-approved-commits.txt
|
||
# 批准清单之间的每个提交都须在清单内;不在 ⇒ 未评审 ⇒ 默认拒绝,需显式 --allow-unreviewed 或先 --mark-approved。
|
||
set -euo pipefail
|
||
|
||
REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||
BIN_DIR="${BIN_DIR:-/home/muc/bin}"
|
||
|
||
# 用法/帮助(t_debe2002 AC11):--help 打印用法后 exit 0,不构建不停止服务;
|
||
# 未知参数(--help2/--foo/空串)打印用法 + exit 2,绝不进入部署流程。
|
||
# 背景:AC11 由验收在评审时亲自踩到 —— 原先未知参数被静默忽略后走完整部署
|
||
# (一个手滑的 --help 就触发一次「构建+停服务+重启+7分钟CPU尖峰」)。
|
||
# 本脚本的主题正是「错误路径上不应有副作用」,未知参数是被忽略后触发完整部署
|
||
# = 同类缺陷的入口版,故必须拒绝。
|
||
usage() {
|
||
cat <<'EOF'
|
||
用法:
|
||
./scripts/deploy.sh 完整部署: 构建两+装两+停两+启两+校验
|
||
./scripts/deploy.sh --help 打印本用法后退出(不构建/不停止/不启动)
|
||
./scripts/deploy.sh --dry-run 跑前置闸门 + 打印将执行的动作后退出(不写/不停/不启)
|
||
./scripts/deploy.sh --verify 只校验「运行二进制 sha ∈ 部署清单」的自证版本(独立动作,不构建)
|
||
./scripts/deploy.sh --verify-only 只跑全量校验(不构建/不安装/不重启)—— 反例测试/人工体检用
|
||
./scripts/deploy.sh --mark-approved 评审通过后把当前 HEAD 追加进已批准部署清单(独立动作)
|
||
./scripts/deploy.sh --allow-unreviewed 显式承担「构建范围含未评审提交」的风险(默认拒绝)
|
||
./scripts/deploy.sh --allow-dirty 显式承担「把在途改动编进生产二进制」的风险(默认拒绝)
|
||
make deploy = ./scripts/deploy.sh
|
||
未知参数 → 打印本用法 + exit 2(t_debe2002 AC11:手滑的参数不得触发一次无人要的部署重启)。
|
||
EOF
|
||
}
|
||
|
||
ALLOW_DIRTY=0
|
||
# --allow-unreviewed:显式承担「把未经评审的提交编进生产」的风险(默认拒绝)
|
||
ALLOW_UNREVIEWED=0
|
||
# --mark-approved:把当前 HEAD 记录为「已批准部署基线」(评审通过后手动打点,独立动作,不构建)
|
||
MARK_APPROVED=0
|
||
# --verify:只校验「运行二进制 sha ∈ 部署清单」的自证版本(AC8 选项3,独立动作,不构建/不安装/不重启)
|
||
VERIFY_MANIFEST=0
|
||
# --verify-only:只跑全量校验(AC1-AC10 时代即有的独立动作,不构建/不安装/不重启)
|
||
VERIFY_ONLY=0
|
||
# --dry-run:跑前置闸门 + 打印将执行的动作,不写/不停/不启(AC11)
|
||
DRY_RUN=0
|
||
for _a in "$@"; do
|
||
case "$_a" in
|
||
--help) usage; exit 0 ;;
|
||
--dry-run) DRY_RUN=1 ;;
|
||
--allow-dirty) ALLOW_DIRTY=1 ;;
|
||
--allow-unreviewed) ALLOW_UNREVIEWED=1 ;;
|
||
--mark-approved) MARK_APPROVED=1 ;;
|
||
--verify) VERIFY_MANIFEST=1 ;;
|
||
--verify-only) VERIFY_ONLY=1 ;;
|
||
# t_debe2002 AC11:未知参数(含 --help2/--foo/空串)→ 打印用法 + exit 2,绝不进入部署流程。
|
||
# 用独立的 unknown() 而非 die(),因为 die 固定 exit 1,而 AC11 要求未知参数 exit 2。
|
||
*) printf '\033[1;31m[deploy:FAIL]\033[0m 未知参数: %s\n' "$_a" >&2; usage >&2; exit 2 ;;
|
||
esac
|
||
done
|
||
|
||
# 构建产物(持久路径,均已 gitignore)
|
||
BUILD_GO="$REPO_DIR/go/cmd/zhiyid/zhiyid"
|
||
BUILD_RUST="$REPO_DIR/rust/target/release/zhiyi-consolidate"
|
||
# 安装落点(与 ~/.config/systemd/user/*.service 的 ExecStart 一致)
|
||
INSTALL_GO="$BIN_DIR/zhiyid-new"
|
||
INSTALL_RUST="$BIN_DIR/zhiyi-consolidate"
|
||
# 服务名(用户级 systemd)
|
||
SVC_GO="zhiyid.service"
|
||
SVC_RUST="zhiyi-consolidate.service"
|
||
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; }
|
||
|
||
# 校验单个服务的运行态是否=本次构建的二进制
|
||
# 判据优先级(纪律): 副作用(PID/inode/校验和) > 返回值 > 自报
|
||
verify_service() {
|
||
local name="$1" build_path="$2" pid exe run_sha build_sha
|
||
# ① is-active
|
||
[ "$(systemctl --user is-active "$name")" = "active" ] || die "$name 非 active"
|
||
# ② 取 MainPID
|
||
pid="$(systemctl --user show -p MainPID --value "$name")"
|
||
[ -n "$pid" ] && [ "$pid" != "0" ] || die "$name: MainPID 为空/0"
|
||
# ③ 进程 exe 不得指向已删除 inode(旧二进制被 install 覆盖后、进程仍跑旧 inode → readlink 含 "(deleted)")
|
||
exe="$(readlink "/proc/$pid/exe" 2>/dev/null || true)"
|
||
case "$exe" in
|
||
"") die "$name: 无法 readlink /proc/$pid/exe" ;;
|
||
*" (deleted)"*) die "$name: 进程仍跑已删除 inode → 二进制被换过但进程没重启 ($exe)" ;;
|
||
esac
|
||
# ④ 运行中二进制校验和 == 本次构建产物(抓「磁盘装了新版但进程仍跑旧版」静默故障)
|
||
run_sha="$(sha256sum "/proc/$pid/exe" 2>/dev/null | awk '{print $1}')"
|
||
build_sha="$(sha256sum "$build_path" 2>/dev/null | awk '{print $1}')"
|
||
[ -n "$run_sha" ] || die "$name: 无法读取运行中二进制"
|
||
[ "$run_sha" = "$build_sha" ] || die "$name: 运行中二进制 ≠ 本次构建产物 (运行=$run_sha 构建=$build_sha) → sidecar 静默跑旧版"
|
||
log "✔ $name active · PID=$pid · exe=$exe · 校验和匹配本次构建"
|
||
}
|
||
|
||
# 深健康检查: /health 连 sidecar 可达性(P0 已做,故障返 503)→ 期望 200
|
||
verify_health() {
|
||
local code
|
||
code="$(curl -s -o /dev/null -w '%{http_code}' -m 5 "$HEALTH_URL")"
|
||
[ "$code" = "200" ] || die "/health 返回 $code (期望 200) → zhiyid 或 sidecar 故障"
|
||
log "✔ /health = $code"
|
||
}
|
||
|
||
# 🔴 构建前洁净检查(2026-10-14 加)。起因(当晚三次同族事故):
|
||
# ① c345ed5 把另一任务在途的 server.go 布线一起提交 ⇒ HEAD 直接编译不过
|
||
# ② 本脚本原先**直接从工作树构建** ⇒ 任一 worker 的在途改动会被顺手编进**生产二进制**,
|
||
# 而且部署后「运行二进制校验和匹配」会通过 —— 校验和只能证明「跑的是本次构建」,
|
||
# **不能证明「本次构建来自已提交的代码」**。这是验证链上的一个洞。
|
||
# 判据:`git status --porcelain`(含未跟踪,不含已忽略)必须为空。
|
||
# 未跟踪文件也要拦:`internal/peer` 那类事故正是「已提交代码引用了未跟踪文件」——
|
||
# 反之未跟踪的新源文件被编进去,二进制就与 commit 不一致。
|
||
preflight_clean_tree() {
|
||
if [ "$ALLOW_DIRTY" = "1" ]; then
|
||
log "⚠️ --allow-dirty:跳过洁净检查(本次构建含未提交改动,风险自负)"
|
||
return 0
|
||
fi
|
||
local dirty
|
||
# 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 "工作树不洁净 → 拒绝构建(会把在途改动编进生产二进制,部署后校验和仍会通过,无法事后察觉)。
|
||
处置:先提交/收工;确需带脏部署则显式加 --allow-dirty 并在卡上记录原因。"
|
||
fi
|
||
log "✔ 洁净检查通过(含未跟踪文件:无残留)"
|
||
}
|
||
|
||
# 🔴 部署夹带闸门(2026-10-17 t_3f83df64 加)。起因:01:18 生产二进制被换成 e3dd0f6e487f,
|
||
# 而 t_fa6c9104(744ebb8) 到 03:03 才评审通过 —— 该提交在**未评审时**已进生产(搭了
|
||
# t_c661dd17「部署 fa0880d」的顺风车)。「按基准打包、夹带未批准提交」是反复发生的机制缺陷。
|
||
# 判据:本次构建基准 HEAD 相对已批准清单(scripts/deploy-approved-commits.txt,每行一个已批准 commit SHA)
|
||
# 之间的**每一个提交**都必须在批准清单内;任何不在清单内的提交进入构建范围 ⇒ 未评审 ⇒ 告警并
|
||
# **要求显式确认**,不得静默通过。显式确认 = --allow-unreviewed(承担风险)或先 --mark-approved
|
||
# 把 HEAD 追加进批准清单(评审通过后打点)。
|
||
preflight_reviewed_commits() {
|
||
if [ "$ALLOW_UNREVIEWED" = "1" ]; then
|
||
log "⚠️ --allow-unreviewed:跳过评审夹带检查(本次含未评审提交,风险自负)"
|
||
return 0
|
||
fi
|
||
local head approved unreviewed n
|
||
head="$(git -C "$REPO_DIR" rev-parse HEAD 2>/dev/null || true)"
|
||
[ -n "$head" ] || die "无法解析 HEAD($REPO_DIR 不是有效 git 仓库?)"
|
||
if [ ! -f "$APPROVED_FILE" ]; then
|
||
# 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"
|
||
# 清单里的 SHA 必须都仍存在于仓库(被 reset/rebase 抹掉的批准提交不可复核)
|
||
local bad
|
||
bad="$(printf '%s\n' "$approved" | while read -r a; do
|
||
[ -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 相对清单中「最新」的已批准**祖先**提交的推进量。
|
||
# 原缺陷(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 恰在某批准提交上
|
||
if printf '%s\n' "$approved" | grep -qx "$head"; then
|
||
log "✔ 评审夹带检查通过(HEAD=$head 已在批准清单内)"
|
||
return 0
|
||
fi
|
||
unreviewed="$(printf '%s\n' "$head")"
|
||
else
|
||
unreviewed="$(git -C "$REPO_DIR" rev-list "$latest..$head" 2>/dev/null || true)"
|
||
[ -z "$unreviewed" ] && { log "✔ 评审夹带检查通过(HEAD=$head 已在批准清单内)"; return 0; }
|
||
fi
|
||
# 过滤:已在批准清单里的提交不算未评审
|
||
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
|
||
fi
|
||
n="$(printf '%s\n' "$unreviewed" | wc -l | tr -d ' ')"
|
||
echo "⚠️ 构建范围含 $n 个**未评审**提交(不在已批准部署清单 $APPROVED_FILE 内):" >&2
|
||
printf '%s\n' "$unreviewed" | sed 's/^/ /' >&2
|
||
die '拒绝构建:构建范围夹带未评审提交。
|
||
处置:① 先评审这批提交,再 ./scripts/deploy.sh --mark-approved 把 HEAD 追加进批准清单;
|
||
② 确需带未评审提交部署则显式加 --allow-unreviewed 并在卡上记录原因。'
|
||
}
|
||
|
||
do_build() {
|
||
preflight_reviewed_commits
|
||
preflight_clean_tree
|
||
log "构建 Go → $BUILD_GO"
|
||
( cd "$REPO_DIR/go" && CGO_ENABLED=1 go build -o cmd/zhiyid/zhiyid ./cmd/zhiyid )
|
||
log "构建 Rust → $BUILD_RUST"
|
||
( cd "$REPO_DIR/rust" && cargo build --release )
|
||
}
|
||
|
||
do_install() {
|
||
log "停止 $SVC_GO + $SVC_RUST"
|
||
systemctl --user stop "$SVC_GO" || true
|
||
systemctl --user stop "$SVC_RUST" || true
|
||
# 用 install 而非 cp:install 先写临时再 rename,避免 Text file busy(进程占着旧 inode 时 cp 会 EBUSY)
|
||
log "install 二进制(不用 cp,避免 Text file busy)"
|
||
install -m 0755 "$BUILD_GO" "$INSTALL_GO"
|
||
install -m 0755 "$BUILD_RUST" "$INSTALL_RUST"
|
||
log "daemon-reload"
|
||
systemctl --user daemon-reload
|
||
log "启动 $SVC_GO + $SVC_RUST"
|
||
systemctl --user start "$SVC_GO"
|
||
systemctl --user start "$SVC_RUST"
|
||
sleep 2
|
||
write_manifest
|
||
}
|
||
|
||
# bi-temporal e2e 闸门(2026-10-14 加):
|
||
# 为什么:`bitemporal_e2e_test.go` 默认 `t.Skip`(需 sidecar),
|
||
# 若无人设 ZHIYI_BITEMPORAL_SOCK ⇒ **闸门永不开火** ⇒ 等于不存在。
|
||
# 机制铁律「写完无人调用 = 零效力」⇒ 接进部署流程:每次部署后自动跑一遍。
|
||
# 跑法:用**本次已安装的** sidecar 开一个临时 socket + 临时 data-dir(不碰生产库),
|
||
# 跑 Go e2e(真实 LanceDB 写→读回)。失败即 die —— 这正是 2026-10-14
|
||
# 「只改 Go 不改 Rust ⇒ 三列在 LanceDB 边界静默丢 ⇒ 生产 no-op」的守门人。
|
||
verify_e2e_bitemporal() {
|
||
local sock=/tmp/mw-deploy-bit.sock data=/tmp/mw-deploy-bitdata log=/tmp/mw-deploy-bit.log spid rc
|
||
rm -rf "$data" "$sock"; mkdir -p "$data"
|
||
"$INSTALL_RUST" --mode socket --socket "$sock" --data-dir "$data" >"$log" 2>&1 &
|
||
spid=$!
|
||
for _ in $(seq 1 30); do [ -S "$sock" ] && break; sleep 0.5; done
|
||
if [ ! -S "$sock" ]; then
|
||
kill "$spid" 2>/dev/null
|
||
die "bi-temporal 闸门:临时 sidecar 未能监听 $sock(见 $log)"
|
||
fi
|
||
( cd "$REPO_DIR/go" && CGO_ENABLED=1 ZHIYI_BITEMPORAL_SOCK="$sock" \
|
||
go test -run TestBitemporalE2E ./internal/storage/ >/tmp/mw-deploy-bit-gotest.log 2>&1 )
|
||
rc=$?
|
||
kill "$spid" 2>/dev/null
|
||
for _ in $(seq 1 5); do kill -0 "$spid" 2>/dev/null || break; sleep 1; done
|
||
kill -0 "$spid" 2>/dev/null && kill -9 "$spid" 2>/dev/null
|
||
if [ "$rc" -ne 0 ]; then
|
||
sed 's/^/ /' /tmp/mw-deploy-bit-gotest.log | tail -15 >&2
|
||
die "bi-temporal 端到端闸门 FAIL(exit=$rc)—— 三列在 LanceDB 真实写→读回环断了。
|
||
典型根因:只改 Go payload 未改 Rust schema / 只改 Rust 未改 payload。"
|
||
fi
|
||
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
|
||
verify_manifest
|
||
log "✅ 部署成功: 两服务 active · 进程无 (deleted) · 运行二进制=本次构建 · /health=200 · e2e 闸门通过 · 自证版本通过"
|
||
}
|
||
|
||
# --verify:只校验自证版本(AC8 选项3),独立动作 —— 不构建/不安装/不重启
|
||
if [ "$VERIFY_MANIFEST" = "1" ]; then
|
||
verify_manifest
|
||
exit 0
|
||
fi
|
||
|
||
# --verify-only:只跑全量校验(不构建/不安装/不重启)—— 反例测试/人工体检用
|
||
if [ "$VERIFY_ONLY" = "1" ]; then
|
||
do_verify
|
||
exit 0
|
||
fi
|
||
|
||
# --mark-approved:独立动作(不构建/不安装/不重启)—— 评审通过后把 HEAD 追加进已批准部署清单
|
||
if [ "$MARK_APPROVED" = "1" ]; then
|
||
head="$(git -C "$REPO_DIR" rev-parse HEAD)"
|
||
touch "$APPROVED_FILE"
|
||
if grep -qx "$head" "$APPROVED_FILE"; then
|
||
log "✔ HEAD $head 已在批准清单中($APPROVED_FILE),无需追加"
|
||
else
|
||
printf '%s\n' "$head" >> "$APPROVED_FILE"
|
||
log "✔ 已追加批准部署 commit = $head(写入 $APPROVED_FILE)"
|
||
fi
|
||
log " 后续 deploy.sh 默认拒绝构建范围含未批准提交;越界部署需 --allow-unreviewed 或先 --mark-approved"
|
||
exit 0
|
||
fi
|
||
|
||
# --dry-run(t_debe2002 AC11):跑前置闸门 + 打印将执行的动作后退出 —— 不写文件/不停止/不启动。
|
||
# 先跑 preflight_reviewed_commits + preflight_clean_tree(纯只读检查):若部署会被闸门拦下,
|
||
# 这里就真实报出(die exit=1),让 dry-run 成为「这次部署能否通过」的预览;
|
||
# 通过则打印完整动作清单后 exit 0,绝不触碰生产。
|
||
if [ "$DRY_RUN" = "1" ]; then
|
||
preflight_reviewed_commits
|
||
preflight_clean_tree
|
||
log "dry-run:以下为完整部署将执行的动作(本次不写/不停/不启)——"
|
||
log " · 构建: go build → $BUILD_GO"
|
||
log " · 构建: cargo build --release → $BUILD_RUST"
|
||
log " · 停止: $SVC_GO + $SVC_RUST"
|
||
log " · install: → $INSTALL_GO + $INSTALL_RUST"
|
||
log " · daemon-reload + 启动: $SVC_GO + $SVC_RUST"
|
||
log " · 校验: 服务 active / 无(deleted) inode / 运行sha=构建sha / /health=200 / bi-temporal e2e / 自证版本"
|
||
log "dry-run 结束(未执行任何部署动作)"
|
||
exit 0
|
||
fi
|
||
|
||
do_build
|
||
do_install
|
||
do_verify |