docs(deploy): 补充基础依赖规格与容量基线

2026-07-16 17:29:08 +08:00
parent 1ff5a5f27b
commit d6ef8b0a23
2 changed files with 50 additions and 0 deletions
@@ -72,6 +72,42 @@ kubectl get storageclass
 | RWX 共享存储 | 与 Kubernetes 集群版本兼容的 CSI/存储插件 | 上传、备份、恢复文件共享 | 支持 `ReadWriteMany` 的 StorageClass |
 | OSS/S3 对象存储 | 兼容 AWS S3 Signature V4 或云厂商 OSS/S3 当前 API，可选 | 文件存储，可选 | Endpoint、Bucket、Access Key |

+#### 生产初始规格与容量基线
+
+客户尚未提供业务容量数据时，可先按下表准备生产环境。表中的 CPU、内存和磁盘均为**单个数据节点**的规格，标注“当前模板”的项目与仓库 YAML 一致；标注“规划参考”的外部依赖需根据实际业务量和压测结果调整。本表用于资源准备和首次上线，不代表固定性能或容量承诺。
+
+| 依赖 | 建议生产拓扑 | 单节点初始规格 | 初始存储容量 | 备注 |
+| --- | --- | --- | --- | --- |
+| MongoDB | 云服务高可用版，或 3 个数据节点的副本集 | `4 vCPU / 16Gi` | 每节点 `200Gi` SSD | 规划参考；数据盘不包含备份和快照空间 |
+| Redis | 云服务高可用版，或主节点 + 2 个副本并配套 Sentinel | `2 vCPU / 4Gi` | 每节点 `20Gi` SSD，建议 `maxmemory` 初始设为 `2Gi` | 规划参考；必须支持多个逻辑 DB 和 `SELECT`，当前不支持 Redis Cluster 模式 |
+| RabbitMQ | 3 节点集群，持久化业务队列使用 quorum queue | 请求 `1 vCPU / 2Gi`，上限 `2 vCPU / 2Gi` | 每节点 `50Gi` RWO SSD，总计 `150Gi` | 当前自建模板实际值；高吞吐或大消息场景需压测后增加内存和磁盘 |
+| PostgreSQL + pgvector | 云服务高可用版，或 1 主 1 备 | `4 vCPU / 16Gi` | 每节点 `200Gi` SSD | 规划参考；可在同一实例创建 `agent_governance` 和 `easyai_memory` 两个数据库 |
+| RWX 共享存储 | 支持高可用和在线扩容的 RWX 存储 | 由存储服务决定 | 初始总容量 `100Gi` | 当前生产 PVC 实际值；不包含独立备份空间 |
+| OSS/S3 对象存储 | 云厂商托管对象存储 | 由对象存储服务决定 | 按量使用，无需预分配固定容量 | 可选；建议配置生命周期和历史文件清理策略 |
+
+最终容量应根据客户业务数据计算：
+
+```text
+初始可用容量 >=（现有数据量 + 日增量 × 在线保留天数）× 1.5
+```
+
+其中 `1.5` 用于预留索引、临时文件、数据增长和运维空间。数据盘使用率达到 `70%` 时告警，达到 `80%` 前完成扩容；备份、快照和跨区域副本应单独计算，不占用上表的数据盘容量。
+
+上线前请客户补充以下信息，以便把初始参考规格调整为最终规格：
+
+- 峰值并发用户数和同时运行的任务数；
+- 每日任务量、峰值队列积压量及单条消息大小；
+- 现有数据库大小、每日数据增量和在线保留天数；
+- 每日上传文件量、平均文件大小和文件保留周期；
+- 备份周期、保留份数以及 RPO/RTO 要求。
+
+本地验证环境中的依赖为单节点和临时 `emptyDir` 存储，只用于功能验证，不能作为生产规格。MongoDB、Redis 和 PostgreSQL 的资源规划可参考官方生产说明：
+
+- [MongoDB Production Notes](https://www.mongodb.com/docs/manual/administration/production-notes/)
+- [Redis Administration](https://redis.io/docs/latest/operate/oss_and_stack/management/admin/)
+- [PostgreSQL Resource Consumption](https://www.postgresql.org/docs/current/runtime-config-resource.html)
+- [RabbitMQ Quorum Queues](https://www.rabbitmq.com/docs/quorum-queues)
+
 #### Redis 逻辑 DB 配置

 Redis 地址、端口和逻辑 DB 编号统一配置在：
@@ -25,6 +25,20 @@ RabbitMQ 版本生命周期参考：

 <https://www.rabbitmq.com/release-information>

+## 默认资源规格与容量
+
+当前自建模板的默认生产规格如下，CPU、内存和磁盘均为单个 RabbitMQ 节点的配置：
+
+| 项目 | 单节点规格 | 3 节点合计 | 说明 |
+| --- | --- | --- | --- |
+| CPU | 请求 `1 vCPU`，上限 `2 vCPU` | 请求 `3 vCPU`，上限 `6 vCPU` | 当前 `rabbitmq-cluster.yaml` 实际值 |
+| 内存 | 请求和上限均为 `2Gi` | 请求和上限均为 `6Gi` | 当前模板基线；高吞吐或大消息场景需压测后增加 |
+| 持久化存储 | `50Gi` RWO SSD | `150Gi` | 每个节点使用独立 PVC，不包含备份和快照空间 |
+
+以上规格是业务容量数据缺失时的首次上线基线，不代表固定性能或容量承诺。最终容量应按消息峰值、队列最大积压量、单条消息大小和保留时间确定，并在预发布环境完成压力测试。
+
+持久化存储使用率达到 `70%` 时应告警，达到 `80%` 前完成 PVC 扩容。PVC 仅用于节点数据持久化，definitions 导出、存储快照和异地备份容量需要单独准备。生产环境优先使用低延迟 SSD，具体磁盘和内存规划可参考 RabbitMQ 官方 [Quorum Queues](https://www.rabbitmq.com/docs/quorum-queues) 说明。
+
 ## 前提条件

 - Kubernetes 集群至少有 3 个可调度 Worker 节点；