#!/usr/bin/env bash # ============================================================ # Nex Animation Studio · 打部署包 / 推到服务器(在开发机上跑) # # ./scripts/deploy.sh 打包到 .local/deploy/*.tar.gz # ./scripts/deploy.sh --check 只体检:会带上什么、会排掉什么 # ./scripts/deploy.sh --host deploy@10.0.0.8 --path /opt/nex_animation # 打包 + 上传 + 远端 install + 重启 # ./scripts/deploy.sh --no-seed 包里不带模型配置(服务器自己从空库起) # ./scripts/deploy.sh --with-dist 连本地构建产物一起带上(服务器没有 Node 时用) # # 部署包 = 代码 + 表结构定义 + 模型配置与管理员(scripts/seed/)+ 启动脚本。 # # 打包前四道闸门,任一条不过就不出包(--check 只跑闸门、不落盘): # 1) 文件层 backend/app 与 frontend/src 各数一遍文件,证明排除清单没误伤代码 # 2) 启动层 包里的后端 import app.main 跑一次;前端从 index.html 沿 import 链走到底, # 每个被引用的模块与样式都必须存在且真的进了包 # 3) 数据层 包里的 scripts/seed.py doctor --src 量一遍包里的数据集 # (列 / 适配器 / 能力位 / 默认位 / 主密钥能否解开密文),与代码对不上就拦下 # 4) 忽略层 .gitignore 没在吃掉源码 # # 刻意**不在**包里的东西,每一条都有理由: # *.db / nex_animation.db 开发库全是过程产物(项目、镜头、任务、5000 行事件日志), # 新环境要的是干净起点,表结构由应用启动时自己建 # media/ (1.7G) 已生成的视频/图片/上传素材属于数据,换环境是「迁移」不是「部署」 # models/ (465M) whisper.cpp 权重,server.sh install 会自己下 # backend/tests/ 开发自检资产(503 条用例);服务器不需要 pytest 才能跑 # frontend/dist/ 构建产物,server.sh build 在服务器上重建,避免带过期哈希 # .venv/ node_modules/ 跨机的二进制与依赖目录,必须在目标机重装 # .env 机器相关配置(数据库串、媒体目录、鉴权开关),首装由 server.sh 生成; # 注意它**不含模型配置**——模型端点跟着 scripts/seed/ 数据包进库 # .local/ reports/ .trash/ 日志、pid、验收证据、回收站 # .git/ 版本历史是开发机资产,服务器只需要工作树 # # 上传用 rsync 而不是 scp:断网可续、只传差异,且 --delete 之外我们不删远端任何东西, # 因为 /opt/nex_animation 里可能已经有 media/(产物)、data/(库)与 .env。解压目录与包同名, # 老版本留在原地,出问题直接把 .env 指回旧目录就能回滚。 # ============================================================ set -euo pipefail ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" PY="$ROOT/.venv/bin/python" OUT_DIR="$ROOT/.local/deploy" STAMP="$(date +%Y%m%d-%H%M)" PKG_NAME="nex_animation-$STAMP" REMOTE_HOST="" REMOTE_PATH="/opt/nex_animation" WITH_SEED=1 WITH_DIST=0 CHECK_ONLY=0 DRY_REMOTE=0 if [ -t 1 ]; then C_G=$'\033[32m'; C_Y=$'\033[33m'; C_R=$'\033[31m'; C_B=$'\033[36m'; C_D=$'\033[2m'; C_0=$'\033[0m' else C_G=""; C_Y=""; C_R=""; C_B=""; C_D=""; C_0=""; fi ok() { printf ' %sok%s %s\n' "$C_G" "$C_0" "$*"; } info() { printf ' %s\n' "$*"; } warn() { printf ' %s!%s %s\n' "$C_Y" "$C_0" "$*"; } die() { printf ' %sXX%s %s\n' "$C_R" "$C_0" "$*" >&2; exit 1; } head2() { printf '\n%s%s%s\n' "$C_B" "$*" "$C_0"; } while [ $# -gt 0 ]; do case "$1" in --check) CHECK_ONLY=1 ;; --host) REMOTE_HOST="${2:?--host 需要 user@ip}"; shift ;; --path) REMOTE_PATH="${2:?--path 需要目录}"; shift ;; --out) OUT_DIR="${2:?--out 需要目录}"; shift ;; --no-seed) WITH_SEED=0 ;; --with-dist) WITH_DIST=1 ;; --dry-run) DRY_REMOTE=1 ;; # 帮助就是文件头那段注释。取范围靠「第一条 # === 到第二条 # ===」,不写死行号—— # 上一版是 sed -n '3,32p',头注释每加一行就要回来挪一次数字,很容易忘。 -h|--help) awk '/^# ={10,}/{n++; next} n==1{sub(/^# ?/, ""); print} n>1{exit}' \ "${BASH_SOURCE[0]}"; exit 0 ;; *) die "未知参数:$1(./scripts/deploy.sh --help)" ;; esac shift done command -v rsync >/dev/null || die "缺少 rsync" [ -f "$ROOT/backend/app/main.py" ] || die "看起来不是本项目根目录:找不到 backend/app/main.py" # ---------------------------------------------------------------- 排除清单 EX=(--exclude '.git/' --exclude '.github/' --exclude '.venv/' --exclude 'venv/' --exclude 'node_modules/' --exclude '__pycache__/' --exclude '*.py[cod]' --exclude '.pytest_cache/' --exclude '.mypy_cache/' --exclude '.ruff_cache/' --exclude 'backend/tests/' --include 'frontend/src/components/media/' --exclude 'media/' --exclude '/models/' --exclude '/data/' --exclude 'frontend/dist/' --exclude '/.local/' --exclude '/.trash/' --exclude '/reports/' --exclude '/dist/' --exclude '*.db' --exclude '*.db-wal' --exclude '*.db-shm' --exclude '*.sqlite3' --exclude '.env' --exclude '*.log' --exclude 'nohup.out' --exclude '*.pid' --exclude '.DS_Store' --exclude '._*' --exclude '.idea/' --exclude '.vscode/' --exclude '.Trash*') [ "$WITH_SEED" = 1 ] || EX+=(--exclude 'scripts/seed/') STAGE="$(mktemp -d "${TMPDIR:-/tmp}/nexdeploy.XXXXXX")" cleanup() { [ -n "${STAGE:-}" ] && find "$STAGE" -mindepth 1 -delete 2>/dev/null; } trap cleanup EXIT head2 "整理部署内容 → $STAGE/nex_animation" mkdir -p "$STAGE/nex_animation" rsync -a "${EX[@]}" "$ROOT/" "$STAGE/nex_animation/" # 带前导斜杠的排除项只匹配仓库根(/media/ 不会误伤 backend/app/models/ 这类代码目录), # 不带斜杠的(node_modules/、__pycache__/、media/)在任意层级生效——media/ 故意放开, # 产物目录漂到哪都不该进包;它只匹配目录,代码里的 api/media.py 不受影响(体检第 3 条会验)。 if [ "$WITH_DIST" = 1 ]; then [ -f "$ROOT/frontend/dist/index.html" ] || die "--with-dist 需要先构建:./scripts/server.sh build" rsync -a "$ROOT/frontend/dist/" "$STAGE/nex_animation/frontend/dist/" info "已附带前端产物(服务器可跳过 npm build)" fi # ---------------------------------------------------------------- 体检 D="$STAGE/nex_animation" head2 "体检" # 这份清单只留「不在任何 import 链上的构建与启动文件」:package.json、vite.config.ts、 # Dockerfile、requirements.txt 这类靠工具链而非代码引用生效的东西。 # 刻意不再列 frontend/src/ 下的源码文件名——源码谁该进包由下面的入口链路检查说了算。 # 教训就写在这一行的历史里:上一版列了 styles/tokens.css,antd 改版把它拆成 # app.css + index.css,没人记得回来改这条,--check 从此每次都死在「缺少关键文件」。 REQUIRED=(backend/app/main.py backend/app/models/__init__.py backend/requirements.txt backend/Dockerfile Dockerfile .dockerignore docker-compose.yml docker-compose.scale.yml scripts/docker-entrypoint.sh frontend/package.json frontend/tsconfig.json frontend/index.html frontend/vite.config.ts scripts/server.sh scripts/dev.sh scripts/seed.py scripts/e2e_selfcheck.py .env.example README.md) for f in "${REQUIRED[@]}"; do [ -e "$D/$f" ] || die "部署包缺少关键文件:$f" done ok "构建与启动入口齐全(${#REQUIRED[@]} 项)" # backend/app 下的 .py 必须一个不少。教训来自 --exclude 'models/':本意是排仓库根的 # whisper 权重目录(465M),rsync 的裸目录名在任意层级生效,把 backend/app/models/ # 这 11 个 ORM 文件也排掉了——体检全绿、包照打,服务器首启 ModuleNotFoundError。 # 数一遍文件比逐条猜 exclude 更可靠:只要数字不等就是有误伤。 src_py=$(find "$ROOT/backend/app" -name '*.py' -not -path '*/__pycache__/*' | wc -l | tr -d ' ') pkg_py=$(find "$D/backend/app" -name '*.py' -not -path '*/__pycache__/*' | wc -l | tr -d ' ') if [ "$src_py" != "$pkg_py" ]; then printf ' %sXX%s 后端代码不完整:源 %s 个 .py,包里只有 %s 个\n' "$C_R" "$C_0" "$src_py" "$pkg_py" >&2 diff <(cd "$ROOT/backend/app" && find . -name '*.py' -not -path '*/__pycache__/*' | sort) \ <(cd "$D/backend/app" && find . -name '*.py' -not -path '*/__pycache__/*' | sort) \ | sed -n '1,20p' >&2 die "有 --exclude 误伤了 backend/app 下的代码目录(检查上面 < 开头的行)" fi ok "后端代码完整(backend/app ${pkg_py} 个 .py 全部入包)" # 前端同理,而且更容易看漏:源码刚从 .vue 换成 .tsx,任何按扩展名写的 exclude / # 体检都会「一条都不匹配」地静默通过。服务器上是 npm run build,src 少文件 = 构建失败 # 或者构建出一个缺页面的产物,所以按后端的同一套办法数一遍。 fe_files() { [ -d "$1" ] || return 0 (cd "$1" && find . -type f \( -name '*.ts' -o -name '*.tsx' -o -name '*.css' \) | sort); } src_fe=$(fe_files "$ROOT/frontend/src" | wc -l | tr -d ' ') pkg_fe=$(fe_files "$D/frontend/src" | wc -l | tr -d ' ') if [ "$src_fe" != "$pkg_fe" ]; then printf ' %sXX%s 前端代码不完整:源 %s 个,包里只有 %s 个\n' "$C_R" "$C_0" "$src_fe" "$pkg_fe" >&2 diff <(fe_files "$ROOT/frontend/src") <(fe_files "$D/frontend/src") | sed -n '1,20p' >&2 die "有 --exclude 误伤了 frontend/src 下的源码(检查上面 < 开头的行)" fi ok "前端代码完整(frontend/src ${pkg_fe} 个源文件全部入包)" # 数文件只证明「没少带」,不证明「接得上」。这一段从 index.html 的 #