feat: 构建镜像前准备

2026-10-23 10:02:09 +08:00
parent 69ec885803
commit a3c70bf1a7
9 changed files with 534 additions and 1 deletions
@@ -0,0 +1,21 @@
+# 在 Linux 内安装依赖和生成 Prisma 客户端，不能复用开发机的 node_modules。
+FROM node:24.20.0-bookworm-slim AS base
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends ca-certificates openssl \
+    && rm -rf /var/lib/apt/lists/* \
+    && npm install --global pnpm@11.24.0
+WORKDIR /app
+
+FROM base AS build
+COPY . .
+RUN pnpm install --frozen-lockfile --filter @doodle/server...
+RUN pnpm --filter @doodle/server... run build
+
+FROM base AS runtime
+ENV NODE_ENV=production HOST=0.0.0.0 PORT=8800
+# 首版保留构建依赖及 Prisma CLI，允许用同一版本镜像执行独立迁移任务。
+# 后续优化镜像体积时应拆分 migrator，不能直接删掉迁移命令所需的依赖。
+COPY --from=build --chown=node:node /app /app
+USER node
+EXPOSE 8800
+CMD ["node", "apps/server/dist/main.js"]
@@ -1,6 +1,8 @@
 # Doodle 云端部署准备

-更新时间：2026-10-20。本文件记录部署方案与待确认条件。已在 1Panel 申请根域及泛域名证书，并安装 PostgreSQL；尚未创建 Doodle 云端应用、应用域名 DNS 记录或镜像仓库，也未改动旧线上云开发链路。
+更新时间：2026-10-22。用户已确认 `doodle_prod` 数据库准备完成；本轮未现场重新核验云端数据，未部署 API 或修改旧线上云开发链路。
+
+下一步按 [服务端首次部署操作手册](../docs/v3.5/服务端首次部署操作手册.md) 操作。已补齐 `Dockerfile.server`、`compose.api.yaml` 和两份环境配置模板，采用本机构建 `linux/amd64` 镜像、1Panel 上传导入、复用现有 PostgreSQL 与 OpenResty 的流程。下文的早期计划与状态记录如有差异，以该手册及本段最新状态为准。

 ## 已确认条件

@@ -0,0 +1,45 @@
+name: doodle-prod
+
+services:
+    api:
+        image: ${DOODLE_API_IMAGE:?请在 .env 中填写已导入的镜像标签}
+        platform: linux/amd64
+        container_name: doodle-api-prod
+        # raw 保留密码中的 $ 等字符，需要 Docker Compose >= 2.30.0。
+        env_file:
+            - path: ./server.env
+              format: raw
+        init: true
+        restart: unless-stopped
+        stop_grace_period: 30s
+        ports:
+            - '127.0.0.1:8800:8800'
+        networks:
+            - panel
+        healthcheck:
+            # 同时验证 HTTP 和数据库连通性；不代表业务表、微信或七牛已验收。
+            test:
+                - CMD
+                - node
+                - -e
+                - "fetch('http://127.0.0.1:8800/api/v1/health/ready', { signal: AbortSignal.timeout(2500) }).then(r => process.exit(r.ok ? 0 : 1)).catch(() => process.exit(1))"
+            interval: 30s
+            timeout: 5s
+            retries: 3
+            start_period: 30s
+        mem_limit: 768m
+        security_opt:
+            - no-new-privileges:true
+        cap_drop:
+            - ALL
+        logging:
+            driver: json-file
+            options:
+                max-size: '10m'
+                max-file: '3'
+
+networks:
+    panel:
+        # 复用 1Panel 已有数据库网络，不创建或接管 PostgreSQL 容器。
+        external: true
+        name: ${PANEL_DOCKER_NETWORK:-1panel-network}
@@ -0,0 +1,3 @@
+# 仅供 Compose 选择镜像和网络；复制为服务器部署目录下的 .env。
+DOODLE_API_IMAGE=doodle-server:20261022-01
+PANEL_DOCKER_NETWORK=1panel-network
@@ -0,0 +1,29 @@
+# 复制为 server.env，仅在服务器填写真实值，禁止提交仓库或打入镜像。
+# Compose 使用 raw 读取：每行 KEY=value，值不加包裹引号，不写行尾注释。
+NODE_ENV=production
+HOST=0.0.0.0
+PORT=8800
+LOG_LEVEL=info
+NODE_OPTIONS=--max-old-space-size=384
+API_BODY_LIMIT_BYTES=1048576
+SWAGGER_ENABLED=false
+CORS_ORIGINS=
+# 初次部署留空；只在确认实际反向代理来源后填写明确 IP/CIDR。
+TRUSTED_PROXY_CIDRS=
+JWT_SECRET=
+JWT_ISSUER=doodle-store
+JWT_AUDIENCE=doodle-mini
+JWT_EXPIRES_IN_SECONDS=86400
+WECHAT_MINI_APP_ID=
+WECHAT_MINI_APP_SECRET=
+# 密码先 URL 编码；主机是数据库容器名，端口是容器内部的 5432。
+DATABASE_URL=postgresql://joey_postgresql:REPLACE_WITH_URL_ENCODED_PASSWORD@1Panel-postgresql-RqP6:5432/doodle_prod?schema=public
+WORKSHEET_NEW_WINDOW_DAYS=30
+QINIU_PUBLIC_DOMAIN=https://cdn.joeyone.cn
+QINIU_KEY_PREFIX=doodle-assets/
+QINIU_BUCKET=doodle-cn
+# 只读联通阶段可一起留空；头像和管理员图片上传验收前必须配置。
+QINIU_AK=
+QINIU_SK=
+QINIU_REGION=
+SITE_REFRESH_HOUR_UTC=22