126 lines
7.1 KiB
Docker
126 lines
7.1 KiB
Docker
# 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"]
|