运维部署
运维文档尽量直接对应当前交付形态:FastAPI、Celery、PostgreSQL、Redis、静态前端容器,以及 GitHub Pages 上的文档站本身。
本节包含
- 部署指南:从本地 Compose 到单机部署,先看真正跑起来的拓扑是什么。
- 配置说明:区分哪些配置还应该留在
.env,哪些运行策略已经迁进 UI 和数据库。 - 安全:以更低的误操作成本保护 Provider 凭据、工作区状态与部署密钥。
- 监控与可观测性:需要 runtime 可见性时,去看指标、请求 ID、日志和 worker 行为,而不是猜。
- 备份与恢复:在事故发生前就规划数据库备份、凭据连续性与恢复策略。
- Docker Compose 深入说明:当你需要排容器拓扑本身时,再进入更底层的 Compose 附录。
文档必须跟运行时 truth 对齐
如果某个控制项已经从 .env 挪进 Settings,文档也必须同步更新。让操作者误判配置位置,本质上就是运维 bug。
