3.6 KiB
3.6 KiB
AI SoulMate 本地部署与硬件适配
从这里开始
先阅读 Ubuntu 22.04 本地部署运行手册、后端本地部署、平台前端本地部署、样机硬件评估报告 和 源码版本核对。当前可以启动 PostgreSQL、Redis、MinIO、平台后端和平台前端;管理端 AI-only 模式和统一网关仍在后续阶段。
本仓库是 AI SoulMate 私有化部署的编排与留档仓库,用于固定源码版本、记录硬件基线、建设部署配置并沉淀压测结果。业务源码仍保留在各自仓库中,不复制源码、不改写原有 Git 历史。
当前结论
- 当前 HP ZCentral 4R 样机适合做单机适配、功能跑通和容量边界测试,不作为生产高可用样板。
- 第一阶段在中心服务器部署平台后端、平台前端、AI SoulMate 管理端、PostgreSQL、Redis、本地对象存储和统一网关。
- Tripo 暂时继续走外部 API,因此这是“业务数据和基础设施本地化”,不是完全离线部署。
- 农场端
ai-soulmate-client暂不部署到中心服务器,后续放到靠近打印机的工作站。 - 网关能力是必需的,但现有
nginx-server的公网域名和固定路由不能原样交付,需要在本仓库形成私有部署配置。
仓库边界
| 内容 | 保存位置 |
|---|---|
| Python/Vue 平台源码 | ai-soulmate-server |
| 农场端 Spring Boot/Vue 源码 | ai-soulmate-client |
| 管理端源码 | mlkj-admin |
| 部署编排、版本锁定、脚本和文档 | 本仓库 |
| 小型压测报告和容量结论 | results/reports/ |
| 大型原始日志 | results/raw/,默认不进入 Git |
| 密钥、证书和真实密码 | 不进入 Git |
目录
docs/:架构、改造路线、样机基线和压测方案。docs/CROSS-COMPUTER-HANDOFF.md:换电脑继续工作的状态、重建 Git 和接管清单。decisions/:影响交付方式的架构决策。inventory/:参与部署的源码版本清单。compose/:基础设施、平台后端和平台前端 Compose 编排。scripts/:硬件与运行状态采集脚本。benchmark/:压测场景和单次运行元数据模板。results/:压测报告与不入库的原始数据。
推荐执行顺序
- 固化样机硬件、网络、系统和源码版本基线。
- 完成后端对象存储适配、生产镜像和单机 Compose。
- 完成平台前端、管理端 AI-only 模式和统一网关。
- 在样机上完成联网 POC,验证 Tripo 出站访问和全业务链路。
- 先测本地链路容量,再单独测包含 Tripo 的端到端体验。
- 增加农场工作站,验证任务下发、断线恢复和打印机适配。
- 根据重复压测数据形成不同客户硬件档位,不凭 CPU/内存规格直接承诺并发量。
详细任务见 改造路线。
样机首次采集
在 Ubuntu 样机上执行:
./scripts/collect-host-facts.sh > results/raw/host-facts-$(date +%Y%m%d-%H%M%S).txt
采集结果不包含 IP、MAC、磁盘序列号和机器 UUID。原始文件默认不入 Git;评审后将脱敏结论写入 results/reports/。
版本规则
- 每次可复现部署必须记录三个源码提交、容器镜像 digest、配置版本和数据库迁移版本。
- 建议用
poc-YYYYMMDD.N、rc-X.Y.Z、release-X.Y.Z标记部署仓库版本。 - 本仓库只保存示例变量名;真实值由现场
.env、密钥文件或客户密钥系统提供。