Files
hunjing/docker/backend/Dockerfile
T
2026-08-21 16:00:13 +08:00

48 lines
1.9 KiB
Docker

# ==============================
# 灵台 · 魂镜后端镜像(Backend / FastAPI):Python 3.12 + uv
# 启动入口 entrypoint.sh:先按 *_ENABLED 开关用 wait-for-it 等待依赖就绪,再 uv run python -m app.main
# 工作目录 /app/backend,使 .env 中的相对路径 ../db ../logs ../config ../storage 解析到 /app 下。
# ==============================
FROM python:3.12-slim
ENV PYTHONUNBUFFERED=1 \
PYTHONDONTWRITEBYTECODE=1 \
UV_LINK_MODE=copy \
UV_COMPILE_BYTECODE=1 \
TZ=Asia/Shanghai
WORKDIR /app/backend
# 系统依赖:
# build-essential / libpq-dev —— 编译 asyncpg、argon2 等 C 扩展
# curl —— 容器健康检查
# tzdata —— 时区数据
# netcat-openbsd —— wait-for-it 端口探测
RUN apt-get update && apt-get install -y --no-install-recommends \
build-essential libpq-dev curl tzdata netcat-openbsd \
&& rm -rf /var/lib/apt/lists/* \
&& ln -snf "/usr/share/zoneinfo/$TZ" /etc/localtime && echo "$TZ" > /etc/timezone
# 安装 uv(沿用 backend/pyproject.toml 的清华镜像源,加速国内构建)
RUN pip install --no-cache-dir uv -i https://pypi.tuna.tsinghua.edu.cn/simple
# 先复制依赖清单,最大化 Docker 层缓存命中
COPY backend/pyproject.toml backend/uv.lock ./
# 安装生产依赖(排除 dev 组、暂不安装项目本体)
RUN uv sync --frozen --no-dev --no-install-project
# 复制后端源码并安装项目本体
COPY backend/ ./
RUN uv sync --frozen --no-dev
# 启动顺序:wait-for-it(端口探测工具)+ entrypoint.sh(按开关动态等待依赖后启动应用)
COPY docker/backend/wait-for-it.sh /usr/local/bin/wait-for-it.sh
COPY docker/backend/entrypoint.sh /app/backend/entrypoint.sh
RUN chmod +x /usr/local/bin/wait-for-it.sh /app/backend/entrypoint.sh
EXPOSE 8000
# entrypoint 等待依赖就绪后 exec 应用;如需覆盖启动命令,覆盖此 ENTRYPOINT 即可
ENTRYPOINT ["/app/backend/entrypoint.sh"]