Files
memoryweave/scripts/deploy.sh
T

381 lines
22 KiB
Bash
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/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