Files

HaHafeng 6124c7abc6 docs(platform): Add database documentation system and restructure deployment docs

Completed:
- Add 6 core database documents (docs/01-平台基础层/07-数据库/)
  Architecture overview, migration history, environment comparison,
  tech debt tracking, seed data management, PostgreSQL extensions
- Restructure deployment docs: archive 20 legacy files to _archive-2025/
- Create unified daily operations manual (01-日常更新操作手册.md)
- Add pending deployment change tracker (03-待部署变更清单.md)
- Update database development standard to v3.0 (three iron rules)
- Fix Prisma schema type drift: align @db.* annotations with actual DB
  IIT: UUID/Timestamptz(6), SSA: Timestamp(6)/VarChar(20/50/100)
- Add migration: 20260227_align_schema_with_db_types (idempotent ALTER)
- Add Cursor Rule for auto-reminding deployment change documentation
- Update system status guide v6.4 with deployment and DB doc references
- Add architecture consultation docs (Prisma guide, SAE deployment guide)

Technical details:
- Manual migration due to shadow DB limitation (TD-001 in tech debt)
- Deployment docs reduced from 20+ scattered files to 3 core documents
- Cursor Rule triggers on schema.prisma, package.json, Dockerfile changes

Made-with: Cursor

2026-02-27 14:35:25 +08:00

7.7 KiB

Raw Blame History

阿里云 SAE 全栈部署与高并发弹性策略指南

基于 AIclinicalresearch 平台当前的四层架构（前端、Node.js 后端、Python 微服务、R 统计引擎），本指南旨在统筹规划阿里云 Serverless App Engine (SAE) 的使用策略。不仅涵盖了 R 引擎的单线程阻断解法，更扩展至全栈模块的弹性配置、潮汐流量应对 SOP，以及 SAE 高阶功能的深度利用。

一、全系统 SAE 规格与弹性扩容指标配置

针对不同模块的技术特性，SAE 的弹性扩容指标（触发 Scale-out 的阈值）必须差异化配置，切忌一刀切。

1. R 统计引擎 (ssa-r-statistics)

特性：R 语言和 Plumber 框架默认单线程阻塞。复杂矩阵运算消耗大量 CPU 和内存。镜像极大（1.81GB）。
基础规格：2 vCPU, 4 GB （绝对下限）。
实例数策略：最小实例 = 1，最大实例 = 5。
🔥 弹性扩容指标：基于并发请求数 (QPS / 并发连接数)。
- 策略：当单实例并发请求数 > 1 或 > 2 时，立即触发扩容。因为 CPU 还没跑满时，请求已经在排队了，必须用并发数来敏锐感知阻塞。

2. Node.js 后端 (backend-service)

特性：异步非阻塞，擅长高并发 I/O。持有大量 SSE 长链接（AI 流式对话）。包含 pg-boss 队列。
基础规格：2 vCPU, 4 GB。
实例数策略：最小实例 = 1，最大实例 = 5。
🔥 弹性扩容指标：基于 CPU 和内存使用率。
- 策略：当 CPU 使用率 > 70% 或内存使用率 > 80% 时触发扩容。Fastify 框架抗并发极强，通常是 JSON 序列化或 Prisma 并发查询导致 CPU 飙升。

3. Python 微服务 (python-extraction)

特性：PDF 解析（PyMuPDF）和数据清洗（Pandas）是内存消耗大户。
基础规格：1 vCPU, 2 GB 或 2 vCPU, 4 GB（取决于平均 PDF 大小）。
实例数策略：最小实例 = 1，最大实例 = 3。
🔥 弹性扩容指标：基于内存使用率。
- 策略：当内存使用率 > 85% 时扩容。Python 数据处理极易引发 OOM，需通过扩容分散大文件处理压力。

4. 前端 Nginx (frontend-nginx)

特性：静态资源分发，极度轻量。
基础规格：1 vCPU, 2 GB（甚至更低）。
实例数策略：最小实例 = 1，最大实例 = 3。
🔥 弹性扩容指标：基于 CPU 或出网流量。
- 策略：CPU > 60% 或出网带宽达到瓶颈时扩容。

二、高并发场景操作 SOP（以“培训班”潮汐流量为例）

面对培训班（如 50-100 人同时操作统计模块）产生的突发流量，千万不能依赖临时的自动扩容（拉取 1.8GB 镜像需要时间，会导致大规模 504 超时）。必须采用**定时弹性伸缩（Cron HPA）**进行预热。

🎯 操作时间线与策略

1. 培训班开始前 1 天（配置策略）

