nex_animation/scripts/docker-entrypoint.sh

53 lines
3.1 KiB
Bash
Raw Normal View History

打成 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
#!/usr/bin/env bash
# =============================================================================
# 容器入口:先把「部署数据包」灌进库,再把 PID 1 交给 uvicorn / celery。
# 人不敲它,ENTRYPOINT 敲它(Dockerfile 最后一行)。
#
# 为什么需要这一步:镜像里只有代码。模型配置、加密主密钥、管理员账号在
# ./scripts/seed/*.json —— 它被 gitignore 忽略、被 .dockerignore 排除,
# 由 compose 只读挂到 /app/scripts/seed。少了灌数据这一环,新库起来就是个空壳:
# 模型注册表是空的(只有 mock),AUTH_ENABLED=true 下连页面都登不进去。
#
# 为什么默认 --only-missing:数据集是开发机某一刻的快照,而服务器上人工调过的
# 默认位是本机事实。每次重启都按包里的值重对齐默认位,等于「重启一次配置回滚一次」。
# --only-missing 只补库里没有的行、不动已有行 —— 这条语义正是 seed.py 里刚修过的坑。
#
# 为什么灌失败不拦启动:这时 API 和页面本身是好的,缺的只是几条模型配置;
# 直接 exit 1 会让整站在「数据集比代码旧」这种小事上白屏。告警打到日志,
# `docker compose logs` 看得见,运维自己决定要不要 AUTO_SEED=force 硬灌。
#
# AUTO_SEED:only-missing 补空缺(默认)| force 包里说的算(覆盖默认位)| off 跳过
# =============================================================================
set -uo pipefail
# 根目录从脚本自己的位置反推,不写死 /app:镜像里的 WORKDIR 是 /app,
# 但把仓库换个目录跑、或在 CI 里离线复现入口契约时路径就不是它了——
# 写死会让「数据集存在与否」的判断静默变成 False,表现是空库悄悄起来了。
APP_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
SEED_DIR="$APP_ROOT/scripts/seed"
SEED_PY="$APP_ROOT/scripts/seed.py"
is_api=0
[ "${1:-}" = "uvicorn" ] && is_api=1
# worker/beat 的第一个参数是 celery,同一个库被多个容器同时灌会互相踩,只在 API 进程做一次。
mode="${AUTO_SEED:-only-missing}"
if [ "$is_api" = 1 ] && [ "$mode" != "off" ]; then
if [ -s "$SEED_DIR/model_specs.json" ]; then
seed_args=(--only-missing)
[ "$mode" = force ] && seed_args=()
echo "[entrypoint] 导入部署数据包:seed.py install ${seed_args[*]-}(AUTO_SEED=$mode)"
if ! python "$SEED_PY" install ${seed_args[@]+"${seed_args[@]}"}; then
echo "[entrypoint][warn] 数据包没灌进去(每条 error 上面都写了怎么修):服务照常启动," >&2
echo "[entrypoint][warn] 模型配置可能不完整。补灌:docker compose exec app \\" >&2
echo "[entrypoint][warn] python scripts/seed.py install --only-missing" >&2
fi
else
echo "[entrypoint] 没挂 $SEED_DIR 数据集,跳过导入:空库只有 mock 模型可用"
fi
fi
# exec 而不是直接跑:uvicorn 要当 PID 1,docker stop 的 SIGTERM 才传得进去,
# 30 秒后才会被 SIGKILL 的「超时强杀」也就不会发生(媒体写一半被杀会留脏文件)。
exec "$@"