unis-oa/Dockerfile

126 lines
7.1 KiB
Docker
Raw Permalink 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.

# syntax=docker/dockerfile:1
# =============================================================================
# UnisOA 容器镜像:前端 pnpm 构建 + 后端 FastAPI(uvicorn)
# -----------------------------------------------------------------------------
# 构建(上下文是仓库根目录,别只给 backend/):
# docker build -t unisoa:latest .
# 跑(配置在宿主机上挂进来,密钥不进镜像):
# docker run -d --name unisoa -p 8000:8000 \
# -e OA_ENV=prod \
# -v "$PWD/deploy/config:/etc/unisoa:ro" \
# -v unisoa-storage:/app/backend/storage \
# unisoa:latest
# 或者直接 docker compose up -d(见 docker-compose.yml)。
#
# 配置文件在容器里怎么找(跟 app/config.py 一致):
# /app/backend/config.toml 镜像里带的公共基础值(跟代码同版本,不含密钥)
# /app/backend/config.prod.toml 镜像里带的生产档——仓库里有 backend/config.prod.toml
# 就跟着构建烤进来(.dockerignore 单给它开了例外),
# 于是 docker run 不挂 -v 也能起;代价是密钥进了镜像层,
# 公开仓库人人可 pull 得走。不想烤就删掉那行例外。
# /etc/unisoa/config.toml 挂载目录里的基础值,盖在上面那份上(可以只写 [env] name)
# /etc/unisoa/config.prod.toml 本档差异:库地址账号、密钥、MinIO……(密钥只走这里)
# 叠的顺序从低到高就这四行:挂进来的 config.prod.toml 压过镜像里烤的那份,
# 挂进来的 config.toml 压不过镜像里烤的 config.prod.toml(要覆盖就用前者或 OA_* 环境变量)。
# 档位由 -e OA_ENV 决定;不想传变量就在挂载的 config.toml 里写 [env] name = "prod"。
# 起来了看日志第一行 config: 环境=... 就知道读的是哪几份;也可以
# docker exec unisoa python scripts/what_config.py
# 入口用的是仓库里的 scripts/prod-api.sh:这一档的配置文件不在就直接退出(不会
# 闷头连代码默认的 127.0.0.1),想更严就 -e OA_STRICT_CONFIG=1,体检没过不起服务。
#
# ⚠️ TZ 一定要对:审批超时、定时同步时间点、单号日期都按 datetime.now() 算,
# 容器默认 UTC 会把 01:00 的同步挪到北京时间 09:00。这里烤进镜像了。
# =============================================================================
# -----------------------------------------------------------------------------
# 1) 前端:装依赖 + vite 构建出 dist
# -----------------------------------------------------------------------------
# Node 24:pnpm 11(package.json 里钉的那个大版本)要求 Node >= 22,
# 用 20 会在 corepack 起 pnpm 时炸 ERR_UNKNOWN_BUILTIN_MODULE
# 前端产物与 CPU 架构无关,编译这一步跟着**构建机自己的架构**跑:Apple Silicon 上打
# amd64 镜像时,整包 vue-tsc + vite 在 QEMU 里要跑几十分钟,原生跑一两分钟就完。
# 需要 amd64 的只有下面那个运行镜像(K3S 机器是 x86_64),那一档照旧由 --platform 决定。
ARG BUILDPLATFORM
FROM --platform=$BUILDPLATFORM node:24-bookworm-slim AS web
# 换源加速(国内网络建议在 docker-compose.yml 里覆盖成 npmmirror)
ARG NPM_REGISTRY=https://registry.npmjs.org
# Corepack 抓 pnpm 本体的那一下**不看** pnpm 的 --registry,只认这个变量:
# 不把它指向同一个镜像源,构建就会卡在 registry.npmjs.org 上(拉不到就一直挂着)。
ENV COREPACK_NPM_REGISTRY=${NPM_REGISTRY}
# 构建号:手机首页右上角显示的就是它。打镜像时与 tag 用同一个值——
# docker build --build-arg OA_APP_BUILD=202611031830 -t …:202611031830 .
# 于是手机上那一串 == 集群里那个 Pod 的镜像 tag。留空则退回构建那一刻的时间戳。
ARG OA_APP_BUILD=
ENV OA_APP_BUILD=${OA_APP_BUILD}
WORKDIR /src
COPY frontend/package.json frontend/pnpm-lock.yaml frontend/pnpm-workspace.yaml frontend/.npmrc ./
# pnpm 版本跟着 package.json 的 packageManager 走(lockfile 是谁生成的就用谁装,
# 换大版本会报 ERR_PNPM_LOCKFILE_CONFIG_MISMATCH,所以不在这里写死)
# 依赖缓存放进 BuildKit 缓存卷,改代码重打镜像时不必重新下载一遍
RUN --mount=type=cache,target=/root/.local/share/pnpm/store \
corepack enable \
&& pnpm install --frozen-lockfile --registry="${NPM_REGISTRY}"
COPY frontend/ ./
RUN pnpm build
# -----------------------------------------------------------------------------
# 2) 运行镜像:只带 Python 依赖、后端代码和前端产物
# -----------------------------------------------------------------------------
FROM python:3.11-slim AS runtime
ENV PYTHONUNBUFFERED=1 \
PYTHONDONTWRITEBYTECODE=1 \
PIP_NO_CACHE_DIR=1 \
TZ=Asia/Shanghai \
OA_CONFIG_DIR=/etc/unisoa
# tzdata:让 TZ 真正生效(datetime.now() 走本地时区)
RUN apt-get update \
&& apt-get install -y --no-install-recommends tzdata \
&& ln -snf "/usr/share/zoneinfo/$TZ" /etc/localtime \
&& echo "$TZ" > /etc/timezone \
&& rm -rf /var/lib/apt/lists/*
WORKDIR /app/backend
# 换源加速(国内网络建议覆盖成 https://pypi.tuna.tsinghua.edu.cn/simple)
ARG PIP_INDEX_URL=https://pypi.org/simple
COPY backend/requirements.txt ./
RUN pip install --no-cache-dir --index-url "${PIP_INDEX_URL}" -r requirements.txt
# 后端代码 + 前端产物(app/main.py 认 backend/web/dist 这个位置)
COPY backend/ ./
COPY --from=web /src/dist ./web/dist
# 生产档是否被烤进来了(有没有被 .dockerignore 放行决定),构建日志里说清楚,
# 免得日后排查"到底读的是哪份配置"时靠猜。权限收到 600:下一步整目录 chown 给
# unisoa 之后只有服务账号读得到。
RUN if [ -f ./config.prod.toml ]; then chmod 600 ./config.prod.toml \
&& echo "build: 已烤入 config.prod.toml($(wc -c < ./config.prod.toml) 字节,含密钥)"; \
else echo "build: 未烤 config.prod.toml,运行时靠 /etc/unisoa 挂载或 OA_* 环境变量注入"; fi
# 不用 root 跑;storage 是网盘文件与 MinIO 兜底的落盘处,挂卷时要可写
RUN useradd --system --uid 10001 --create-home unisoa \
&& mkdir -p /app/backend/storage /etc/unisoa \
&& chmod +x scripts/*.sh \
&& chown -R unisoa:unisoa /app /etc/unisoa
USER unisoa
EXPOSE 8000
# 探活用匿名接口 /api/v1/settings/public:不登录就能读,起了就通
HEALTHCHECK --interval=30s --timeout=5s --start-period=90s --retries=3 \
CMD python -c "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/api/v1/settings/public', timeout=4)" || exit 1
# 入口就是仓库里那个生产启动脚本,不另写一份:它先确认这一档的配置文件在不在
# (不在就直接退出并说清楚少哪份,免得起来连的是代码默认的 127.0.0.1 空口令库),
# 再把"读的到底是哪几份文件"打在日志最前面。OA_STRICT_CONFIG=1 时上线体检没过
# 就不起服务;监听端口以 -e OA_HOST / OA_PORT 为准(命令行盖过配置文件里的 [server])。
CMD ["./scripts/prod-api.sh"]