- axum 0.8 + pglite:12 张表,多应用按 App-Code 头解析 f_system_id 隔离 - 面 A(ssw/react 形状)+ 面 B(官方 JNPF 形状,Vue-Version: 3)双契约并存 - 业务模块 asset/DataResource;面 B 用户 CRUD 9 条已落地 - 六道闸门 + 两把运行时尺子(perm-smoke 43 / perm-smoke-jnpf 23) - scripts/:前端接口清单、页面依赖反查、运行时探针
141 lines
4.6 KiB
Bash
141 lines
4.6 KiB
Bash
#!/usr/bin/env bash
|
||
# smoke_backend.sh —— 契约尺子的「隔离后端」自启动助手
|
||
#
|
||
# 🔴 **被 source,不是独立可执行**(`perm-smoke.sh` / `perm-smoke-jnpf.sh` 各自 source 它)。
|
||
#
|
||
# 为什么需要它:两把契约尺子原先都要求「后端已经在 30010 起着」⇒
|
||
# ① 两把尺子**互相踩**(面 A 尺子改了库里的角色/菜单 ⇒ 面 B 尺子的前置状态被污染);
|
||
# ② 跑完尺子**留脏数据**在 `src/backend/data/lite.pg`(每次多一行 smoke_user / product / book);
|
||
# ③ **CI 里没法跑**(没人替你起后端)。
|
||
#
|
||
# 口径(刻意做成「能自起,但不强拆用户的开发环境」):
|
||
# - 用户**显式**给了 `B` ⇒ **不自起**(尊重外部后端);不可达 ⇒ 前置错误(退出码 2)。
|
||
# - 用户**没给** `B`(用默认 30010)⇒ 先探默认端口:
|
||
# · 通了 ⇒ 就用它(保留「跑开发中的后端」这个习惯);
|
||
# · 不通 ⇒ **自起一个隔离实例**:独立数据目录(临时目录,跑完删)+ 空闲端口。
|
||
#
|
||
# ⇒ 跑完尺子,库里的痕迹**随临时目录一起消失** ⇒ 断言可重复、两把尺子互不污染。
|
||
|
||
# 自起的后端进程(由 ensure_backend 设置)
|
||
BACKEND_PID=""
|
||
BACKEND_TMP=""
|
||
BACKEND_ISOLATED=0
|
||
|
||
# 🔴 变量名后紧跟中文时 bash 会把中文并进变量名 ⇒ 一律写 ${VAR}
|
||
smoke_backend_pick_port() {
|
||
# 优先用 python3(真正 bind 一下拿端口 ⇒ 不会撞)
|
||
if [ -n "${PY_BIN:-}" ]; then
|
||
"${PY_BIN}" - <<'PY' 2>/dev/null && return 0
|
||
import socket
|
||
s = socket.socket()
|
||
s.bind(("127.0.0.1", 0))
|
||
print(s.getsockname()[1])
|
||
s.close()
|
||
PY
|
||
fi
|
||
# 没有 python3 ⇒ 用 /dev/tcp 扫一段端口(连不上 ⇒ 当作空的)
|
||
local p
|
||
for p in $(seq 30110 30199); do
|
||
if ! (exec 3<>/dev/tcp/127.0.0.1/"${p}") 2>/dev/null; then
|
||
echo "${p}"
|
||
return 0
|
||
fi
|
||
done
|
||
echo ""
|
||
return 1
|
||
}
|
||
|
||
# 后端是否就绪(`/api/health` 返回 `{"ok":true,…}` ⇒ schema 已建好)
|
||
smoke_backend_ready() {
|
||
curl -s --noproxy '*' --max-time 2 "$1/api/health" 2>/dev/null | grep -q '"ok":true'
|
||
}
|
||
|
||
# ensure_backend <后端二进制> [显式给的 B]
|
||
# 成功后 ${B} 指向可用的后端;自起时 ${BACKEND_PID} 非空(退出时要 kill)。
|
||
smoke_backend_ensure() {
|
||
local bin="${1:-}"
|
||
local explicit_b="${2:-}"
|
||
|
||
if smoke_backend_ready "${B}"; then
|
||
return 0
|
||
fi
|
||
|
||
# 显式指定了 B 却不通 ⇒ 那是**用户自己的**后端 ⇒ 不自起,直接前置错误
|
||
if [ -n "${explicit_b}" ]; then
|
||
if [ -n "${pre_fail:-}" ]; then
|
||
pre_fail "后端不可达:${B}(${explicit_b} 是显式指定的 ⇒ 不自起隔离实例)。"
|
||
fi
|
||
echo "❌ 前置错误:后端不可达:${B}"
|
||
exit 2
|
||
fi
|
||
|
||
if [ -z "${bin}" ] || [ ! -x "${bin}" ]; then
|
||
if [ -n "${pre_fail:-}" ]; then
|
||
pre_fail "后端不可达且自起需要可执行文件(${bin})。"
|
||
fi
|
||
echo "❌ 前置错误:后端不可达且自起需要可执行文件(${bin})。"
|
||
exit 2
|
||
fi
|
||
|
||
local port
|
||
port="$(smoke_backend_pick_port)"
|
||
if [ -z "${port}" ]; then
|
||
if [ -n "${pre_fail:-}" ]; then
|
||
pre_fail "找不到空闲端口(自起隔离后端失败)。"
|
||
fi
|
||
echo "❌ 前置错误:找不到空闲端口(自起隔离后端失败)。"
|
||
exit 2
|
||
fi
|
||
|
||
BACKEND_TMP="$(mktemp -d)"
|
||
B="http://127.0.0.1:${port}"
|
||
|
||
# 🔴 数据目录必须是**绝对路径**(契约:PGLITE_DIR 只接受绝对路径或 memory://)
|
||
PORT="${port}" \
|
||
PGLITE_DIR="${BACKEND_TMP}/pg" \
|
||
BIND_ADDR="127.0.0.1" \
|
||
"${bin}" >"${BACKEND_TMP}/backend.log" 2>&1 &
|
||
BACKEND_PID=$!
|
||
BACKEND_ISOLATED=1
|
||
|
||
# 等就绪(最多 40 秒)
|
||
local i=0
|
||
while [ "${i}" -lt 80 ]; do
|
||
if ! kill -0 "${BACKEND_PID}" 2>/dev/null; then
|
||
break
|
||
fi
|
||
if smoke_backend_ready "${B}"; then
|
||
return 0
|
||
fi
|
||
sleep 0.5
|
||
i=$((i+1))
|
||
done
|
||
|
||
echo "❌ 前置错误:隔离后端起不来(日志:${BACKEND_TMP}/backend.log)"
|
||
sed 's/^/ /' "${BACKEND_TMP}/backend.log" 2>/dev/null || true
|
||
smoke_backend_kill
|
||
exit 2
|
||
}
|
||
|
||
# 停掉自起的后端(TERM ⇒ 等 ⇒ 兜底 KILL;SIGKILL 会漏 SysV 信号量 ⇒ 尽量走 TERM)
|
||
smoke_backend_kill() {
|
||
if [ -z "${BACKEND_PID}" ]; then
|
||
return 0
|
||
fi
|
||
kill -TERM "${BACKEND_PID}" 2>/dev/null || true
|
||
local i=0
|
||
while [ "${i}" -lt 60 ]; do
|
||
if ! kill -0 "${BACKEND_PID}" 2>/dev/null; then
|
||
break
|
||
fi
|
||
sleep 0.1
|
||
i=$((i+1))
|
||
done
|
||
if kill -0 "${BACKEND_PID}" 2>/dev/null; then
|
||
kill -KILL "${BACKEND_PID}" 2>/dev/null || true
|
||
fi
|
||
wait "${BACKEND_PID}" 2>/dev/null || true
|
||
BACKEND_PID=""
|
||
BACKEND_ISOLATED=0
|
||
}
|