nex_animation/scripts/deploy.sh

390 lines
22 KiB
Bash
Raw Normal View History

2026-11-01 08:18:07 +00:00
#!/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/)+ 启动脚本。
#
2026-11-05 08:53:24 +00:00
# 打包前四道闸门,任一条不过就不出包(--check 只跑闸门、不落盘):
# 1) 文件层 backend/app 与 frontend/src 各数一遍文件,证明排除清单没误伤代码
# 2) 启动层 包里的后端 import app.main 跑一次;前端从 index.html 沿 import 链走到底,
# 每个被引用的模块与样式都必须存在且真的进了包
# 3) 数据层 包里的 scripts/seed.py doctor --src 量一遍包里的数据集
# (列 / 适配器 / 能力位 / 默认位 / 主密钥能否解开密文),与代码对不上就拦下
# 4) 忽略层 .gitignore 没在吃掉源码
#
2026-11-01 08:18:07 +00:00
# 刻意**不在**包里的东西,每一条都有理由:
# *.db / nex_animation.db 开发库全是过程产物(项目、镜头、任务、5000 行事件日志),
# 新环境要的是干净起点,表结构由应用启动时自己建
# media/ (1.7G) 已生成的视频/图片/上传素材属于数据,换环境是「迁移」不是「部署」
# models/ (465M) whisper.cpp 权重,server.sh install 会自己下
2026-11-05 08:53:24 +00:00
# backend/tests/ 开发自检资产(503 条用例);服务器不需要 pytest 才能跑
2026-11-01 08:18:07 +00:00
# frontend/dist/ 构建产物,server.sh build 在服务器上重建,避免带过期哈希
# .venv/ node_modules/ 跨机的二进制与依赖目录,必须在目标机重装
模型配置全部交给数据库,.env 只管进程参数;media 从库里搬出来单独一个挂载点 上一版把容器收成一个之后,剩下的口径不一致是「模型配在哪」有两处说法: .env 里能写 COMFYUI_BASE_URL / VIDEO_PROVIDER / TTS_*,模型中心页面也能改, 而运行时 config_json 优先——于是"改了没生效"和"到底哪条说了算"变成日常问题。 搬家的判据写成一句话放进工程规范:**换模型要不要重启进程**。要,就说明它站错了队。 另外三条理由:① 换 GPU 机是日常操作,不该要求改 .env 再 up --force-recreate; ② API / worker / beat 三个进程必须读同一份模型事实,写 .env 就是三份; ③ 地址与 Key 进库才有审计(谁改的、什么时候)与探测记录。 media 分家是同一批的诉求:产物只涨不跌,会长到几十上百 GB,迟早要单独挪大盘、 做增量备份、被 rsync 与剪辑软件直接读,和"一个不能写坏的 SQLite"绑在同一个挂载点 就得整目录停服拷走。代价说清楚:备份清单从一条变两条。 改动 · 划界:.env / .env.example 里 VIDEO_* / COMFYUI_* / TTS_* 一律清零(脚本核对过, 43 个键全部对应 Settings 字段或 compose 插值键,无未知键、无模型键),模板头部 写明"为什么这里没有模型配置"与新的排障口径(先去页面点 🔌 探测)。补回四个 原本漏在模板外的进程参数 FFMPEG_BIN/FFPROBE_BIN/QC_VISUAL_*/QC_ASR_ENABLED。 · Dockerfile / docker-compose.yml / docker-compose.scale.yml:MEDIA_ROOT 从 /app/data/media 改成 /app/media 并新增 ./media 挂载;worker 同步挂两个目录 (否则「worker 写完了页面看不到」),beat 不读写产物所以不挂;compose 里删掉 COMFYUI_BASE_URL 透传,注释说明"去模型中心改 base_url,改完即生效"。 · 后端三处悄悄降级要一起清掉,否则 env 一空就把真实默认位打回 Mock: api/system.py 不再用 settings.video_provider/tts_provider 覆盖页面默认位; services/audio.py 的 resolve_tts_spec 候选去掉 settings.tts_provider(未设供应商的 声线会静默 Mock 配音,只有听成片才发现);providers/registry.py 的 _dedupe_defaults 改按「真实模型 > 启用 > 登记顺序」裁决,两条 mock 行的 is_default 交给 _has_real_spec 闸门而不是 env。config.py 的模型字段保留为代码级兜底并写明两个用处。 · 两个启停脚本原来都是 curl .env 里的 COMFYUI_BASE_URL 探活——现在探的是废弃地址, 绿字反而误导:dev.sh / server.sh 的 status 改成登录取 /api/providers, 把库里在册且启用的 base_url 去重后逐个探(comfy 探 /system_stats)。 dev.sh 顺带修两处历史问题:/api/providers 在 AUTH_ENABLED=true 下 401 被打印成 "模型注册表读取失败"(现在先登录);非 2xx 被 urllib 当异常抛,LLM 根路径 404 会误判 unreachable(有 HTTP 应答即算机器活着,真可用性以页面探测为准)。env_value 随之无人引用,两个脚本各删一份。 · 文档:README §3.2 挂载表 3 行→4 行(含"少挂 media 会怎样")+ 备份清单两条、 「常用改动」表把 ComfyUI 一行改成页面操作、§4.0 重写(事实源 + 三条理由 + 三种接入路径 + COMFYUI_BASE_URL 逃生门 + 排障顺序);工程规范 §5 加"配置分两层"、 硬约束 #3 与数据边界表同步;deploy.sh / dev.sh 提示语同步。 验证(真跑) · 全量后端用例 502 passed / 1 skipped;conftest 新增钉住 COMFYUI_BASE_URL, 否则 comfyui 三条不登记,断言会跟着开发机 .env 漂(这正是删完 .env 才暴露的隐性污染)。 · HOST_PORT=8010 docker compose up -d --build → 12 秒 healthy;容器里没有任何模型 env, /api/providers 仍是 8 条、默认位四条全真(comfyui/minimax-h3 · qwen-image-2.1-turbo · indextts2 · qwen/qwen3.7-plus),默认位是 entrypoint 从 ./scripts/seed 灌进去的。 · media 挂载双向实测:容器内写 /app/media/_mount_probe.txt → 宿主 media/ 立即可见; 宿主已有 1.8G 产物经容器读回 200(/media/1/generated/shot-02-task2.mp4 2.8MB video/mp4); 走真实接口 POST /api/projects/1/assets 上传,落盘 media/1/reference/*.png 并能在页面直出。 · ./scripts/deploy.sh --check 19 项全绿;seed.py doctor/boundary 通过; dev.sh status 与 server.sh status 均正确报出 http://10.100.53.199:9200 reachable、 dashscope 报 HTTP 404(有应答)。冒烟产生的 media 两个探针文件与 ./data 移入 .trash/2026-11-05/smoke-media-mount/,宿主库与产物未留垃圾。
2026-11-05 10:17:47 +00:00
# .env 机器相关配置(数据库串、媒体目录、鉴权开关),首装由 server.sh 生成;
# 注意它**不含模型配置**——模型端点跟着 scripts/seed/ 数据包进库
2026-11-01 08:18:07 +00:00
# .local/ reports/ .trash/ 日志、pid、验收证据、回收站
# .git/ 版本历史是开发机资产,服务器只需要工作树
2026-11-01 08:18:07 +00:00
#
# 上传用 rsync 而不是 scp:断网可续、只传差异,且 --delete 之外我们不删远端任何东西,
模型配置全部交给数据库,.env 只管进程参数;media 从库里搬出来单独一个挂载点 上一版把容器收成一个之后,剩下的口径不一致是「模型配在哪」有两处说法: .env 里能写 COMFYUI_BASE_URL / VIDEO_PROVIDER / TTS_*,模型中心页面也能改, 而运行时 config_json 优先——于是"改了没生效"和"到底哪条说了算"变成日常问题。 搬家的判据写成一句话放进工程规范:**换模型要不要重启进程**。要,就说明它站错了队。 另外三条理由:① 换 GPU 机是日常操作,不该要求改 .env 再 up --force-recreate; ② API / worker / beat 三个进程必须读同一份模型事实,写 .env 就是三份; ③ 地址与 Key 进库才有审计(谁改的、什么时候)与探测记录。 media 分家是同一批的诉求:产物只涨不跌,会长到几十上百 GB,迟早要单独挪大盘、 做增量备份、被 rsync 与剪辑软件直接读,和"一个不能写坏的 SQLite"绑在同一个挂载点 就得整目录停服拷走。代价说清楚:备份清单从一条变两条。 改动 · 划界:.env / .env.example 里 VIDEO_* / COMFYUI_* / TTS_* 一律清零(脚本核对过, 43 个键全部对应 Settings 字段或 compose 插值键,无未知键、无模型键),模板头部 写明"为什么这里没有模型配置"与新的排障口径(先去页面点 🔌 探测)。补回四个 原本漏在模板外的进程参数 FFMPEG_BIN/FFPROBE_BIN/QC_VISUAL_*/QC_ASR_ENABLED。 · Dockerfile / docker-compose.yml / docker-compose.scale.yml:MEDIA_ROOT 从 /app/data/media 改成 /app/media 并新增 ./media 挂载;worker 同步挂两个目录 (否则「worker 写完了页面看不到」),beat 不读写产物所以不挂;compose 里删掉 COMFYUI_BASE_URL 透传,注释说明"去模型中心改 base_url,改完即生效"。 · 后端三处悄悄降级要一起清掉,否则 env 一空就把真实默认位打回 Mock: api/system.py 不再用 settings.video_provider/tts_provider 覆盖页面默认位; services/audio.py 的 resolve_tts_spec 候选去掉 settings.tts_provider(未设供应商的 声线会静默 Mock 配音,只有听成片才发现);providers/registry.py 的 _dedupe_defaults 改按「真实模型 > 启用 > 登记顺序」裁决,两条 mock 行的 is_default 交给 _has_real_spec 闸门而不是 env。config.py 的模型字段保留为代码级兜底并写明两个用处。 · 两个启停脚本原来都是 curl .env 里的 COMFYUI_BASE_URL 探活——现在探的是废弃地址, 绿字反而误导:dev.sh / server.sh 的 status 改成登录取 /api/providers, 把库里在册且启用的 base_url 去重后逐个探(comfy 探 /system_stats)。 dev.sh 顺带修两处历史问题:/api/providers 在 AUTH_ENABLED=true 下 401 被打印成 "模型注册表读取失败"(现在先登录);非 2xx 被 urllib 当异常抛,LLM 根路径 404 会误判 unreachable(有 HTTP 应答即算机器活着,真可用性以页面探测为准)。env_value 随之无人引用,两个脚本各删一份。 · 文档:README §3.2 挂载表 3 行→4 行(含"少挂 media 会怎样")+ 备份清单两条、 「常用改动」表把 ComfyUI 一行改成页面操作、§4.0 重写(事实源 + 三条理由 + 三种接入路径 + COMFYUI_BASE_URL 逃生门 + 排障顺序);工程规范 §5 加"配置分两层"、 硬约束 #3 与数据边界表同步;deploy.sh / dev.sh 提示语同步。 验证(真跑) · 全量后端用例 502 passed / 1 skipped;conftest 新增钉住 COMFYUI_BASE_URL, 否则 comfyui 三条不登记,断言会跟着开发机 .env 漂(这正是删完 .env 才暴露的隐性污染)。 · HOST_PORT=8010 docker compose up -d --build → 12 秒 healthy;容器里没有任何模型 env, /api/providers 仍是 8 条、默认位四条全真(comfyui/minimax-h3 · qwen-image-2.1-turbo · indextts2 · qwen/qwen3.7-plus),默认位是 entrypoint 从 ./scripts/seed 灌进去的。 · media 挂载双向实测:容器内写 /app/media/_mount_probe.txt → 宿主 media/ 立即可见; 宿主已有 1.8G 产物经容器读回 200(/media/1/generated/shot-02-task2.mp4 2.8MB video/mp4); 走真实接口 POST /api/projects/1/assets 上传,落盘 media/1/reference/*.png 并能在页面直出。 · ./scripts/deploy.sh --check 19 项全绿;seed.py doctor/boundary 通过; dev.sh status 与 server.sh status 均正确报出 http://10.100.53.199:9200 reachable、 dashscope 报 HTTP 404(有应答)。冒烟产生的 media 两个探针文件与 ./data 移入 .trash/2026-11-05/smoke-media-mount/,宿主库与产物未留垃圾。
2026-11-05 10:17:47 +00:00
# 因为 /opt/nex_animation 里可能已经有 media/(产物)、data/(库)与 .env。解压目录与包同名,
2026-11-01 08:18:07 +00:00
# 老版本留在原地,出问题直接把 .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 ;;
2026-11-05 08:53:24 +00:00
# 帮助就是文件头那段注释。取范围靠「第一条 # === 到第二条 # ===」,不写死行号——
# 上一版是 sed -n '3,32p',头注释每加一行就要回来挪一次数字,很容易忘。
-h|--help) awk '/^# ={10,}/{n++; next} n==1{sub(/^# ?/, ""); print} n>1{exit}' \
"${BASH_SOURCE[0]}"; exit 0 ;;
2026-11-01 08:18:07 +00:00
*) 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/'
打成 Docker 只留一个容器:前端产物与后端同进程同端口,Postgres/Redis/Celery 收成可选扩容层 compose 原本是六个容器(db/redis/api/worker/beat/web),那是「前后端分离 + 独立 broker」 时代的遗产。这个项目实际跑的是 SQLite + TASK_EXECUTOR=inline(进程内线程池,周期派发交给 app/services/daemon.py 的守护线程),前端产物由 SERVE_FRONTEND=on 让后端一并托管—— 就是 scripts/server.sh 在裸机上跑的那套形态。多出来的三个组件在这里只增加故障面: 连不上的 db、没人消费的 broker、「api 起来了 worker 没起所以任务永远 pending」。 新增 · Dockerfile:两段式。node 阶段 npm ci && npm run build(tsc --noEmit 不过就地失败, 比在服务器上炸便宜);运行阶段 python:3.12-slim + apt ffmpeg(时间线合成/抽帧/质检的 硬依赖,缺它的表现是「导出成片一路 500」而不是起不来)。镜像内保持仓库布局 backend/ + scripts/ + frontend/dist:app/config.py 与 scripts/seed.py 都靠 parents[N] 反推根目录,布局一改就是「.env 找不到」「数据集看不见」两类静默失灵。 BASE_IMAGE/NODE_IMAGE/PIP_INDEX_URL/NPM_REGISTRY 全部可 --build-arg 覆盖。 · .dockerignore:刻意排除 scripts/seed —— 加密主密钥不能烘进镜像层,谁拉镜像谁拿到它。 · scripts/docker-entrypoint.sh:首启把挂载进来的部署数据包灌进库(AUTO_SEED= only-missing|force|off),灌失败只告警不拦启动(缺的只是几条模型配置,页面和 API 是好的); 末尾 exec 让 uvicorn 当 PID 1,docker stop 的 SIGTERM 才传得进去。根目录从脚本自身位置 反推而不是写死 /app:写死会让「数据集存在与否」的判断在换目录时静默变成 False。 · docker-compose.scale.yml:真要多机/多 GPU 才叠这层切回 Postgres + Redis + worker + beat, 页面仍由 app 这一个容器提供(SERVE_FRONTEND 没被动过)。 改动 · docker-compose.yml 重写成单 service:对外只有 HOST_PORT 一个端口(容器内固定 8000, 与 EXPOSE/HEALTHCHECK 对齐),数据三处 bind mount——./data(库+media)、 ./scripts/seed:ro(机密)、./models:ro;comfyui 降级成 profile。 · seed.py install 的「目标库已有业务数据」两档模式分开报:覆盖式保持黄色告警, --only-missing 一行都不动已有数据,而容器每次重启都会走到这里——跑了几天的服务器上 必然有 event_logs,每次都黄一条等于训练运维无视黄条,降级成一行普通提示。 · deploy.sh 必带清单加四个 Docker 文件(现 19 项)、包内排除新增的 /data/; server.sh 注释里的 docker-compose 指向改成 scale 层;.env.example 新增「Docker 部署」一节; README §3.2 整段重写(含挂载表、AUTO_SEED 三档、扩容叠加、国内 registry 实测命令)、 §3.4 补「同一份部署包也能直接跑 docker」;工程规范 §1 根目录白名单与 §2 脚本表同步。 验证(真跑,不是纸面推演) · docker compose config --services = app(默认一个);叠 scale 层 = db redis beat worker app。 · docker build 成功(685MB,本机直连不到 docker.io,改用 swr 镜像源的 python:3.12-slim + node:22-alpine 走通,npm ci 34.8s / vite build 12.7s / ffmpeg 221s)。 · HOST_PORT=8010 docker compose up -d 12 秒到 healthy;首启日志「模型配置:新增 8」 「前端产物已托管:/app/frontend/dist」「执行后端=inline ffmpeg=True」。 · / 与 /projects/3/storyboard 回落同一 index.html;/assets/index-*.js 200/216KB; /api/nope 是 401 JSON 而不是被 SPA 兜底成 HTML;登录后 /api/providers 返回 8 条配置 + 四个默认位;/app/scripts/seed 确认 Read-only file system。 · 把 tts 默认位手工改成 mock 后 restart:日志「保留本机默认位不改」,重启后仍是 mock; AUTO_SEED=force 时按包覆盖回 comfyui/indextts2。celery 入口与 AUTO_SEED=off 都不灌数据。 · 优雅停止:SIGTERM 后 0s 走完「Shutting down → 内联调度守护线程已停止 → shutdown complete」。 · 开发库 nex_animation.db mtime 纹丝没动;down 之后 ./data 完好;deploy.sh --check 全绿(19 项)。
2026-11-05 09:39:12 +00:00
--exclude '/models/' --exclude '/data/' --exclude 'frontend/dist/' --exclude '/.local/'
2026-11-01 08:18:07 +00:00
--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 "体检"
2026-11-05 08:53:24 +00:00
# 这份清单只留「不在任何 import 链上的构建与启动文件」:package.json、vite.config.ts、
# Dockerfile、requirements.txt 这类靠工具链而非代码引用生效的东西。
# 刻意不再列 frontend/src/ 下的源码文件名——源码谁该进包由下面的入口链路检查说了算。
# 教训就写在这一行的历史里:上一版列了 styles/tokens.css,antd 改版把它拆成
# app.css + index.css,没人记得回来改这条,--check 从此每次都死在「缺少关键文件」。
2026-11-01 08:18:07 +00:00
REQUIRED=(backend/app/main.py backend/app/models/__init__.py backend/requirements.txt
打成 Docker 只留一个容器:前端产物与后端同进程同端口,Postgres/Redis/Celery 收成可选扩容层 compose 原本是六个容器(db/redis/api/worker/beat/web),那是「前后端分离 + 独立 broker」 时代的遗产。这个项目实际跑的是 SQLite + TASK_EXECUTOR=inline(进程内线程池,周期派发交给 app/services/daemon.py 的守护线程),前端产物由 SERVE_FRONTEND=on 让后端一并托管—— 就是 scripts/server.sh 在裸机上跑的那套形态。多出来的三个组件在这里只增加故障面: 连不上的 db、没人消费的 broker、「api 起来了 worker 没起所以任务永远 pending」。 新增 · Dockerfile:两段式。node 阶段 npm ci && npm run build(tsc --noEmit 不过就地失败, 比在服务器上炸便宜);运行阶段 python:3.12-slim + apt ffmpeg(时间线合成/抽帧/质检的 硬依赖,缺它的表现是「导出成片一路 500」而不是起不来)。镜像内保持仓库布局 backend/ + scripts/ + frontend/dist:app/config.py 与 scripts/seed.py 都靠 parents[N] 反推根目录,布局一改就是「.env 找不到」「数据集看不见」两类静默失灵。 BASE_IMAGE/NODE_IMAGE/PIP_INDEX_URL/NPM_REGISTRY 全部可 --build-arg 覆盖。 · .dockerignore:刻意排除 scripts/seed —— 加密主密钥不能烘进镜像层,谁拉镜像谁拿到它。 · scripts/docker-entrypoint.sh:首启把挂载进来的部署数据包灌进库(AUTO_SEED= only-missing|force|off),灌失败只告警不拦启动(缺的只是几条模型配置,页面和 API 是好的); 末尾 exec 让 uvicorn 当 PID 1,docker stop 的 SIGTERM 才传得进去。根目录从脚本自身位置 反推而不是写死 /app:写死会让「数据集存在与否」的判断在换目录时静默变成 False。 · docker-compose.scale.yml:真要多机/多 GPU 才叠这层切回 Postgres + Redis + worker + beat, 页面仍由 app 这一个容器提供(SERVE_FRONTEND 没被动过)。 改动 · docker-compose.yml 重写成单 service:对外只有 HOST_PORT 一个端口(容器内固定 8000, 与 EXPOSE/HEALTHCHECK 对齐),数据三处 bind mount——./data(库+media)、 ./scripts/seed:ro(机密)、./models:ro;comfyui 降级成 profile。 · seed.py install 的「目标库已有业务数据」两档模式分开报:覆盖式保持黄色告警, --only-missing 一行都不动已有数据,而容器每次重启都会走到这里——跑了几天的服务器上 必然有 event_logs,每次都黄一条等于训练运维无视黄条,降级成一行普通提示。 · deploy.sh 必带清单加四个 Docker 文件(现 19 项)、包内排除新增的 /data/; server.sh 注释里的 docker-compose 指向改成 scale 层;.env.example 新增「Docker 部署」一节; README §3.2 整段重写(含挂载表、AUTO_SEED 三档、扩容叠加、国内 registry 实测命令)、 §3.4 补「同一份部署包也能直接跑 docker」;工程规范 §1 根目录白名单与 §2 脚本表同步。 验证(真跑,不是纸面推演) · docker compose config --services = app(默认一个);叠 scale 层 = db redis beat worker app。 · docker build 成功(685MB,本机直连不到 docker.io,改用 swr 镜像源的 python:3.12-slim + node:22-alpine 走通,npm ci 34.8s / vite build 12.7s / ffmpeg 221s)。 · HOST_PORT=8010 docker compose up -d 12 秒到 healthy;首启日志「模型配置:新增 8」 「前端产物已托管:/app/frontend/dist」「执行后端=inline ffmpeg=True」。 · / 与 /projects/3/storyboard 回落同一 index.html;/assets/index-*.js 200/216KB; /api/nope 是 401 JSON 而不是被 SPA 兜底成 HTML;登录后 /api/providers 返回 8 条配置 + 四个默认位;/app/scripts/seed 确认 Read-only file system。 · 把 tts 默认位手工改成 mock 后 restart:日志「保留本机默认位不改」,重启后仍是 mock; AUTO_SEED=force 时按包覆盖回 comfyui/indextts2。celery 入口与 AUTO_SEED=off 都不灌数据。 · 优雅停止:SIGTERM 后 0s 走完「Shutting down → 内联调度守护线程已停止 → shutdown complete」。 · 开发库 nex_animation.db mtime 纹丝没动;down 之后 ./data 完好;deploy.sh --check 全绿(19 项)。
2026-11-05 09:39:12 +00:00
backend/Dockerfile Dockerfile .dockerignore docker-compose.yml
docker-compose.scale.yml scripts/docker-entrypoint.sh
frontend/package.json frontend/tsconfig.json
2026-11-05 08:53:24 +00:00
frontend/index.html frontend/vite.config.ts
scripts/server.sh scripts/dev.sh scripts/seed.py scripts/e2e_selfcheck.py
打成 Docker 只留一个容器:前端产物与后端同进程同端口,Postgres/Redis/Celery 收成可选扩容层 compose 原本是六个容器(db/redis/api/worker/beat/web),那是「前后端分离 + 独立 broker」 时代的遗产。这个项目实际跑的是 SQLite + TASK_EXECUTOR=inline(进程内线程池,周期派发交给 app/services/daemon.py 的守护线程),前端产物由 SERVE_FRONTEND=on 让后端一并托管—— 就是 scripts/server.sh 在裸机上跑的那套形态。多出来的三个组件在这里只增加故障面: 连不上的 db、没人消费的 broker、「api 起来了 worker 没起所以任务永远 pending」。 新增 · Dockerfile:两段式。node 阶段 npm ci && npm run build(tsc --noEmit 不过就地失败, 比在服务器上炸便宜);运行阶段 python:3.12-slim + apt ffmpeg(时间线合成/抽帧/质检的 硬依赖,缺它的表现是「导出成片一路 500」而不是起不来)。镜像内保持仓库布局 backend/ + scripts/ + frontend/dist:app/config.py 与 scripts/seed.py 都靠 parents[N] 反推根目录,布局一改就是「.env 找不到」「数据集看不见」两类静默失灵。 BASE_IMAGE/NODE_IMAGE/PIP_INDEX_URL/NPM_REGISTRY 全部可 --build-arg 覆盖。 · .dockerignore:刻意排除 scripts/seed —— 加密主密钥不能烘进镜像层,谁拉镜像谁拿到它。 · scripts/docker-entrypoint.sh:首启把挂载进来的部署数据包灌进库(AUTO_SEED= only-missing|force|off),灌失败只告警不拦启动(缺的只是几条模型配置,页面和 API 是好的); 末尾 exec 让 uvicorn 当 PID 1,docker stop 的 SIGTERM 才传得进去。根目录从脚本自身位置 反推而不是写死 /app:写死会让「数据集存在与否」的判断在换目录时静默变成 False。 · docker-compose.scale.yml:真要多机/多 GPU 才叠这层切回 Postgres + Redis + worker + beat, 页面仍由 app 这一个容器提供(SERVE_FRONTEND 没被动过)。 改动 · docker-compose.yml 重写成单 service:对外只有 HOST_PORT 一个端口(容器内固定 8000, 与 EXPOSE/HEALTHCHECK 对齐),数据三处 bind mount——./data(库+media)、 ./scripts/seed:ro(机密)、./models:ro;comfyui 降级成 profile。 · seed.py install 的「目标库已有业务数据」两档模式分开报:覆盖式保持黄色告警, --only-missing 一行都不动已有数据,而容器每次重启都会走到这里——跑了几天的服务器上 必然有 event_logs,每次都黄一条等于训练运维无视黄条,降级成一行普通提示。 · deploy.sh 必带清单加四个 Docker 文件(现 19 项)、包内排除新增的 /data/; server.sh 注释里的 docker-compose 指向改成 scale 层;.env.example 新增「Docker 部署」一节; README §3.2 整段重写(含挂载表、AUTO_SEED 三档、扩容叠加、国内 registry 实测命令)、 §3.4 补「同一份部署包也能直接跑 docker」;工程规范 §1 根目录白名单与 §2 脚本表同步。 验证(真跑,不是纸面推演) · docker compose config --services = app(默认一个);叠 scale 层 = db redis beat worker app。 · docker build 成功(685MB,本机直连不到 docker.io,改用 swr 镜像源的 python:3.12-slim + node:22-alpine 走通,npm ci 34.8s / vite build 12.7s / ffmpeg 221s)。 · HOST_PORT=8010 docker compose up -d 12 秒到 healthy;首启日志「模型配置:新增 8」 「前端产物已托管:/app/frontend/dist」「执行后端=inline ffmpeg=True」。 · / 与 /projects/3/storyboard 回落同一 index.html;/assets/index-*.js 200/216KB; /api/nope 是 401 JSON 而不是被 SPA 兜底成 HTML;登录后 /api/providers 返回 8 条配置 + 四个默认位;/app/scripts/seed 确认 Read-only file system。 · 把 tts 默认位手工改成 mock 后 restart:日志「保留本机默认位不改」,重启后仍是 mock; AUTO_SEED=force 时按包覆盖回 comfyui/indextts2。celery 入口与 AUTO_SEED=off 都不灌数据。 · 优雅停止:SIGTERM 后 0s 走完「Shutting down → 内联调度守护线程已停止 → shutdown complete」。 · 开发库 nex_animation.db mtime 纹丝没动;down 之后 ./data 完好;deploy.sh --check 全绿(19 项)。
2026-11-05 09:39:12 +00:00
.env.example README.md)
2026-11-01 08:18:07 +00:00
for f in "${REQUIRED[@]}"; do
[ -e "$D/$f" ] || die "部署包缺少关键文件:$f"
done
2026-11-05 08:53:24 +00:00
ok "构建与启动入口齐全(${#REQUIRED[@]} 项)"
2026-11-01 08:18:07 +00:00
# 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} 个源文件全部入包)"
2026-11-05 08:53:24 +00:00
# 数文件只证明「没少带」,不证明「接得上」。这一段从 index.html 的
# <script type="module"> 出发,把 static import、`export … from`、路由懒加载的
# `import('../pages/X')`、以及 CSS 里的 `@import "./app.css"` 一路解析到底:
# · 说明符在源码树里解析不到 = 本地就断链,npm build 同样过不去;
# · 解析到了但包里没这个文件 = 某条 --exclude 精准误伤了它,服务器构建才炸。
# 两种情况都在这里停住。用入口链当清单还有个额外好处:文件改名、拆分、挪目录
# 都不需要回来维护任何人手写的列表(上一条 REQUIRED 里的 tokens.css 就是这么烂掉的)。
# 裸名 import(react、antd、zustand…)跳过:那是 npm 依赖,服务器 npm install 提供,
# 而 node_modules/ 是刻意不带进包的跨机二进制。
fe_log="$STAGE/fe-graph.txt" fe_err="$STAGE/fe-graph.err"
# 输出走文件而不是 $( … ):bash 找右括号时会被 python 里的 r'''…''' 引号
# 绕晕,报 unexpected EOF while looking for matching `)',症状离病根很远,别踩。
if ! "$PY" - "$ROOT/frontend" "$D/frontend" > "$fe_log" 2> "$fe_err" <<'PYEOF'
import os, re, sys
root, pkg = sys.argv[1], sys.argv[2]
# 说明符常常不写扩展名('./Button'、'../pages/Login'),按 Vite 的习惯逐个试;
# 目录形式补 index.*,这是 src/components/ui/index.ts 那批桶文件的引用方式。
EXTS = ["", ".ts", ".tsx", ".js", ".jsx", ".mjs", ".css", ".json",
"/index.ts", "/index.tsx", "/index.css"]
ENTRY = re.compile(r'''<script[^>]*\btype=["']module["'][^>]*\bsrc=["']([^"']+)''', re.I)
JS = re.compile(r'''(?:^|[\s;{}()])(?:import|export)\s(?:[^'"()]*?\sfrom\s*)?["']([^"']+)["']'''
r'''|\bimport[ \t]*\(\s*["']([^"']+)["']\s*\)''', re.M)
CSS = re.compile(r'''@import\s+(?:url\(\s*)?["']([^"']+)["']''', re.M)
def resolve(spec, base):
"""import 说明符 → frontend/ 下的相对路径;解析不到返回 None。"""
if spec.startswith("@/"): # vite.config.ts 里的 alias
cands = [os.path.join("src", spec[2:] + e) for e in EXTS]
elif spec.startswith("/"): # index.html 的 /src/main.tsx
cands = [spec.lstrip("/") + e for e in EXTS]
else:
d = os.path.dirname(base)
cands = [os.path.normpath(os.path.join(d, spec + e)) for e in EXTS]
for c in cands:
if os.path.isfile(os.path.join(root, c)):
return c
return None
html = open(os.path.join(root, "index.html"), encoding="utf-8").read()
entries = [m.group(1).lstrip("/") for m in ENTRY.finditer(html)]
if not entries:
sys.exit("index.html 里找不到 <script type=\"module\">,前端入口是什么?")
broken, todo, seen = [], list(entries), set()
for p in entries:
if not os.path.isfile(os.path.join(root, p)):
broken.append(f"index.html 的入口 {p} 不存在")
while todo:
f = todo.pop()
if f in seen or not os.path.isfile(os.path.join(root, f)):
continue
seen.add(f)
text = open(os.path.join(root, f), encoding="utf-8").read()
for m in (CSS if f.endswith(".css") else JS).finditer(text):
spec = m.group(1) or m.group(2)
if not spec or not spec.startswith((".", "/", "@/")):
continue
hit = resolve(spec, f)
if hit is None:
broken.append(f"源码断链:{f} 引用 {spec},文件不存在")
elif hit not in seen:
todo.append(hit)
lost = sorted(f for f in seen if not os.path.isfile(os.path.join(pkg, f)))
for line in broken:
print(line, file=sys.stderr)
for f in lost:
print(f"包内缺失:{f} 被入口引用,却没进部署包(检查 --exclude)", file=sys.stderr)
print(f"{len(entries)} 个入口 → {len(seen)} 个模块/样式全部可达且全部在包内")
sys.exit(1 if (broken or lost) else 0)
PYEOF
then
sed -n '1,20p' "$fe_err" >&2
die "前端入口链路不通:服务器上 npm run build 会原样失败"
fi
ok "前端入口链路完整:$(cat "$fe_log")"
2026-11-01 08:18:07 +00:00
# 再往前一步:直接 import 一次。文件数对了不代表包能起来(少 __init__.py、
# 循环依赖、误排子包都会在这里现形),而它在开发机上只要一秒。
# 用临时 SQLite 库:默认 DATABASE_URL 指向 Postgres,开发机的 venv 里没装 psycopg。
smoke=$(mktemp -d "${TMPDIR:-/tmp}/nexsmoke.XXXXXX")
# PYTHONDONTWRITEBYTECODE:不加的话这次 import 会往暂存树里写 62 个 .pyc(约 1.6M),
# 统计和打包都在它后面,构建产物就跟着上服务器了。
if ! (cd "$D/backend" && PYTHONPATH=. PYTHONDONTWRITEBYTECODE=1 \
DATABASE_URL="sqlite://///${smoke}/smoke.db" \
MEDIA_ROOT="$smoke/media" TASK_EXECUTOR=inline "$PY" -c \
"import app.main; print(len(app.main.app.routes))") > "$smoke/out" 2> "$smoke/err"; then
printf ' %sXX%s 部署包里的后端 import 失败(服务器首启会原样复现):\n' "$C_R" "$C_0" >&2
sed -n '1,12p' "$smoke/err" >&2
die "别打包了,先修上面的问题"
fi
ok "后端可启动:import app.main 通过($(cat "$smoke/out") 条路由)"
find "$smoke" -mindepth 1 -delete 2>/dev/null; rmdir "$smoke" 2>/dev/null || true
打成 Docker 只留一个容器:前端产物与后端同进程同端口,Postgres/Redis/Celery 收成可选扩容层 compose 原本是六个容器(db/redis/api/worker/beat/web),那是「前后端分离 + 独立 broker」 时代的遗产。这个项目实际跑的是 SQLite + TASK_EXECUTOR=inline(进程内线程池,周期派发交给 app/services/daemon.py 的守护线程),前端产物由 SERVE_FRONTEND=on 让后端一并托管—— 就是 scripts/server.sh 在裸机上跑的那套形态。多出来的三个组件在这里只增加故障面: 连不上的 db、没人消费的 broker、「api 起来了 worker 没起所以任务永远 pending」。 新增 · Dockerfile:两段式。node 阶段 npm ci && npm run build(tsc --noEmit 不过就地失败, 比在服务器上炸便宜);运行阶段 python:3.12-slim + apt ffmpeg(时间线合成/抽帧/质检的 硬依赖,缺它的表现是「导出成片一路 500」而不是起不来)。镜像内保持仓库布局 backend/ + scripts/ + frontend/dist:app/config.py 与 scripts/seed.py 都靠 parents[N] 反推根目录,布局一改就是「.env 找不到」「数据集看不见」两类静默失灵。 BASE_IMAGE/NODE_IMAGE/PIP_INDEX_URL/NPM_REGISTRY 全部可 --build-arg 覆盖。 · .dockerignore:刻意排除 scripts/seed —— 加密主密钥不能烘进镜像层,谁拉镜像谁拿到它。 · scripts/docker-entrypoint.sh:首启把挂载进来的部署数据包灌进库(AUTO_SEED= only-missing|force|off),灌失败只告警不拦启动(缺的只是几条模型配置,页面和 API 是好的); 末尾 exec 让 uvicorn 当 PID 1,docker stop 的 SIGTERM 才传得进去。根目录从脚本自身位置 反推而不是写死 /app:写死会让「数据集存在与否」的判断在换目录时静默变成 False。 · docker-compose.scale.yml:真要多机/多 GPU 才叠这层切回 Postgres + Redis + worker + beat, 页面仍由 app 这一个容器提供(SERVE_FRONTEND 没被动过)。 改动 · docker-compose.yml 重写成单 service:对外只有 HOST_PORT 一个端口(容器内固定 8000, 与 EXPOSE/HEALTHCHECK 对齐),数据三处 bind mount——./data(库+media)、 ./scripts/seed:ro(机密)、./models:ro;comfyui 降级成 profile。 · seed.py install 的「目标库已有业务数据」两档模式分开报:覆盖式保持黄色告警, --only-missing 一行都不动已有数据,而容器每次重启都会走到这里——跑了几天的服务器上 必然有 event_logs,每次都黄一条等于训练运维无视黄条,降级成一行普通提示。 · deploy.sh 必带清单加四个 Docker 文件(现 19 项)、包内排除新增的 /data/; server.sh 注释里的 docker-compose 指向改成 scale 层;.env.example 新增「Docker 部署」一节; README §3.2 整段重写(含挂载表、AUTO_SEED 三档、扩容叠加、国内 registry 实测命令)、 §3.4 补「同一份部署包也能直接跑 docker」;工程规范 §1 根目录白名单与 §2 脚本表同步。 验证(真跑,不是纸面推演) · docker compose config --services = app(默认一个);叠 scale 层 = db redis beat worker app。 · docker build 成功(685MB,本机直连不到 docker.io,改用 swr 镜像源的 python:3.12-slim + node:22-alpine 走通,npm ci 34.8s / vite build 12.7s / ffmpeg 221s)。 · HOST_PORT=8010 docker compose up -d 12 秒到 healthy;首启日志「模型配置:新增 8」 「前端产物已托管:/app/frontend/dist」「执行后端=inline ffmpeg=True」。 · / 与 /projects/3/storyboard 回落同一 index.html;/assets/index-*.js 200/216KB; /api/nope 是 401 JSON 而不是被 SPA 兜底成 HTML;登录后 /api/providers 返回 8 条配置 + 四个默认位;/app/scripts/seed 确认 Read-only file system。 · 把 tts 默认位手工改成 mock 后 restart:日志「保留本机默认位不改」,重启后仍是 mock; AUTO_SEED=force 时按包覆盖回 comfyui/indextts2。celery 入口与 AUTO_SEED=off 都不灌数据。 · 优雅停止:SIGTERM 后 0s 走完「Shutting down → 内联调度守护线程已停止 → shutdown complete」。 · 开发库 nex_animation.db mtime 纹丝没动;down 之后 ./data 完好;deploy.sh --check 全绿(19 项)。
2026-11-05 09:39:12 +00:00
FORBIDDEN=(nex_animation.db data backend/tests media models .venv frontend/node_modules reports .local .trash)
2026-11-01 08:18:07 +00:00
bad=()
for f in "${FORBIDDEN[@]}"; do
if [ -e "$D/$f" ]; then bad+=("$f"); fi
done
if [ "${#bad[@]}" -gt 0 ]; then
printf ' %sXX%s 部署包里出现了不该有的东西:%s\n' "$C_R" "$C_0" "${bad[*]-}" >&2
die "请检查上面的 --exclude 清单"
fi
ok "开发产物已全部排除($(IFS=' '; echo "${FORBIDDEN[*]}"))"
# 镜像检查:上一条管「打包别多带」,这一条管「提交别少带」。
# 起因是同一个坑——`models/` 少个前导斜杠,backend/app/models/ 整个 ORM 目录
# 就同时从包和仓库里消失了,而两边都不会报错。这里把全部后端/前端源文件
# 喂给 git check-ignore,任何命中都说明某条忽略规则写宽了。
# 用临时 git 目录跑:--no-index + 独立 GIT_DIR 让它只看 .gitignore,
# 不受本仓库索引状态影响(换机器、CI 里跑结果都一样)。
2026-11-01 08:18:07 +00:00
if command -v git >/dev/null 2>&1; then
ign=$(mktemp -d "${TMPDIR:-/tmp}/nexign.XXXXXX"); git init -q "$ign"
find "$ROOT/backend/app" "$ROOT/frontend/src" -type f \
\( -name '*.py' -o -name '*.ts' -o -name '*.tsx' -o -name '*.css' \) \
2026-11-01 08:18:07 +00:00
-not -path '*/__pycache__/*' | sed "s|^$ROOT/||" | sort > "$ign/src.txt"
GIT_DIR="$ign/.git" GIT_WORK_TREE="$ROOT" \
git check-ignore --no-index --stdin < "$ign/src.txt" > "$ign/eaten.txt" || true
n_code=$(wc -l < "$ign/src.txt" | tr -d ' ')
if [ -s "$ign/eaten.txt" ]; then
printf ' %sXX%s .gitignore 正在吃掉代码文件(提交时它们会凭空消失):\n' "$C_R" "$C_0" >&2
sed -n '1,20p' "$ign/eaten.txt" >&2
die "名字撞上代码目录的规则必须带前导斜杠锚根(对照 .gitignore 里 /models/ 那段说明)"
fi
find "$ign" -mindepth 1 -delete 2>/dev/null || true; rmdir "$ign" 2>/dev/null || true
ok ".gitignore 无误伤:$n_code 个后端/前端源文件全部可提交"
else
warn "没装 git,跳过 .gitignore 误伤检查"
fi
2026-11-05 08:53:24 +00:00
SEED_SUMMARY="" SEED_DEFAULTS="" SEED_STAMP=""
2026-11-01 08:18:07 +00:00
if [ "$WITH_SEED" = 1 ]; then
for f in model_specs.json model_secret_keys.json users.json; do
2026-11-05 08:53:24 +00:00
[ -s "$D/scripts/seed/$f" ] || die "scripts/seed/$f 缺失或为空:先在开发机跑 .venv/bin/python scripts/seed.py export --fix"
2026-11-01 08:18:07 +00:00
done
2026-11-05 08:53:24 +00:00
# 数据层闸门:跑**包里的** seed.py 量**包里的** JSON。两边都用包内副本,
# 过检的才是「这份代码 + 这份数据」这个组合本身——服务器上 install 执行的正是它们;
# 拿开发机工作树的脚本来量包,代码改了却没重新导出时照样绿灯。
# DATABASE_URL 指内存库:doctor --src 只读 JSON 不碰库,但 seed.py import 时会建 engine,
# 默认串指向 Postgres 的话开发机上这一步会直接连不上。
seed_log="$STAGE/seed-doctor.txt"
if ! (cd "$D" && PYTHONDONTWRITEBYTECODE=1 DATABASE_URL="sqlite:///:memory:" \
"$PY" scripts/seed.py doctor --src scripts/seed) > "$seed_log" 2>&1; then
printf ' %sXX%s 部署数据集与包内代码对不上(服务器上 install 会拒装):\n' "$C_R" "$C_0" >&2
sed -n '1,40p' "$seed_log" >&2
die "开发机上跑 .venv/bin/python scripts/seed.py doctor --fix,重新 export --fix 后再打包"
2026-11-01 08:18:07 +00:00
fi
2026-11-05 08:53:24 +00:00
SEED_SUMMARY=$(sed -n 's/^ 数据集://p' "$seed_log" | head -1)
SEED_DEFAULTS=$(sed -n 's/^ 默认位://p' "$seed_log" | head -1)
SEED_STAMP=$("$PY" -c "import json,sys;print(json.load(open(sys.argv[1]))['_meta'].get('exported_at','?'))" \
"$D/scripts/seed/model_specs.json" 2>/dev/null || echo "?")
ok "部署数据集体检通过:$SEED_SUMMARY"
info "${C_D}导出时间 $SEED_STAMP · 默认位 $SEED_DEFAULTS${C_0}"
2026-11-01 08:18:07 +00:00
else
warn "--no-seed:服务器将从空库启动,只有 mock 模型可用"
fi
big=$(find "$D" -type f -size +20M 2>/dev/null | head -5)
if [ -n "$big" ]; then warn "包里有大文件,确认是否该带:$(echo "$big" | tr '\n' ' ')"; fi
find "$D" -type f -name '.DS_Store' -delete 2>/dev/null || true
TOTAL_FILES=$(find "$D" -type f | wc -l | tr -d ' ')
TOTAL_SIZE=$(du -sh "$D" | cut -f1)
info "共 $TOTAL_FILES 个文件,$TOTAL_SIZE"
printf ' %s目录概览%s\n' "$C_D" "$C_0"
(cd "$D" && du -sh */ .[^.]*/ 2>/dev/null | sort -h | sed 's/^/ /') || true
{
echo "Nex Animation Studio 部署包"
echo "生成时间 : $(date '+%F %T %Z')"
echo "生成机器 : $(hostname)"
echo "源目录 : $ROOT"
echo "文件数 : $TOTAL_FILES 体积: $TOTAL_SIZE"
2026-11-05 08:53:24 +00:00
echo "模型配置 : $([ "$WITH_SEED" = 1 ] && echo "随包(scripts/seed/,导出于 $SEED_STAMP)· $SEED_SUMMARY" || echo '未随包(--no-seed,空库起 mock)')"
echo "默认位 : $([ "$WITH_SEED" = 1 ] && echo "${SEED_DEFAULTS:-(未标注)}" || echo '(无)')"
2026-11-01 08:18:07 +00:00
echo "前端产物 : $([ "$WITH_DIST" = 1 ] && echo '随包' || echo '服务器上 server.sh build 生成')"
2026-11-05 08:53:24 +00:00
echo "体检 : 打包前已通过 backend import / 前端入口链路 / seed doctor 三道闸门"
echo " (seed.py doctor 与服务器 install 用的是同一把尺子,装前还会再量一次)"
2026-11-01 08:18:07 +00:00
echo
echo "服务器三步:"
echo " tar -xzf $PKG_NAME.tar.gz && cd nex_animation"
echo " ./scripts/server.sh install # 装依赖 + 建表 + 导入模型配置与管理员"
echo " ./scripts/server.sh start && ./scripts/server.sh verify"
} > "$D/DEPLOY-INFO.txt"
# 兜底清扫:字节码残渣不该进包,无论是谁写的(rsync 排掉了 __pycache__,
# 但上面的 import、以及本地跑过的 seed.py 都可能现造)。
find "$D" -name '*.py[co]' -delete 2>/dev/null || true
find "$D" -type d -name '__pycache__' -empty -delete 2>/dev/null || true
if [ "$CHECK_ONLY" = 1 ]; then
head2 "--check:到此为止,未打包"
exit 0
fi
# ---------------------------------------------------------------- 打包
mkdir -p "$OUT_DIR"
PKG="$OUT_DIR/$PKG_NAME.tar.gz"
head2 "打包"
# COPYFILE_DISABLE=1:macOS 的 bsdtar 默认把 xattr 写成 ._* 伴生文件,
# Linux 解包后到处是垃圾 dot 文件,构建时还会被 vite 当模块扫到。
COPYFILE_DISABLE=1 tar -czf "$PKG" -C "$STAGE" nex_animation
[ -f "$PKG" ] || die "打包失败"
ok "$PKG($(du -sh "$PKG" | cut -f1))"
if [ -n "$REMOTE_HOST" ]; then
head2 "上传 $REMOTE_HOST:$REMOTE_PATH"
ssh "$REMOTE_HOST" "mkdir -p '$REMOTE_PATH'" || die "无法登录 $REMOTE_HOST 或创建 $REMOTE_PATH"
RSYNC_UP=(rsync -az --info=progress2)
[ "$DRY_REMOTE" = 1 ] && RSYNC_UP+=(--dry-run)
"${RSYNC_UP[@]}" "$PKG" "$REMOTE_HOST:$REMOTE_PATH/" || die "上传失败"
ok "已上传"
if [ "$DRY_REMOTE" = 1 ]; then
info "--dry-run:不执行远端安装"
exit 0
fi
head2 "远端安装并重启"
# .env 与 media/ 不在包里,所以解覆盖式包不会动到它们;这里也不加 --delete。
ssh -t "$REMOTE_HOST" "set -e
cd '$REMOTE_PATH'
tar -xzf '$PKG_NAME.tar.gz'
cd nex_animation
./scripts/server.sh install
./scripts/server.sh restart
./scripts/server.sh status" || die "远端安装失败(上面是远端输出)"
info "${C_B}完成${C_0} ssh $REMOTE_HOST 后可用 ./scripts/server.sh logs 看日志"
else
head2 "下一步"
info "1) 传包:rsync -az '$PKG' deploy@server:/opt/"
info "2) 解包:ssh deploy@server 'cd /opt && tar -xzf $PKG_NAME.tar.gz && cd nex_animation'"
info "3) 安装:./scripts/server.sh install"
info "4) 启动:./scripts/server.sh start && ./scripts/server.sh verify"
info "${C_D}或者一步到位:./scripts/deploy.sh --host deploy@server --path /opt/nex_animation${C_0}"
fi