升级 Clouisle
安全更新镜像、迁移数据并在异常时回滚
升级前先阅读目标版本 CHANGELOG，确认数据库迁移、工作流定义、模型适配器和部署 manifest 变化。
Compose 升级
- 备份 PostgreSQL、Qdrant、上传卷和
.env。 - 拉取新镜像：
docker compose pull。 - 逐个检查服务配置和镜像标签。
- 执行
docker compose up -d，先观察api和 Worker 日志。 - 检查
/api/v1/health、登录、模型列表、知识库检索和一个已发布 Agent。 - 检查工作流旧定义是否需要重新保存
schema_version: 2。
安装器升级会保留现有 .env，但仍需审阅新增变量和默认值。
Kubernetes 升级
使用相同 release 和 namespace 执行 helm upgrade，或审阅新生成 manifest 后 apply。先更新 API 与迁移，再更新 Worker/Beat/Frontend；生产期间保持 Beat 单副本。
回滚
回滚镜像前确认数据库迁移是否可逆。若迁移不可逆，不要只切回旧镜像；恢复备份到隔离环境验证。工作流版本可在产品 UI 单独恢复，但这不等同于服务回滚。
这篇文章对你有帮助吗？