# 多阶段构建:Next.js 生产镜像(parent-portal,standalone 模式) # 用法:docker build -t edu/parent-portal:latest -f apps/parent-portal/Dockerfile . # 依据:02-architecture-design.md §16 部署、G1 裁决(首次即多阶段) # 端口:4002(4 端 portal 强制 4000-4003) # ============ Builder ============ FROM node:22-alpine AS builder WORKDIR /app # 启用 pnpm RUN corepack enable && corepack prepare pnpm@11.13.0 --activate # 先拷依赖清单,利用缓存 COPY package.json pnpm-lock.yaml* pnpm-workspace.yaml* ./ COPY tsconfig.base.json ./tsconfig.base.json COPY apps/parent-portal/package.json ./apps/parent-portal/ # 安装依赖(含 devDependencies,构建需要) RUN pnpm install --filter @edu/parent-portal... --frozen-lockfile || pnpm install --filter @edu/parent-portal... # 拷源码 COPY apps/parent-portal ./apps/parent-portal # 构建(禁用 telemetry,生产模式,standalone 输出) ENV NEXT_TELEMETRY_DISABLED=1 RUN pnpm --filter @edu/parent-portal run build # ============ Runtime ============ FROM node:22-alpine AS runner WORKDIR /app ENV NODE_ENV=production ENV NEXT_TELEMETRY_DISABLED=1 ENV PORT=4002 # standalone server.js 默认绑定 HOSTNAME(Docker 中为容器 ID),导致 localhost 不可达 # 强制绑定 0.0.0.0 让健康检查 wget localhost 能连通 ENV HOSTNAME=0.0.0.0 # 非 root 用户运行 RUN addgroup -g 1001 -S nodejs && adduser -S nextjs -u 1001 # 拷 standalone 产物(已含 node_modules 和 server.js,自包含) COPY --from=builder --chown=nextjs:nodejs /app/apps/parent-portal/.next/standalone ./ COPY --from=builder --chown=nextjs:nodejs /app/apps/parent-portal/.next/static ./.next/static COPY --from=builder --chown=nextjs:nodejs /app/apps/parent-portal/public ./public USER nextjs EXPOSE 4002 # 健康检查(使用 127.0.0.1 而非 localhost,避免容器内 hosts 解析问题) HEALTHCHECK --interval=30s --timeout=5s --start-period=20s --retries=3 \ CMD wget --quiet --spider http://127.0.0.1:4002/api/health || exit 1 # standalone 模式下直接用 node server.js 启动(已自包含所有依赖) WORKDIR /app/apps/parent-portal CMD ["node", "server.js"]