nex_animation/Dockerfile

86 lines
4.7 KiB
Docker
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# =============================================================================
# Nex Animation Studio · 单容器整站镜像(前端产物 + 后端 + ffmpeg 装在同一个镜像里)
#
# 为什么是一个镜像而不是六个容器:这个项目跑起来只需要 SQLite 和进程内线程池。
# · TASK_EXECUTOR=inline 时 app/services/daemon.py 的守护线程顶替 celery beat 做周期派发;
# · SERVE_FRONTEND=on 时 app/main.py 直接托管 frontend/dist 并做 SPA history 回落;
# · 于是「nginx 容器 + api + worker + beat + redis」这套拆分在这里没有必然性,
# 剩下的只是一个进程、一个端口、一条数据 volume。升级 = 换镜像,数据在 ./data 不动。
# 这正是 scripts/server.sh 在裸机上跑的那套形态,只不过搬进了镜像。
# 真要多机/多 GPU 扩容,再叠加 -f docker-compose.scale.yml 切回 Postgres + Celery。
#
# 日常部署(配置读同目录 .env,模型配置与主密钥读 ./scripts/seed):
# docker compose up -d --build # 然后打开 http://localhost:8000
# docker compose logs -f app
# docker compose down # 数据留在 ./data
# 等价的裸命令:
# docker build -t nex-animation:latest .
# docker run -d --name nex-animation -p 8000:8000 \
# -v $PWD/data:/app/data -v $PWD/scripts/seed:/app/scripts/seed:ro nex-animation:latest
#
# 国内网络:BASE_IMAGE / NODE_IMAGE / PIP_INDEX_URL / NPM_REGISTRY 都能 --build-arg 覆盖,
# 默认值走清华 pip 与 npmmirror(境外构建把后两个换成官方源即可)。
# =============================================================================
ARG BASE_IMAGE=python:3.12-slim
ARG NODE_IMAGE=node:22-alpine
# ---------- 1/2 前端构建 ----------
FROM ${NODE_IMAGE} AS webbuild
ARG NPM_REGISTRY=https://registry.npmmirror.com
WORKDIR /web
# 先只拷两个清单文件:改一个 .tsx 不该让 npm ci 重跑一遍(这一层能缓存住)
COPY frontend/package.json frontend/package-lock.json ./
RUN npm config set registry "${NPM_REGISTRY}" \
&& npm ci --cache /tmp/npm-cache --no-audit --no-fund
COPY frontend/ ./
# build = tsc --noEmit && vite build:类型不过就地构建失败,比在服务器上炸便宜得多
RUN npm run build
# ---------- 2/2 运行镜像 ----------
FROM ${BASE_IMAGE}
ARG PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
ENV PYTHONUNBUFFERED=1 \
PYTHONDONTWRITEBYTECODE=1 \
PIP_NO_CACHE_DIR=1 \
PIP_DISABLE_PIP_VERSION_CHECK=1 \
TZ=Asia/Shanghai
WORKDIR /app
# ffmpeg 是硬依赖:时间线合成、抽帧、时长/码率质检全靠调它(app/services/ffmpeg.py),
# slim 基础镜像里没有,缺了它的表现是「导出成片一路 500」而不是起不来。
RUN apt-get update \
&& apt-get install -y --no-install-recommends ffmpeg \
&& rm -rf /var/lib/apt/lists/*
# 依赖单独一层:requirements.txt 里带着 psycopg,将来切 Postgres 扩容不必重建镜像骨架
COPY backend/requirements.txt ./backend/
RUN pip install --retries 5 --timeout 60 -i "${PIP_INDEX_URL}" -r backend/requirements.txt
# 代码布局保持和仓库一致(backend/ + scripts/ + frontend/dist),一个都不挪:
# app/config.py 用 parents[2] 反推仓库根、scripts/seed.py 用同一个办法找 backend/ 和数据集,
# 镜像里改布局就会让「.env 找不到」「数据集看不见」这两类静默失灵重演。
# PYTHONPATH 指向 backend/ 是为了 uvicorn、celery、seed.py 三种入口都能 import app.*——
# celery 没有 uvicorn 的 --app-dir 可用,不指它 worker 起不来。
COPY backend/app ./backend/app
COPY scripts ./scripts
COPY --from=webbuild /web/dist ./frontend/dist
# 容器内一律用绝对路径:宿主 .env 里那套 ./media、./nex_animation.db 是开发机视角,
# 换个工作目录就漂;库和媒体必须落在挂载点上才扛得住镜像升级。
ENV DATABASE_URL=sqlite:////app/data/nex_animation.db \
MEDIA_ROOT=/app/data/media \
PYTHONPATH=/app/backend \
SERVE_FRONTEND=on \
TASK_EXECUTOR=inline \
AUTO_SEED=only-missing
# 镜像以 root 运行:macOS 的 bind mount 只有 root 写 ./data 最省心。
# Linux 想换非特权账号:在 compose 里加 user: "1000:1000" 并把 ./data 属主对齐。
RUN mkdir -p /app/data/media
EXPOSE 8000
# /health 在 AUTH_ENABLED=true 时也免登录(监控探针和 server.sh verify 都靠它)。
# slim 里没有 curl,就用自带 python 探,别为一条健康检查装一串包。
HEALTHCHECK --interval=30s --timeout=5s --start-period=25s --retries=3 \
CMD python -c "import urllib.request,sys;sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:8000/health',timeout=4).status==200 else 1)"
ENTRYPOINT ["/app/scripts/docker-entrypoint.sh"]
CMD ["uvicorn","app.main:app","--host","0.0.0.0","--port","8000"]