- 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/:前端接口清单、页面依赖反查、运行时探针
278 lines
13 KiB
Bash
Executable File
278 lines
13 KiB
Bash
Executable File
#!/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
|