🔧 Document compatible Fanyu API rollout and rollback

This commit is contained in:
eust-w 2026-09-14 14:48:17 +08:00
parent 41f82b8f1a
commit dd792ccf7c
2 changed files with 19 additions and 0 deletions

View File

@ -25,3 +25,14 @@
- API/单元测试:显式内部成员、单个/批量校验、供应商兼容、并发领取、指派、释放、提交到质检路由、内外与跨项目隔离、历史空归属不自动授权、账号更新不隐式同步、Mongo 空供应商序列化。
- 页面:本地隔离数据验证添加内部成员、项目同步勾选、未勾选项目保持、移动窗口布局。页面模拟数据不等于 Fanyu 真实业务验收。
- 部署后仍需在测试项目验证实际切片物化、标注提交、质检、打回及最终验收;不使用现有业务账号做自动数据修复。
## Fanyu 发布与回退(仅处理版本兼容)
- API 使用 `Recreate`:先停止旧实例,再启动新实例。会有短暂 API 不可用窗口;发布前让操作人员保存并停止提交。本规则不增加员工操作限制,也不修改 Worker、算子和业务数据。
- 发布前使用 Fanyu kubeconfig,在 `droboticflow-fanyu` 命名空间对 `droboticflow-api` 应用 `k8s/fanyu-api-recreate.patch.yaml`(merge patch)。只改 strategy 不会触发当前 Pod 重建;更换镜像才会开始更新。
- 通用 `scripts/deploy-k8s.sh` 模板仍为 `RollingUpdate`,本次不改 POC/WJZH 默认行为。Fanyu 不可直接用通用模板覆盖这项策略;若使用完整 manifest,须在 apply 前将 API strategy 改为 `Recreate` 并删除 `rollingUpdate`,不能先更新镜像再补策略。
- 发布后检查:旧 API Pod 已全部退出,新 Pod 镜像 digest 一致且就绪,健康接口的提交号符合预期。验证后再恢复人工操作。
- 兼容回退基线应包含 `41f82b8f` 的内部任务识别及只改归属修正;必须保存经过验证的具体镜像 digest,不能只凭时间或标签选“上一个版本”。当前源代码提交号不是已验证的回退镜像。
- 出现内部成员/内部任务数据后,不直接执行 `kubectl rollout undo`,不恢复到功能引入前的旧镜像。不通过清空归属标记或回滚数据库迁就旧代码。
- 若新版本故障且尚无已验证的兼容镜像,保持维护状态并修复新版本;不得为恢复可用性而绕过任务隔离。首次部署时仍需建立并验收兼容镜像基线。
- 本次仅处理发布和回退问题;员工在完成任务后再删除、不更换供应商是操作约定。此前的未完成状态检查缺口、同步失败恢复问题不在此次修改范围,尤其后者不因该操作约定而消失。

View File

@ -0,0 +1,8 @@
# Fanyu API only. Merge-patch before changing the image; no Pod template changes.
metadata:
name: droboticflow-api
namespace: droboticflow-fanyu
spec:
strategy:
type: Recreate
rollingUpdate: null