zkxw/backend/start-prod.sh

#!/bin/bash

# ============================================
# 陇耘鲜达 Backend 生产环境启动脚本
# 适配: python3.9+（推荐 venv；显式不使用 python2）
#
# 生产服务器目录示例: /root/zkxw-backend/backend
# 默认监听: 0.0.0.0:8111（可通过环境变量 PORT 覆盖）
#
# 首次部署:
#   cd /root/zkxw-backend/backend
#   cp .env.example .env.production   # 填写数据库、Redis、MinIO、SECRET_KEY 等
#   python3 -m venv venv && ./venv/bin/pip install -r requirements.txt
#   ./start-prod.sh start
# ============================================

set -euo pipefail

BASE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
cd "$BASE_DIR"

APP_MODULE="${APP_MODULE:-app.main:app}"
HOST="${HOST:-0.0.0.0}"
PORT="${PORT:-8111}"
WORKERS="${WORKERS:-2}"
LOG_LEVEL="${LOG_LEVEL:-info}"
ENV_FILE="${ENV_FILE:-$BASE_DIR/.env.production}"

VENV_DIR="${VENV_DIR:-$BASE_DIR/venv}"
PYTHON_BIN="${PYTHON_BIN:-$VENV_DIR/bin/python}"
UVICORN_BIN="${UVICORN_BIN:-$VENV_DIR/bin/uvicorn}"

LOG_DIR="$BASE_DIR/logs"
LOG_FILE="$LOG_DIR/backend-prod.log"
PID_FILE="$BASE_DIR/backend-prod.pid"

RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'

log_info() {
  echo -e "${GREEN}[INFO]${NC} $1"
}

log_warn() {
  echo -e "${YELLOW}[WARN]${NC} $1"
}

log_error() {
  echo -e "${RED}[ERROR]${NC} $1"
}

show_help() {
  cat << 'EOF'
用法:
  ./start-prod.sh [start|stop|restart|status|logs]

命令:
  start     启动服务(默认)
  stop      停止服务
  restart   重启服务
  status    查看状态
  logs      查看日志(最近100行)

可选环境变量:
  HOST=0.0.0.0
  PORT=8111
  WORKERS=2
  LOG_LEVEL=info
  APP_MODULE=app.main:app
  VENV_DIR=./venv
  ENV_FILE=./.env.production

生产部署目录（示例）:
  /root/zkxw-backend/backend

  cd /root/zkxw-backend/backend && ./start-prod.sh start
EOF
}

ensure_dirs() {
  mkdir -p "$LOG_DIR"
}

check_python() {
  if ! command -v python3 >/dev/null 2>&1; then
    log_error "未找到 python3，请安装 python3.9+"
    exit 1
  fi

  local py_ver
  py_ver="$(python3 -c 'import sys; print("{}.{}".format(sys.version_info[0], sys.version_info[1]))')"
  log_info "系统 python3 版本: $py_ver"
}

ensure_venv_and_runtime() {
  if [ ! -d "$VENV_DIR" ]; then
    log_warn "未找到虚拟环境，开始自动创建: $VENV_DIR"
    if ! python3 -m venv "$VENV_DIR" >/dev/null 2>&1; then
      log_error "自动创建 venv 失败，请先安装 python3-venv 或手动创建虚拟环境"
      log_warn "可尝试: yum install -y python3-venv 或 python3 -m ensurepip --upgrade"
      exit 1
    fi
  fi

  if [ ! -x "$PYTHON_BIN" ]; then
    log_error "虚拟环境 python 不存在: $PYTHON_BIN"
    exit 1
  fi

  if [ ! -x "$VENV_DIR/bin/pip" ]; then
    log_warn "虚拟环境 pip 不存在，尝试引导安装"
    "$PYTHON_BIN" -m ensurepip --upgrade >/dev/null 2>&1 || true
  fi

  if [ ! -x "$UVICORN_BIN" ]; then
    log_warn "未检测到 uvicorn，开始安装依赖 requirements.txt"
    if [ ! -x "$VENV_DIR/bin/pip" ]; then
      log_error "pip 仍不可用，请手动执行依赖初始化"
      exit 1
    fi
    "$VENV_DIR/bin/pip" install -r "$BASE_DIR/requirements.txt"
    if [ ! -x "$UVICORN_BIN" ]; then
      log_error "依赖安装后仍未找到 uvicorn: $UVICORN_BIN"
      exit 1
    fi
  fi
}

