feat: add Linux deployment scripts (deploy/start/stop/run_eval)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
173
deploy.sh
Normal file
173
deploy.sh
Normal file
@@ -0,0 +1,173 @@
|
||||
#!/usr/bin/env bash
|
||||
# deploy.sh — Siemens RAGAS 一键部署脚本（Linux）
|
||||
# 用法：bash deploy.sh
|
||||
# 功能：检查环境 → 安装依赖 → 初始化配置 → 启动后台服务
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
cd "$SCRIPT_DIR"
|
||||
|
||||
# ── 颜色输出 ──────────────────────────────────────────────────────
|
||||
if [ -t 1 ]; then
|
||||
GREEN='\033[0;32m'; YELLOW='\033[1;33m'; RED='\033[0;31m'; CYAN='\033[0;36m'; NC='\033[0m'
|
||||
else
|
||||
GREEN=''; YELLOW=''; RED=''; CYAN=''; NC=''
|
||||
fi
|
||||
|
||||
ok() { echo -e "${GREEN}[OK]${NC} $*"; }
|
||||
warn() { echo -e "${YELLOW}[WARN]${NC} $*"; }
|
||||
err() { echo -e "${RED}[ERROR]${NC} $*" >&2; }
|
||||
info() { echo -e "${CYAN}[INFO]${NC} $*"; }
|
||||
|
||||
echo ""
|
||||
echo -e "${CYAN}============================================================${NC}"
|
||||
echo -e "${CYAN} Siemens RAGAS Console — Linux 一键部署${NC}"
|
||||
echo -e "${CYAN}============================================================${NC}"
|
||||
echo ""
|
||||
|
||||
# ── 阶段 1：Python 版本检查 ───────────────────────────────────────
|
||||
info "阶段 1/7：检查 Python 版本..."
|
||||
|
||||
PYTHON_BIN=""
|
||||
for candidate in python3.12 python3.13 python3.14 python3; do
|
||||
if command -v "$candidate" &>/dev/null; then
|
||||
version=$("$candidate" -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')" 2>/dev/null || true)
|
||||
major=$(echo "$version" | cut -d. -f1)
|
||||
minor=$(echo "$version" | cut -d. -f2)
|
||||
if [ "${major:-0}" -ge 3 ] && [ "${minor:-0}" -ge 12 ]; then
|
||||
PYTHON_BIN="$candidate"
|
||||
ok "Python $version ($candidate)"
|
||||
break
|
||||
fi
|
||||
fi
|
||||
done
|
||||
|
||||
if [ -z "$PYTHON_BIN" ]; then
|
||||
err "未找到 Python 3.12+。请安装后重试。"
|
||||
err " Ubuntu/Debian: sudo apt install python3.12 python3.12-venv"
|
||||
err " CentOS/RHEL: sudo dnf install python3.12"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# ── 阶段 2：虚拟环境 ──────────────────────────────────────────────
|
||||
info "阶段 2/7：准备虚拟环境..."
|
||||
|
||||
if [ -d ".venv" ] && [ -f ".venv/bin/python" ]; then
|
||||
ok ".venv 已存在，跳过创建"
|
||||
else
|
||||
info "创建 .venv..."
|
||||
"$PYTHON_BIN" -m venv .venv
|
||||
ok ".venv 创建完成"
|
||||
fi
|
||||
|
||||
PIP=".venv/bin/pip"
|
||||
PYTHON=".venv/bin/python"
|
||||
|
||||
# ── 阶段 3：安装依赖 ──────────────────────────────────────────────
|
||||
info "阶段 3/7：安装项目依赖（可能需要几分钟）..."
|
||||
|
||||
"$PIP" install --upgrade pip -q
|
||||
ok "pip 已升级"
|
||||
|
||||
"$PIP" install -e . -q
|
||||
ok "项目依赖安装完成（pyproject.toml）"
|
||||
|
||||
"$PIP" install fastapi uvicorn httpx -q
|
||||
ok "Web 服务依赖安装完成（fastapi / uvicorn / httpx）"
|
||||
|
||||
# ── 阶段 4：配置文件 ──────────────────────────────────────────────
|
||||
info "阶段 4/7：初始化配置文件..."
|
||||
|
||||
if [ ! -f ".env" ]; then
|
||||
cp .env.example .env
|
||||
warn ".env 已从 .env.example 复制，请编辑填写实际的 API Key 等配置后再启动："
|
||||
warn " nano .env 或 vim .env"
|
||||
warn " 关键字段：OPENAI_API_KEY, OPENAI_BASE_URL, ALIBABA_ACCESS_KEY_ID, ALIBABA_ACCESS_KEY_SECRET"
|
||||
else
|
||||
ok ".env 已存在，跳过"
|
||||
fi
|
||||
|
||||
# ── 阶段 5：目录初始化 ────────────────────────────────────────────
|
||||
info "阶段 5/7：初始化目录结构..."
|
||||
|
||||
mkdir -p configs logs outputs datasets
|
||||
ok "目录就绪：configs/ logs/ outputs/ datasets/"
|
||||
|
||||
# 确保其他脚本有执行权限
|
||||
for script in start.sh stop.sh run_eval.sh; do
|
||||
[ -f "$script" ] && chmod +x "$script"
|
||||
done
|
||||
ok "辅助脚本已设置执行权限"
|
||||
|
||||
# ── 阶段 6：Demo 数据 ─────────────────────────────────────────────
|
||||
info "阶段 6/7：初始化演示数据..."
|
||||
|
||||
DEMO_DIR="outputs/kba-knowledge-base-offline-baseline"
|
||||
if [ -d "$DEMO_DIR" ]; then
|
||||
ok "演示数据已存在，跳过"
|
||||
else
|
||||
info "生成演示数据（scripts/seed_sample_run.py）..."
|
||||
if "$PYTHON" scripts/seed_sample_run.py; then
|
||||
ok "演示数据生成完成"
|
||||
else
|
||||
warn "演示数据生成失败，控制台报告页将为空（服务仍可正常启动）"
|
||||
fi
|
||||
fi
|
||||
|
||||
# ── 阶段 7：启动服务 ──────────────────────────────────────────────
|
||||
info "阶段 7/7：启动 Web 服务..."
|
||||
|
||||
# 检查 .env 是否包含默认占位符
|
||||
if grep -q "your-api-key" .env 2>/dev/null; then
|
||||
warn ".env 中仍包含默认占位符，部分功能（评估执行）将不可用"
|
||||
warn "请编辑 .env 后重新运行 start.sh"
|
||||
fi
|
||||
|
||||
# 端口检测
|
||||
PORT=8800
|
||||
if ss -tlnp 2>/dev/null | grep -q ":$PORT " || netstat -tlnp 2>/dev/null | grep -q ":$PORT "; then
|
||||
warn "端口 $PORT 已被占用，尝试 8801..."
|
||||
PORT=8801
|
||||
if ss -tlnp 2>/dev/null | grep -q ":$PORT " || netstat -tlnp 2>/dev/null | grep -q ":$PORT "; then
|
||||
err "端口 8800 和 8801 均被占用。请手动运行："
|
||||
err " .venv/bin/python webmain.py --host 0.0.0.0 --port <PORT>"
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
# 清理残留 PID
|
||||
if [ -f ".server.pid" ]; then
|
||||
OLD_PID=$(cat .server.pid)
|
||||
if kill -0 "$OLD_PID" 2>/dev/null; then
|
||||
warn "检测到已有服务进程 (PID=$OLD_PID)，停止旧进程..."
|
||||
kill "$OLD_PID" 2>/dev/null || true
|
||||
sleep 1
|
||||
fi
|
||||
rm -f .server.pid
|
||||
fi
|
||||
|
||||
# 后台启动
|
||||
nohup "$PYTHON" webmain.py --host 0.0.0.0 --port "$PORT" >> logs/server.log 2>&1 &
|
||||
SERVER_PID=$!
|
||||
echo "$SERVER_PID" > .server.pid
|
||||
|
||||
# 等待 3 秒验证进程存活
|
||||
sleep 3
|
||||
if kill -0 "$SERVER_PID" 2>/dev/null; then
|
||||
ok "服务已启动 (PID=$SERVER_PID)"
|
||||
echo ""
|
||||
echo -e "${CYAN}============================================================${NC}"
|
||||
echo -e "${GREEN} 部署成功！${NC}"
|
||||
echo -e "${GREEN} 访问地址: http://$(hostname -I | awk '{print $1}'):${PORT}${NC}"
|
||||
echo -e "${GREEN} 本机访问: http://127.0.0.1:${PORT}${NC}"
|
||||
echo -e "${CYAN} 服务日志: tail -f logs/server.log${NC}"
|
||||
echo -e "${CYAN} 停止服务: bash stop.sh${NC}"
|
||||
echo -e "${CYAN}============================================================${NC}"
|
||||
echo ""
|
||||
else
|
||||
err "服务启动失败，请查看日志："
|
||||
err " tail -20 logs/server.log"
|
||||
rm -f .server.pid
|
||||
exit 1
|
||||
fi
|
||||
Reference in New Issue
Block a user