86 lines
4.7 KiB
Docker
86 lines
4.7 KiB
Docker
# =============================================================================
|
||
# 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"]
|