动作：登录阿里云 SAE 控制台，进入 R 统计引擎和 Node.js 后端的【弹性伸缩】配置页面。
配置：添加“定时弹性策略”（Cron HPA）。
- 设定执行时间：例如 2026-03-01 08:30（提前半小时）。
- 设定目标实例数：强制将实例数扩展至 3 或 5 个。

2. 培训班开始前 30 分钟（系统预热）

动作：SAE 会根据设定的 Cron 规则自动启动新实例。
效果：系统完成 1.8GB 镜像拉取、环境初始化、加载 R/Python 依赖包。所有实例状态变为 Healthy，提前排兵布阵完毕。

3. 培训班进行中（9:00 - 17:00）

动作：无需人工干预。
效果：50 名学员同时点击“运行 T 检验”，SAE 网关将请求均匀分发给 5 个预热好的 R 引擎实例。单线程阻塞被完美的物理隔离化解。

4. 培训班结束后（17:30 以后）

动作：依靠 SAE 的定时策略或自动缩容策略自动执行。
效果：实例数恢复至最小 1 个，立刻停止多余计费。整体成本开销仅为 5 个实例运行 8 小时的费用（极具性价比）。

三、全栈架构如何深度利用 SAE 高阶功能

除了弹性扩容，结合你们的系统状态，强烈建议启用 SAE 的以下功能来提升系统的企业级稳定性：

1. 开启“镜像加速”（针对大镜像冷启动）

适用模块：Python 微服务 (1.1GB)、R 统计引擎 (1.81GB)。
配置与价值：在 SAE 应用配置中勾选【镜像加速】。SAE 底层会通过按需加载数据块的技术（如 DADI），将几分钟的冷启动时间压缩到秒级。这是应对偶发流量突增的核心兜底技术。

2. 优雅上下线与无损发布 (Graceful Shutdown)

适用模块：Node.js 后端（特别是 pg-boss 队列）。
配置与价值：
- 目前你们的 ASL 和 DC 模块深度依赖 pg-boss 处理异步任务。
- 如果 SAE 突然缩容杀掉 Node 实例，运行中的文献抓取任务会中断。
- 操作：在 SAE 中配置优雅下线时间（如 30 秒）。在 Node.js 代码中监听 SIGTERM 信号，收到信号后，停止接收新 HTTP 请求，但等待 pg-boss 正在处理的 job 执行完毕后再退出容器。

3. Liveness 与 Readiness 探针 (健康检查)

适用模块：全模块。
配置与价值：
- Liveness (存活探针)：配置在 GET /health。如果 R 引擎死锁，探针连续 3 次失败，SAE 会自动重启该容器（自愈能力）。
- Readiness (就绪探针)：在应用刚启动、正在建立 PostgreSQL 数据库连接池或加载 R 语言模型时，Readiness 返回 false，SAE 不会把用户流量打过来，避免报错。

4. 长链接防断开配置 (针对 SSE 架构)

适用模块：Node.js 后端、R 统计引擎、前端 Nginx。
配置与价值：系统中有大量的打字机效果（AI 流式对话）和进度条流式推送（SSE）。必须在 SAE 的网关层（如 ALB/CLB）调整 闲置超时时间 (Idle Timeout)，建议设置为 120秒或更长，防止长时间推理时网络连接被强制切断。

5. 一体化可观测性 (SLS 日志与 APM 链路监控)

适用模块：全模块。
配置与价值：
- 日志采集：将各容器的 stdout 日志一键收集到阿里云 SLS，所有报错无需 SSH 登录服务器，直接在网页端关键词检索（如 [ERROR] R引擎）。
- 链路追踪：SAE 支持无侵入式 APM。你能清晰看到一条请求：从前端 -> Node.js (消耗 50ms) -> R 引擎 (消耗 2000ms) 的全链路耗时，精准定位系统性能瓶颈。

四、总结：运维与管理策略时间线

日常平峰期：所有微服务维持最小实例 1，最大实例 3/5。通过“并发数”和“CPU”的双重自动弹性指标应对日常零星的并发波动。
大版本更新日：利用 SAE 的“分批发布”或“灰度发布”功能。先替换 1 个实例为 v2.0，测试无误后再全量更新，实现业务零停机。
大中型活动（培训班）：提前在日历上标记，通过 SAE 【定时弹性策略】提前 30 分钟扩容预热大容器，活动后自动缩容。
故障排查时：不再去看单机日志，直接利用 SAE 挂载的 ARMS（应用实时监控服务）查看错误率飙升的模块，或者进入 SLS 搜索 TraceID。

这套体系将彻底把你们的研发团队从繁琐的运维、服务器抗压焦虑中解放出来，让 "Serverless (无服务器)" 的红利在你们的临床 AI 系统中最大化展现。

7.7 KiB Raw Blame History Unescape Escape