墨台 MUOTAI

Appearance

生产部署 ​

部署单元 ​

生产部署至少包含基础设施、平台服务和 AI/生态服务。建议把 muotai-ai、muotai-doc-space、SPG、审计、标准化和 WFlow 作为独立发布单元，通过 Nacos 和 Feign/API 契约通信。

text
Nacos + MySQL + Redis + 对象存储 + 向量库
                 ↓
       Gateway / Auth / UPMS
                 ↓
 AI + DocSpace + SPG + Audit + Standard + WFlow

发布步骤 ​

  1. 构建根 Maven 工程，确认 muotai-ai-api 先于 muotai-ai-biz 安装。
  2. 执行对应数据库迁移脚本。
  3. 发布 Nacos 配置和密钥，不把真实密钥写入 Git。
  4. 发布镜像并挂载会话账本、文件和对象存储目录。
  5. 检查 Nacos 注册、数据库连接、模型连接、MCP 同步和健康检查。
  6. 通过网关执行一次完整聊天、文件上传、工具调用和日志查询。

端口现状 ​

源码 muotai-ai-biz/src/main/resources/application.yml 默认端口为 6062；当前 Dockerfile、开发编排和生产健康检查仍声明 6060。这是一项发布前必须统一的配置差异：应选择一个正式端口，并同步修改源码、Dockerfile、Compose、网关路由和 Nacos 配置后再扩容。

持久化目录 ​

启用 agent.session.persistence.enabled 后，JSONL 会话账本、检查点、运行轨迹和部分文件引用需要挂载到持久化卷。容器临时文件系统不能作为生产会话存储。

扩容检查 ​

  • 消息队列切换到 Redis 或 RocketMQ，并验证重复投递和消费失败策略。
  • session 执行器仍需保持同一 session 的顺序。
  • 外部 IM 回复目标需要节点粘性或共享路由。
  • 文件空间、对象存储和 VFS backing store 需要一致的租户权限。
  • LLM、MCP、Feign 工具的超时和限流必须设置上限。

一次发布的依赖顺序 ​

MySQL/Redis/Nacos/Object Storage/Vector DB
  -> Nacos 配置与注册 -> Auth/UPMS/Gateway
  -> AI/DocSpace/业务服务 -> 聊天、文件、RAG、工具验收

先准备基础设施和迁移，再发布配置，随后启动服务并确认注册，最后打开 Gateway 流量。AI 服务必须在真实模型、Embedding、MCP、FileRoom 持久卷和数据库可用后才算就绪；进程启动成功不代表 Agent 能完成一次工具调用。

端口、持久化与扩容的统一入口 ​

端口冲突、源码与镜像不一致、持久化目录和多实例约束统一记录在服务端口与部署单元、服务名称、端口与健康检查总表和当前实现与历史配置差异。本页只保留发布顺序和部署原则，避免同一事实出现多份互相漂移的副本。