LoveChengke
9c678b3730
- Dockerfile：构建阶段补 `pnpm --filter @classhelper/server run db:generate`。生成产物 packages/server/src/generated/prisma 是 gitignored 的，而 pnpm install 用了 --ignore-scripts 跳过 postinstall，少了这一步 tsc 会报 "Cannot find module ../generated/prisma/client.js"（从 git clone 构建必踩） - 新增 deploy/docker-compose.sqlite.yml + deploy/.env.sqlite.example：只跑服务端一个容器（DATABASE_URL=file:/app/data/classhelper.db + 数据卷），首次启动靠 AUTO_MIGRATE=true 自动建表与建管理员。适合内存小的机器或与别的服务共用一台机器（MySQL 变体会多一个数据库进程） - docs/production.md：补 2.1 单容器变体说明（用法、适用场景、端口/生产自检注意事项、备份命令）
79 lines
3.2 KiB
Docker
79 lines
3.2 KiB
Docker
# 班级小助手服务端 · 生产镜像
|
||
#
|
||
# 两阶段构建：
|
||
# build —— 安装依赖并编译 shared / server / web-admin
|
||
# runtime —— 仅保留运行时所需内容（生产依赖 + 构建产物），镜像更小
|
||
#
|
||
# 构建（在仓库根目录执行）：
|
||
# docker build -f deploy/Dockerfile -t classhelper-server:0.1.0 .
|
||
#
|
||
# 运行（SQLite + 数据卷）：
|
||
# docker run -d --name classhelper -p 4000:4000 \
|
||
# -e JWT_SECRET=<48字节随机串> \
|
||
# -v classhelper-data:/app/data \
|
||
# classhelper-server:0.1.0
|
||
#
|
||
# 生产推荐用 docker compose（见 deploy/docker-compose.yml，含 MySQL 与 HTTPS 反代）
|
||
|
||
# ---------------------------------------------------------------- 构建阶段
|
||
FROM node:22-slim AS build
|
||
WORKDIR /app
|
||
|
||
# 启用 pnpm（用 corepack 保证版本与仓库一致）
|
||
RUN corepack enable && corepack prepare pnpm@11.8.0 --activate
|
||
|
||
# 先只拷贝清单以提高缓存命中率
|
||
COPY pnpm-workspace.yaml pnpm-lock.yaml package.json tsconfig.base.json ./
|
||
COPY packages/shared/package.json packages/shared/
|
||
COPY packages/server/package.json packages/server/
|
||
COPY packages/web-admin/package.json packages/web-admin/
|
||
COPY packages/desktop-client/package.json packages/desktop-client/
|
||
RUN pnpm install --frozen-lockfile --ignore-scripts
|
||
|
||
# 再拷贝源码并构建（只构建服务端与 Web 管理端，桌面客户端不参与）
|
||
COPY packages ./packages
|
||
COPY scripts ./scripts
|
||
|
||
# 必须先生成 Prisma Client：`pnpm install --ignore-scripts` 跳过了 postinstall，
|
||
# 而生成产物 `packages/server/src/generated/prisma` 是 gitignored 的（clone 下来没有），
|
||
# 少了这一步下面的 tsc 会报 "Cannot find module '../generated/prisma/client.js'"。
|
||
RUN pnpm build:shared \
|
||
&& pnpm --filter @classhelper/server run db:generate \
|
||
&& pnpm --filter @classhelper/server build \
|
||
&& pnpm --filter @classhelper/web-admin build
|
||
|
||
# ---------------------------------------------------------------- 运行时阶段
|
||
FROM node:22-slim AS runtime
|
||
WORKDIR /app
|
||
|
||
ENV NODE_ENV=production \
|
||
HOST=0.0.0.0 \
|
||
PORT=4000 \
|
||
LOG_LEVEL=info \
|
||
TRUST_PROXY=1 \
|
||
RATE_LIMIT_ENABLED=true \
|
||
STARTUP_DB_CHECK=true
|
||
|
||
# 生产依赖（清单由 scripts/dist-server.mjs 依据 packages/server/package.json 生成）
|
||
COPY deploy/package.runtime.json ./package.json
|
||
RUN npm install --omit=dev --no-audit --no-fund
|
||
|
||
# 后端产物 + 迁移文件 + Web 管理端 + 工作区共享包
|
||
COPY --from=build /app/packages/server/dist ./server/dist
|
||
COPY --from=build /app/packages/server/prisma/migrations ./server/prisma/migrations
|
||
COPY --from=build /app/packages/web-admin/dist ./web
|
||
COPY --from=build /app/packages/shared/dist ./node_modules/@classhelper/shared/dist
|
||
COPY packages/shared/package.json ./node_modules/@classhelper/shared/package.json
|
||
|
||
# 数据目录（SQLite 文件 / PID 文件），建议挂载数据卷
|
||
RUN mkdir -p /app/data /app/logs
|
||
VOLUME ["/app/data"]
|
||
|
||
EXPOSE 4000
|
||
|
||
# 容器健康检查：就绪探针（数据库不可用会返回 503）
|
||
HEALTHCHECK --interval=30s --timeout=5s --start-period=25s --retries=3 \
|
||
CMD node -e "fetch('http://127.0.0.1:4000/readyz').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"
|
||
|
||
CMD ["node", "server/dist/index.js"]
|