is_running() {
  if [ ! -f "$PID_FILE" ]; then
    return 1
  fi

  local pid
  pid="$(cat "$PID_FILE")"
  if [ -z "$pid" ]; then
    return 1
  fi

  if ps -p "$pid" >/dev/null 2>&1; then
    return 0
  fi

  return 1
}

start_server() {
  check_python
  ensure_venv_and_runtime
  ensure_dirs

  if is_running; then
    local running_pid
    running_pid="$(cat "$PID_FILE")"
    log_warn "服务已在运行 (PID: $running_pid)"
    exit 0
  fi

  if [ -f "$PID_FILE" ]; then
    rm -f "$PID_FILE"
  fi

  log_info "启动生产服务..."
  log_info "监听地址: $HOST:$PORT"
  log_info "工作进程: $WORKERS"
  log_info "日志文件: $LOG_FILE"
  log_info "环境文件: $ENV_FILE"

  if [ ! -f "$ENV_FILE" ]; then
    log_error "环境文件不存在: $ENV_FILE"
    exit 1
  fi

  export ENV_FILE
  nohup "$UVICORN_BIN" "$APP_MODULE" \
    --host "$HOST" \
    --port "$PORT" \
    --workers "$WORKERS" \
    --log-level "$LOG_LEVEL" \
    >> "$LOG_FILE" 2>&1 &

  echo $! > "$PID_FILE"
  sleep 2

  if is_running; then
    log_info "服务启动成功 (PID: $(cat "$PID_FILE"))"
    log_info "健康检查: http://127.0.0.1:$PORT/health"
  else
    log_error "服务启动失败，请检查日志: $LOG_FILE"
    rm -f "$PID_FILE"
    exit 1
  fi
}

stop_server() {
  if ! is_running; then
    log_warn "服务未运行"
    [ -f "$PID_FILE" ] && rm -f "$PID_FILE"
    exit 0
  fi

  local pid
  pid="$(cat "$PID_FILE")"
  log_info "正在停止服务 (PID: $pid)"
  kill -TERM "$pid" >/dev/null 2>&1 || true

  for _ in 1 2 3 4 5 6 7 8 9 10; do
    if ! ps -p "$pid" >/dev/null 2>&1; then
      break
    fi
    sleep 1
  done

  if ps -p "$pid" >/dev/null 2>&1; then
    log_warn "优雅停止超时，执行强制停止"
    kill -9 "$pid" >/dev/null 2>&1 || true
  fi

  rm -f "$PID_FILE"
  log_info "服务已停止"
}

status_server() {
  if is_running; then
    echo -e "${GREEN}RUNNING${NC} PID=$(cat "$PID_FILE") HOST=$HOST PORT=$PORT"
  else
    echo -e "${RED}STOPPED${NC}"
  fi
}

show_logs() {
  ensure_dirs
  if [ ! -f "$LOG_FILE" ]; then
    log_warn "暂无日志文件: $LOG_FILE"
    exit 0
  fi
  # 生产排障时常用最近日志
  tail -n 100 "$LOG_FILE"
}

ACTION="${1:-start}"
case "$ACTION" in
  start)
    start_server
    ;;
  stop)
    stop_server
    ;;
  restart)
    stop_server || true
    start_server
    ;;
  status)
    status_server
    ;;
  logs)
    show_logs
    ;;
  -h|--help|help)
    show_help
    ;;
  *)
    log_error "未知命令: $ACTION"
    show_help
    exit 1
    ;;
esac