运维部署

运维文档尽量直接对应当前交付形态:FastAPI、Celery、PostgreSQL、Redis、静态前端容器,以及 GitHub Pages 上的文档站本身。

本节包含

  • 部署指南:从本地 Compose 到单机部署,先看真正跑起来的拓扑是什么。
  • 配置说明:区分哪些配置还应该留在 .env,哪些运行策略已经迁进 UI 和数据库。
  • 安全:以更低的误操作成本保护 Provider 凭据、工作区状态与部署密钥。
  • 监控与可观测性:需要 runtime 可见性时,去看指标、请求 ID、日志和 worker 行为,而不是猜。
  • 备份与恢复:在事故发生前就规划数据库备份、凭据连续性与恢复策略。
  • Docker Compose 深入说明:当你需要排容器拓扑本身时,再进入更底层的 Compose 附录。
文档必须跟运行时 truth 对齐

如果某个控制项已经从 .env 挪进 Settings,文档也必须同步更新。让操作者误判配置位置,本质上就是运维 bug。