- 新增 sspf-contract(契约类型,不含 axum)、sspf-store(db/config,不认识 HTTP)、
sspf-sdk(业务包唯一依赖)与 packs/asset 样板包(可独立编译)
- 内核 platform/{envelope,entity,menu,ids,db,config}.rs 改为 re-export,引用路径零变化
- jnpf.rs → face_b.rs,9 处标识符改名;契约字面量(jnpf-origin / jnpfKey)刻意保留
- 新增 check-arch / check-naming / mem-budget 三道闸门;rust-toolchain 锁 1.95.0
- 影响:行为零变化(240 测试 / 九闸全绿 / 空载 7 MB),Profile 从 guard 迁到 config 断开假依赖
128 lines
4.0 KiB
Bash
Executable File
128 lines
4.0 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
# mem-budget.sh —— 内存预算实测闸门(PLAN.md 判断 ⑥)
|
||
#
|
||
# 终端产品形态下,内存超标 = 不可交付。这条必须**实测**,不能靠感觉。
|
||
#
|
||
# 用法:
|
||
# bash scripts/mem-budget.sh # 用 release 产物,空载测量
|
||
# bash scripts/mem-budget.sh --bin <path> # 指定二进制
|
||
# bash scripts/mem-budget.sh --budget 40 # 自定义空载预算(MB)
|
||
#
|
||
# 退出码:0 达标 / 1 超标 / 2 用法或环境错
|
||
#
|
||
# ── 量什么 ──
|
||
# **空载 RSS**(刚起来、健康检查通过、没有业务请求)。
|
||
# 典型/峰值预算要压测才能量,见 PLAN.md §2 判断 ⑥ 的表。
|
||
#
|
||
# ⚠️ 测量口径按平台选:
|
||
# macOS ⇒ `vmmap` 的 **Physical footprint**(准确,扣掉共享页与保留虚拟地址)
|
||
# Linux ⇒ `ps -o rss=`(近似,但趋势够用)
|
||
# 本机沙箱禁止 `ps` / `top`,所以必须走 vmmap 分支。
|
||
|
||
set -u
|
||
|
||
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||
BIN="$ROOT/target/release/ssw-platform"
|
||
BUDGET_MB=40
|
||
PORT=30997
|
||
STARTUP_WAIT=25
|
||
|
||
while [ $# -gt 0 ]; do
|
||
case "$1" in
|
||
--bin) BIN="$2"; shift 2 ;;
|
||
--budget) BUDGET_MB="$2"; shift 2 ;;
|
||
--port) PORT="$2"; shift 2 ;;
|
||
--help) sed -n '2,20p' "$0"; exit 0 ;;
|
||
*) echo "未知参数: $1"; exit 2 ;;
|
||
esac
|
||
done
|
||
|
||
[ -x "$BIN" ] || { echo "❌ 二进制不存在或不可执行: $BIN"; echo " 先跑: cargo build --release"; exit 2; }
|
||
|
||
TMPDB="$(mktemp -d /tmp/sspf-memtest.XXXXXX)"
|
||
LOG="$TMPDB/backend.log"
|
||
|
||
cleanup() {
|
||
if [ -n "${PID:-}" ] && kill -0 "$PID" 2>/dev/null; then
|
||
kill "$PID" 2>/dev/null || true
|
||
sleep 0.5
|
||
kill -9 "$PID" 2>/dev/null || true
|
||
fi
|
||
rm -rf "$TMPDB"
|
||
}
|
||
trap cleanup EXIT INT TERM
|
||
|
||
echo "── 内存预算实测(空载 RSS,预算 ${BUDGET_MB} MB)──"
|
||
echo " 二进制: $BIN"
|
||
|
||
env PORT="$PORT" PGLITE_DIR="$TMPDB/db" "$BIN" >"$LOG" 2>&1 &
|
||
PID=$!
|
||
|
||
# 等健康检查(最多 STARTUP_WAIT 秒)
|
||
ok=0
|
||
for _ in $(seq 1 $((STARTUP_WAIT * 2))); do
|
||
if ! kill -0 "$PID" 2>/dev/null; then
|
||
echo "❌ 后端启动即退出,日志尾部:"
|
||
tail -20 "$LOG" | sed 's/^/ /'
|
||
exit 2
|
||
fi
|
||
if curl -s --noproxy '*' --max-time 1 "http://127.0.0.1:$PORT/api/health" 2>/dev/null | grep -q '"ok"'; then
|
||
ok=1
|
||
break
|
||
fi
|
||
sleep 0.5
|
||
done
|
||
|
||
if [ "$ok" -ne 1 ]; then
|
||
echo "❌ ${STARTUP_WAIT}s 内健康检查未通过,日志尾部:"
|
||
tail -20 "$LOG" | sed 's/^/ /'
|
||
exit 2
|
||
fi
|
||
|
||
# 让初始化(建表 + 种子)彻底落定,再量一次稳态
|
||
sleep 2
|
||
|
||
# 取「独占物理内存」(MB)。优先 vmmap,退回 ps。
|
||
# 🔴 本机沙箱里 `ps` / `top` 会被拦(Operation not permitted),vmmap 可用。
|
||
measure_rss_mb() {
|
||
local pid="$1" raw val unit
|
||
if command -v vmmap >/dev/null 2>&1; then
|
||
raw="$(vmmap "$pid" 2>/dev/null | awk '/^Physical footprint:/{print $3; exit}')"
|
||
if [ -n "$raw" ]; then
|
||
unit="$(printf '%s' "$raw" | tr -d '0-9.')"
|
||
val="$(printf '%s' "$raw" | tr -d 'KMG')"
|
||
case "$unit" in
|
||
K) awk -v v="$val" 'BEGIN{printf "%d", v/1024}' ;;
|
||
M) awk -v v="$val" 'BEGIN{printf "%d", v}' ;;
|
||
G) awk -v v="$val" 'BEGIN{printf "%d", v*1024}' ;;
|
||
*) : ;;
|
||
esac
|
||
return 0
|
||
fi
|
||
fi
|
||
raw="$(ps -o rss= -p "$pid" 2>/dev/null | tr -d ' ')"
|
||
if [ -n "$raw" ]; then
|
||
awk -v v="$raw" 'BEGIN{printf "%d", v/1024}'
|
||
return 0
|
||
fi
|
||
return 1
|
||
}
|
||
|
||
RSS_MB="$(measure_rss_mb "$PID")"
|
||
[ -n "${RSS_MB:-}" ] || { echo "❌ 取不到内存(vmmap 与 ps 都不可用)"; exit 2; }
|
||
|
||
echo " 空载物理内存: ${RSS_MB} MB"
|
||
|
||
if [ "$RSS_MB" -le "$BUDGET_MB" ]; then
|
||
printf '✅ MEM-BUDGET 达标:%d MB <= %d MB\n' "$RSS_MB" "$BUDGET_MB"
|
||
exit 0
|
||
fi
|
||
|
||
printf '❌ MEM-BUDGET 超标:%d MB > %d MB(差 %d MB)\n' \
|
||
"$RSS_MB" "$BUDGET_MB" "$((RSS_MB - BUDGET_MB))"
|
||
echo " 排查顺序:"
|
||
echo " 1) 是否 pglite 预分配过大(shared_buffers 一类)"
|
||
echo " 2) 启动时是否把整表读进内存(MEM1 红线)"
|
||
echo " 3) 是否有无界缓存(MEM2 红线)"
|
||
exit 1
|