Add MusicWorkshop application
This commit is contained in:
Executable
+299
@@ -0,0 +1,299 @@
|
||||
#!/usr/bin/env bash
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
RUNTIME_DIR="$ROOT_DIR/.dev-runtime"
|
||||
|
||||
BACKEND_PID_FILE="$RUNTIME_DIR/backend.pid"
|
||||
FRONTEND_PID_FILE="$RUNTIME_DIR/frontend.pid"
|
||||
BACKEND_LOG_FILE="$RUNTIME_DIR/backend.log"
|
||||
FRONTEND_LOG_FILE="$RUNTIME_DIR/frontend.log"
|
||||
|
||||
BACKEND_HOST="127.0.0.1"
|
||||
BACKEND_PORT="8000"
|
||||
FRONTEND_HOST="127.0.0.1"
|
||||
FRONTEND_PORT="5173"
|
||||
|
||||
|
||||
usage() {
|
||||
cat <<'EOF'
|
||||
Usage: scripts/dev.sh <start|stop|restart|status>
|
||||
EOF
|
||||
}
|
||||
|
||||
|
||||
log() {
|
||||
printf '[dev] %s\n' "$*"
|
||||
}
|
||||
|
||||
|
||||
fail() {
|
||||
printf '[dev] %s\n' "$*" >&2
|
||||
exit 1
|
||||
}
|
||||
|
||||
|
||||
ensure_base_requirements() {
|
||||
[[ -x "$ROOT_DIR/backend/.venv/bin/uvicorn" ]] || fail "缺少 backend/.venv/bin/uvicorn"
|
||||
[[ -f "$ROOT_DIR/frontend/package.json" ]] || fail "缺少 frontend/package.json"
|
||||
[[ -d "$ROOT_DIR/frontend/node_modules" ]] || fail "缺少 frontend/node_modules,请先执行前端依赖安装"
|
||||
command -v npm >/dev/null 2>&1 || fail "当前环境缺少 npm"
|
||||
command -v setsid >/dev/null 2>&1 || fail "当前环境缺少 setsid"
|
||||
}
|
||||
|
||||
|
||||
ensure_runtime_dir() {
|
||||
mkdir -p "$RUNTIME_DIR"
|
||||
}
|
||||
|
||||
|
||||
pid_from_file() {
|
||||
local pid_file="$1"
|
||||
|
||||
[[ -f "$pid_file" ]] || return 1
|
||||
|
||||
local pid
|
||||
pid="$(tr -d '[:space:]' < "$pid_file")"
|
||||
[[ -n "$pid" ]] || return 1
|
||||
|
||||
printf '%s\n' "$pid"
|
||||
}
|
||||
|
||||
|
||||
is_pid_running() {
|
||||
local pid="$1"
|
||||
kill -0 "$pid" 2>/dev/null
|
||||
}
|
||||
|
||||
|
||||
cleanup_stale_pid_file() {
|
||||
local service_name="$1"
|
||||
local pid_file="$2"
|
||||
local announce="${3:-true}"
|
||||
|
||||
if pid="$(pid_from_file "$pid_file" 2>/dev/null)"; then
|
||||
if ! is_pid_running "$pid"; then
|
||||
rm -f "$pid_file"
|
||||
if [[ "$announce" == "true" ]]; then
|
||||
log "$service_name PID 文件已陈旧,已自动清理"
|
||||
fi
|
||||
fi
|
||||
elif [[ -f "$pid_file" ]]; then
|
||||
rm -f "$pid_file"
|
||||
if [[ "$announce" == "true" ]]; then
|
||||
log "$service_name PID 文件内容无效,已自动清理"
|
||||
fi
|
||||
fi
|
||||
}
|
||||
|
||||
|
||||
active_pid_from_file() {
|
||||
local pid_file="$1"
|
||||
|
||||
if pid="$(pid_from_file "$pid_file" 2>/dev/null)"; then
|
||||
if is_pid_running "$pid"; then
|
||||
printf '%s\n' "$pid"
|
||||
return 0
|
||||
fi
|
||||
fi
|
||||
|
||||
return 1
|
||||
}
|
||||
|
||||
|
||||
http_ready() {
|
||||
local url="$1"
|
||||
|
||||
"$ROOT_DIR/backend/.venv/bin/python" - "$url" <<'PY'
|
||||
import sys
|
||||
import urllib.request
|
||||
|
||||
url = sys.argv[1]
|
||||
|
||||
try:
|
||||
with urllib.request.urlopen(url, timeout=1) as response:
|
||||
status = getattr(response, 'status', 200)
|
||||
raise SystemExit(0 if 200 <= status < 400 else 1)
|
||||
except Exception:
|
||||
raise SystemExit(1)
|
||||
PY
|
||||
}
|
||||
|
||||
|
||||
wait_for_service() {
|
||||
local service_name="$1"
|
||||
local pid_file="$2"
|
||||
local health_url="$3"
|
||||
local timeout_seconds="${4:-30}"
|
||||
|
||||
local elapsed=0
|
||||
while (( elapsed < timeout_seconds )); do
|
||||
if http_ready "$health_url"; then
|
||||
return 0
|
||||
fi
|
||||
|
||||
if ! active_pid_from_file "$pid_file" >/dev/null 2>&1; then
|
||||
log "$service_name 在就绪前已退出,请检查日志"
|
||||
return 1
|
||||
fi
|
||||
|
||||
sleep 1
|
||||
elapsed=$((elapsed + 1))
|
||||
done
|
||||
|
||||
log "$service_name 在 ${timeout_seconds}s 内未就绪"
|
||||
return 1
|
||||
}
|
||||
|
||||
|
||||
start_backend() {
|
||||
: > "$BACKEND_LOG_FILE"
|
||||
(
|
||||
cd "$ROOT_DIR"
|
||||
exec setsid "$ROOT_DIR/backend/.venv/bin/uvicorn" \
|
||||
backend.app.main:app \
|
||||
--app-dir . \
|
||||
--host "$BACKEND_HOST" \
|
||||
--port "$BACKEND_PORT" \
|
||||
--reload
|
||||
) >>"$BACKEND_LOG_FILE" 2>&1 &
|
||||
echo "$!" > "$BACKEND_PID_FILE"
|
||||
}
|
||||
|
||||
|
||||
start_frontend() {
|
||||
: > "$FRONTEND_LOG_FILE"
|
||||
(
|
||||
cd "$ROOT_DIR/frontend"
|
||||
exec setsid npm run dev -- --host "$FRONTEND_HOST" --port "$FRONTEND_PORT"
|
||||
) >>"$FRONTEND_LOG_FILE" 2>&1 &
|
||||
echo "$!" > "$FRONTEND_PID_FILE"
|
||||
}
|
||||
|
||||
|
||||
stop_service() {
|
||||
local service_name="$1"
|
||||
local pid_file="$2"
|
||||
|
||||
cleanup_stale_pid_file "$service_name" "$pid_file" false
|
||||
|
||||
if ! pid="$(active_pid_from_file "$pid_file" 2>/dev/null)"; then
|
||||
log "$service_name 未运行"
|
||||
return 0
|
||||
fi
|
||||
|
||||
log "停止 $service_name (PID $pid)"
|
||||
kill -TERM -- "-$pid" 2>/dev/null || kill -TERM "$pid" 2>/dev/null || true
|
||||
|
||||
local attempt=0
|
||||
while (( attempt < 10 )); do
|
||||
if ! is_pid_running "$pid"; then
|
||||
rm -f "$pid_file"
|
||||
log "$service_name 已停止"
|
||||
return 0
|
||||
fi
|
||||
sleep 1
|
||||
attempt=$((attempt + 1))
|
||||
done
|
||||
|
||||
log "$service_name 未在预期时间内退出,强制结束"
|
||||
kill -KILL -- "-$pid" 2>/dev/null || kill -KILL "$pid" 2>/dev/null || true
|
||||
rm -f "$pid_file"
|
||||
}
|
||||
|
||||
|
||||
show_service_status() {
|
||||
local service_name="$1"
|
||||
local pid_file="$2"
|
||||
local port="$3"
|
||||
local log_file="$4"
|
||||
|
||||
if pid="$(active_pid_from_file "$pid_file" 2>/dev/null)"; then
|
||||
printf '%s: running (PID %s, port %s, log %s)\n' "$service_name" "$pid" "$port" "$log_file"
|
||||
return 0
|
||||
fi
|
||||
|
||||
if [[ -f "$pid_file" ]]; then
|
||||
rm -f "$pid_file"
|
||||
printf '%s: stale PID file removed, not running\n' "$service_name"
|
||||
return 0
|
||||
fi
|
||||
|
||||
printf '%s: not running\n' "$service_name"
|
||||
}
|
||||
|
||||
|
||||
start_all() {
|
||||
ensure_base_requirements
|
||||
ensure_runtime_dir
|
||||
|
||||
cleanup_stale_pid_file "backend" "$BACKEND_PID_FILE"
|
||||
cleanup_stale_pid_file "frontend" "$FRONTEND_PID_FILE"
|
||||
|
||||
if active_pid_from_file "$BACKEND_PID_FILE" >/dev/null 2>&1 || active_pid_from_file "$FRONTEND_PID_FILE" >/dev/null 2>&1; then
|
||||
log "检测到已有开发服务在运行,请先执行 stop 或 restart"
|
||||
show_service_status "backend" "$BACKEND_PID_FILE" "$BACKEND_PORT" "$BACKEND_LOG_FILE"
|
||||
show_service_status "frontend" "$FRONTEND_PID_FILE" "$FRONTEND_PORT" "$FRONTEND_LOG_FILE"
|
||||
return 0
|
||||
fi
|
||||
|
||||
log "启动 backend..."
|
||||
start_backend
|
||||
if ! wait_for_service "backend" "$BACKEND_PID_FILE" "http://$BACKEND_HOST:$BACKEND_PORT/api/health" 30; then
|
||||
stop_service "backend" "$BACKEND_PID_FILE" >/dev/null 2>&1 || true
|
||||
fail "backend 启动失败,请查看 $BACKEND_LOG_FILE"
|
||||
fi
|
||||
|
||||
log "启动 frontend..."
|
||||
start_frontend
|
||||
if ! wait_for_service "frontend" "$FRONTEND_PID_FILE" "http://$FRONTEND_HOST:$FRONTEND_PORT" 30; then
|
||||
stop_service "frontend" "$FRONTEND_PID_FILE" >/dev/null 2>&1 || true
|
||||
stop_service "backend" "$BACKEND_PID_FILE" >/dev/null 2>&1 || true
|
||||
fail "frontend 启动失败,请查看 $FRONTEND_LOG_FILE"
|
||||
fi
|
||||
|
||||
log "开发环境已启动"
|
||||
show_service_status "backend" "$BACKEND_PID_FILE" "$BACKEND_PORT" "$BACKEND_LOG_FILE"
|
||||
show_service_status "frontend" "$FRONTEND_PID_FILE" "$FRONTEND_PORT" "$FRONTEND_LOG_FILE"
|
||||
}
|
||||
|
||||
|
||||
stop_all() {
|
||||
stop_service "frontend" "$FRONTEND_PID_FILE"
|
||||
stop_service "backend" "$BACKEND_PID_FILE"
|
||||
}
|
||||
|
||||
|
||||
status_all() {
|
||||
show_service_status "backend" "$BACKEND_PID_FILE" "$BACKEND_PORT" "$BACKEND_LOG_FILE"
|
||||
show_service_status "frontend" "$FRONTEND_PID_FILE" "$FRONTEND_PORT" "$FRONTEND_LOG_FILE"
|
||||
}
|
||||
|
||||
|
||||
main() {
|
||||
local command="${1:-}"
|
||||
|
||||
case "$command" in
|
||||
start)
|
||||
start_all
|
||||
;;
|
||||
stop)
|
||||
stop_all
|
||||
;;
|
||||
restart)
|
||||
stop_all
|
||||
start_all
|
||||
;;
|
||||
status)
|
||||
status_all
|
||||
;;
|
||||
*)
|
||||
usage
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
|
||||
main "$@"
|
||||
Reference in New Issue
Block a user