Files
ssw-platform/run.sh
T
sukyboor 9771fa844d init: 尚数网平台 JNPF 7.0 兼容后端(多应用 + 面 A/面 B 双契约)
- 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/:前端接口清单、页面依赖反查、运行时探针
2026-10-30 22:08:31 +08:00

278 lines
13 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
# ssw-platform 一键脚本
#
# 后端 = Rust 单二进制(cargo workspace 根 = 仓库根 ⇒ target/ 在仓库根)。
# 数据库为嵌入式 pglite-rs(进程内原生 PostgreSQL),零服务 / 零 Docker / 零 WASM。
#
# 用法:
# ./run.sh install 安装依赖(cargo fetch + npm install)
# ./run.sh build 构建(cargo build --release + vite build)
# ./run.sh dev 后台起后端(30010) + 前端(5173),日志进 .logs/,PID 写入 .run/
# (**后端与前端都就绪**才算成功;任一没就绪 ⇒ 退出码 1)
# ./run.sh backend 前台起后端
# ./run.sh frontend 前台起前端
# ./run.sh stop 用 PID 文件停后台进程 + 兜底 kill_ports
# ./run.sh logs tail .logs/{backend,frontend}.log
# ./run.sh --help 本用法
#
# 退出码:0 成功 / 1 运行期失败 / 2 用法错
set -euo pipefail
ROOT="$(cd "$(dirname "$0")" && pwd)"
LOGS="$ROOT/.logs"
RUN="$ROOT/.run"
# 后端端口:兄弟项目 tdc-rs 已占用它自己的后端端口,本仓一律用 30010。
# 前端 vite 端口固定 5173(vite.config.ts 里 strictPort: true)。
BACKEND_PORT=30010
FRONTEND_PORT=5173
# 🔴 kill_ports 用的是 kill -9 ⇒ 端口列表**只能是本仓自己的这两个端口**。
# 不许把兄弟项目 tdc-rs 的端口写进来(打死它就是破坏兄弟项目)。
BACKEND_BIN="$ROOT/target/release/ssw-platform"
# 加载项目根 .env(后端不 import dotenv,靠这里把 PORT / PGLITE_DIR 导出给子进程)
if [ -f "$ROOT/.env" ]; then
set -a; . "$ROOT/.env"; set +a
fi
export PORT="${PORT:-30010}"
# 🔴 **端口守卫**:只在**真会启动后端**的子命令(`dev` / `backend`)里生效。
# 理由:守卫存在的唯一理由是「后端子进程会继承 `PORT` 并真的绑那个端口」。
# `frontend` / `stop` / `install` / `build` / `logs` / `--help` / 无参**根本不碰端口**
# ⇒ 不该因为环境里恰好有个 `PORT` 就失败(那是误伤)。
# 🔴 本仓端口是硬约定:后端固定 30010、前端固定 5173。
# (不是「改成用 $PORT 清端口」——那会让 kill_ports 去杀**任意端口**上的进程。)
guard_port() {
if [ "${PORT}" != "${BACKEND_PORT}" ]; then
echo "[用法错] PORT=${PORT} 与本仓硬约定的后端端口 ${BACKEND_PORT} 不一致。"
echo " 本仓端口是硬约定(兄弟项目已占用它自己的端口,两套服务必须彻底分开)。"
echo " 要用别的端口请直接跑二进制:PORT=${PORT} ${BACKEND_BIN}"
exit 2
fi
}
usage() {
cat <<'EOF'
用法: ./run.sh <子命令>
install 安装依赖(cargo fetch + npm install)
build 构建(cargo build --release + vite build)
dev 后台起后端(30010) + 前端(5173);**后端与前端都就绪**才算成功
backend 前台起后端
frontend 前台起前端
stop 停止后台进程
logs 打印后端/前端日志尾部
--help 本用法
退出码: 0 成功 / 1 运行期失败 / 2 用法错
端口: 后端固定 30010、前端固定 5173(硬约定;PORT 改成别的值 ⇒ dev/backend 退出码 2)
EOF
}
# 端口守护:dev/start 前清掉残留进程,避免 EADDRINUSE 被静默吞掉(旧进程仍占端口,
# 新进程崩溃但请求全部打到旧实例 → 看起来「改了 seed 但菜单不变」之类的灵异 bug)。
kill_ports() {
local killed=0
for p in "$@"; do
local pids
pids="$(lsof -ti:"$p" 2>/dev/null || true)"
if [ -n "$pids" ]; then
echo " ↳ 端口 $p 被旧进程占用 (PID: $pids),清理中…"
# shellcheck disable=SC2086
kill -9 $pids 2>/dev/null || true
killed=1
fi
done
# 注意 set -e:端口空闲时 [ ] 返回 1 会炸掉调用方(dev 走不到 start_logged)
[ "$killed" -eq 1 ] && sleep 1
return 0
}
# 🔴 **就绪轮询**:起完进程不等于服务可用。
# 旧版 dev 起完就打印「服务已在后台启动」并 exit 0 ⇒ 后端起不来(数据库路径写错等)
# 时**脚本报成功、实际没有服务** ⇒ 极难定位。
# ⇒ 轮询 /api/health(routes.rs 里真有的探活端点),最长 30 秒。
# 本机 curl 走系统代理 ⇒ 必须带 --noproxy '*'。
wait_backend_ready() {
local i
for i in $(seq 1 30); do
if curl --noproxy '*' -fsS -m 2 "http://127.0.0.1:${BACKEND_PORT}/api/health" >/dev/null 2>&1; then
return 0
fi
sleep 1
done
return 1
}
# 🔴 **就绪轮询(前端)**:与 wait_backend_ready 同形,轮 vite 的根路径。
# 超时 60 秒(比后端长):vite 首次启动要做依赖预打包,冷启动可能十几秒。
# 没有它 ⇒ 前端 vite 起不来(依赖没装 / 端口被占 / npm run dev 立刻报错退出)时,
# 脚本照样打印「服务已在后台启动」⇒ **脚本报成功、实际没有前端**。
# 本机 curl 走系统代理 ⇒ 必须带 --noproxy '*'。
wait_frontend_ready() {
local i
for i in $(seq 1 60); do
if curl --noproxy '*' -fsS -m 2 "http://127.0.0.1:${FRONTEND_PORT}/" >/dev/null 2>&1; then
return 0
fi
sleep 1
done
return 1
}
# 用 PID 文件优雅停(先 SIGTERM,宽限期内还在才 SIGKILL),清理 root 进程树
# 🔴 宽限期**可按进程给**:后端的优雅停机要「关嵌入式 PostgreSQL」(main.rs 给 PG 的预算是 3 秒),
# 若这里只等 1 秒就 SIGKILL ⇒ 正好把 M-9 要修的「PG 被 SIGKILL 打断 ⇒ crash recovery」又打回来。
# ⇒ 后端给 3 秒(与 main.rs 的预算对齐);前端(npm/vite)1 秒足够。
stop_pid() {
local f="$1" grace="${2:-1}"
[ -f "$f" ] || return 0
local pid
pid="$(cat "$f" 2>/dev/null || true)"
if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
echo " ↳ stop $(basename "$f") PID=$pid SIGTERM(宽限 ${grace}s)"
kill -TERM "$pid" 2>/dev/null || true
# 进程**提前退出就立刻收工**(不空等满宽限期)⇒ 0.2s 一跳地轮询存活。
# (后端实测 ~200ms 就退 ⇒ 不该为此白等 3 秒。)
local waited=0 total=$((grace * 5))
while [ "$waited" -lt "$total" ] && kill -0 "$pid" 2>/dev/null; do
sleep 0.2
waited=$((waited + 1))
done
kill -0 "$pid" 2>/dev/null && kill -KILL "$pid" 2>/dev/null || true
fi
rm -f "$f"
}
# 用 nohup 后台起,stdout/stderr 都进日志;写 PID 便于 ./run.sh stop 精准收
start_logged() {
local dir="$1" cmd="$2" name="$3"
mkdir -p "$LOGS"
: > "$LOGS/${name}.log"
(
cd "$ROOT/$dir" || exit 1
# nohup + & 把子进程从父进程会话脱离,CI/harness 退出不会拖垮服务;
# setsid 让子进程成为新进程组领头,避免父 SIGINT 误杀。
# macOS 无 setsid(Linux util-linux 专有),探测后回退纯 nohup。
if command -v setsid >/dev/null 2>&1; then
setsid nohup $cmd > "$LOGS/${name}.log" 2>&1 &
else
nohup $cmd > "$LOGS/${name}.log" 2>&1 &
fi
echo $! > "$RUN/${name}.pid"
)
echo " ↳ $name PID=$(cat "$RUN/${name}.pid") log=$LOGS/${name}.log"
}
case "${1:-}" in
-h|--help|help)
usage
;;
install)
(cd "$ROOT" && cargo fetch)
npm --prefix "$ROOT/src/frontend" install
;;
build)
(cd "$ROOT" && cargo build --release)
npm --prefix "$ROOT/src/frontend" run build
;;
dev)
# 🔴 守卫与二进制检查**都在** kill_ports **之前** ——
# 否则「用法错 / 二进制缺失」会先把 30010/5173 上的进程 kill -9 了(失败却先破坏现场)。
guard_port
if [ ! -x "$BACKEND_BIN" ]; then
echo "[启动失败] 后端二进制不存在: $BACKEND_BIN"
echo " 先跑「./run.sh build」(cargo build --release)。"
exit 1
fi
kill_ports "$BACKEND_PORT" "$FRONTEND_PORT"
mkdir -p "$LOGS" "$RUN"
# 🔴 后端 cwd = 仓库根(dir=".")⇒ 相对路径的 PGLITE_DIR 也落在仓库内。
# 🔴 命令行**不带** PORT= 前缀 —— PORT 已由 .env / export 导出,子进程继承。
start_logged . "./target/release/ssw-platform" backend
start_logged src/frontend "npm run dev" frontend
# 🔴 就绪校验:后端没真正起来 ⇒ **不许**报成功。
if ! wait_backend_ready; then
echo
echo "[启动失败] 后端在 30 秒内没就绪(/api/health 不通)。"
# 🔴 本次刚起的前端**一并收掉** —— 不许把一个 vite dev server 残在后台占着 5173
# (用户看到「启动失败」,机器上却留着一个前端 dev server,极难联想到是同一次启动留下的)。
# **两条都做**:`stop_pid` 走 PID 文件(SIGTERM → 1s → SIGKILL),
# `kill_ports` 按端口 kill -9 **兜底** ——
# 因为 `stop_pid` 依赖 npm 把 SIGTERM 转发给 vite(npm 的内部实现细节,**不是保证**),
# 有了 `kill_ports` 兜底 ⇒「不会在 5173 上留残进程」**无条件**成立。
# **不用** pkill(模式太宽会误杀别的项目)。
stop_pid "$RUN/frontend.pid"
kill_ports "$FRONTEND_PORT"
echo " ↳ 本次刚起的前端进程已一并收掉(PID 文件 SIGTERM → SIGKILL + 按端口 kill -9 兜底)"
echo "--- .logs/backend.log 尾部 ---"
tail -n 20 "$LOGS/backend.log" 2>/dev/null || true
exit 1
fi
# 🔴 就绪校验(前端):vite 起不来时同样**不许**报成功。
if ! wait_frontend_ready; then
echo
echo "[启动失败] 前端在 60 秒内没就绪(http://127.0.0.1:${FRONTEND_PORT}/ 不通)。"
# 🔴 同上:PID 文件 + 按端口兜底,两条都做 ⇒ 不在 5173 上留残进程。
stop_pid "$RUN/frontend.pid"
kill_ports "$FRONTEND_PORT"
echo " ↳ 本次刚起的前端进程已一并收掉(PID 文件 SIGTERM → SIGKILL + 按端口 kill -9 兜底)"
# 🔴 本仓既定裁决:dev 失败**不收后端**(后端可能只是慢;下一次 dev/stop 的
# kill_ports ${BACKEND_PORT} 会自愈)⇒ 但必须把后端的去留**说清楚**。
echo " ↳ 后端仍在 ${BACKEND_PORT} 上运行,要停请执行「./run.sh stop」"
echo "--- .logs/frontend.log 尾部 ---"
tail -n 20 "$LOGS/frontend.log" 2>/dev/null || true
exit 1
fi
echo
echo "服务已在后台启动(后端与前端**都已就绪**)。后端: http://127.0.0.1:${BACKEND_PORT} 前端: http://127.0.0.1:${FRONTEND_PORT}"
echo "日志:tail -f $LOGS/{backend,frontend}.log"
echo "停止:./run.sh stop"
;;
backend)
# 🔴 守卫在 kill_ports 之前(同 dev:失败却先破坏现场是不对的)。
guard_port
if [ ! -x "$BACKEND_BIN" ]; then
echo "[启动失败] 后端二进制不存在: $BACKEND_BIN"
echo " 先跑「./run.sh build」(cargo build --release)。"
exit 1
fi
kill_ports "$BACKEND_PORT"
# 🔴 用 exec ⇒ 后端**自己的**退出码原样透传(本仓二进制 panic 时是 101,不是 1)。
(cd "$ROOT" && exec ./target/release/ssw-platform)
;;
frontend)
kill_ports "$FRONTEND_PORT"
npm --prefix "$ROOT/src/frontend" run dev
;;
stop)
mkdir -p "$LOGS" "$RUN"
# 🔴 **实际的停止路径 = PID 文件(SIGTERM→SIGKILL)+ kill_ports(按端口 kill -9)**。
# pkill 只作为最后一道兜底,且**模式必须精确**:
# macOS/BSD 的 `pkill -f` 匹配的是**完整命令行**(argv 全部拼接),
# 宽模式(如按进程名)会连「命令行里提到本仓名字」的无关进程一起杀掉
# (本脚本自己、harness 的监督 shell、tail -f 日志、别的项目的 vite)。
stop_pid "$RUN/backend.pid" 3
stop_pid "$RUN/frontend.pid"
kill_ports "$BACKEND_PORT" "$FRONTEND_PORT"
# 只匹配后端本体的完整路径(cargo/rustc 的 argv 里是目录名与下划线形式,都不匹配)。
# 🔴 vite **不**用 pkill 收 —— 它由上面的 kill_ports 5173 按**端口**收,
# 不会误杀别的项目的 vite dev server。
pkill -f "target/release/ssw-platform" 2>/dev/null || true
# 🔴 旧名兜底:名称历经 `tds-lite-rs` → `ssw-jnpf-lite-rust` → `ssw-platform`,
# 改名之前起的后端进程不会被上一行 pkill 匹配到 ⇒ 这里补收一次。
pkill -f "target/release/tds-lite-rs" 2>/dev/null || true
echo "stopped"
;;
logs)
mkdir -p "$LOGS" "$RUN"
# 🔴 补 || true:日志文件不存在时 [ -f ] 返回 1,set -e 下会让脚本以 1 退出。
{ [ -f "$LOGS/backend.log" ] && echo "=== backend ===" && tail -n 50 "$LOGS/backend.log"; } || true
{ [ -f "$LOGS/frontend.log" ] && echo "=== frontend ===" && tail -n 50 "$LOGS/frontend.log"; } || true
;;
*)
usage
exit 2
;;
esac