4.1 KiB
v4 新工作流启用核对表
本页记录 2026-10-22 用户确认的范围,不是已部署证明。实际摘要、目标 UID、镜像和执行状态保存在被 Git 忽略的发布记录中。
范围与顺序
- 在独立工作树验证 API/处理器、Worker、独立 package 镜像,保存源码、基础镜像、产物字节与 digest 的对应证据。API/处理器使用
scripts/release.py;Worker、字典和工作流切换另附有界计划。 - 在 v4 尚未激活时,按发布工具先处理器后 API;随后更新兼容新旧协议的 Worker 镜像与构建标记,确认原来的 2 副本完整就绪且所有工作流仍使用旧协议。再将 Worker 暂停至 0 副本并确认扫描进程退出,完成字典和工作流切换后恢复同一已验证镜像的 2 副本。现有独立算子 Job 不删除,暂停期间调度及状态收敛暂时停顿。不更新 Coordinator、validator、Secret、资源规格或存储配置。
- 按预览清单为当前无 tags 的启用词条初始化
tags=[名称],递增版本并追加历史。逐条比较原版本、名称、状态、更新时间与标签;发现漂移停止,不覆盖管理员的新修改。此步骤不更新任务、草稿或已冻结字典选择。 - 对每个目标项目创建隐藏的新工作流版本,仅修改 package 的固定镜像、
PART_INDEX_DELIVERY=true、DELIVERY_JSON_V4=true、DELIVERY_JSON_V3=false、SOURCE_INDEX_DELIVERY=true、PIN_OPERATOR_IMAGE=true,并添加内部 JSON 输出deliveryAudit。保留原节点、边、输入、供应商、接入目录、并发和验收抽样策略;逐项比较允许变更以外的内容。 - 检查内置 artifact 存储与客户目录隔离、完整的每 part 原始选择及 meta、分类标签、两相机时钟和验收固定修订。全舍弃、无描述继承、无效动作及独立动作词条均须有验证证据。
- 在停止新接入扫描并确认旧扫描已退出的短窗口内激活新版本。仅未启动采集可以转入新版本;
launching、有 Run 的采集及其父子运行保留旧归属,新监听器识别并排除这些已接入目录。保留原记录 ID,防止(workflowId,prefix)冲突;不能删除登记后重扫。 - 只读检查目标版本、旧任务归属、新旧镜像及实际交付格式。生产写入验收必须另列隔离项目、账号和合成输入范围;单凭 Ready、模拟存储测试或单独算子测试不能标记真实业务验收通过。
交付与回退
客户文件只含最终分类、标签、区间和来源。审核人员、批注、返工和阶段事件只存内部 deliveryAudit,超限或写失败必须阻断客户发布;不得静默省略。
旧 v1–v3 算子输出须有字节兼容回归,旧工作流继续固定原 package 镜像。不可变交付目录、归属标记和已发布索引不原地覆盖。新批次发布仍按已有预览和确认接口执行。
切换失败或结果未知时停止后续写入,先只读核对实际状态。新版本已经接入的任务不能被重新绑定为旧协议;退回监听器也不能重复接入这些目录。旧 API 会在后续保存时丢弃新字典字段,不能把直接换回旧镜像描述为无损回退。需要保留新字段的兼容回退候选,或单独确认暂停相关写入的恢复方案。回退不撤销已确认标签初始化、不删除内部审核证据或客户新批次。
发布门禁
发布必须同时具有具体镜像来源、release.py 检查、Worker/工作流/字典计划、上线前漂移复核及用户对展示后计划的部署授权。算子历史 release manifest 的已知漂移不得通过重算旧摘要掩盖;只能为真实构建和发布的新 package 绑定新的来源及摘要,其他环境和算子记录保留。
独立 package 发布后使用 OPERATOR_RELEASE_ENV=fanyu python3 scripts/generate_operator_repository_manifests.py --slug package --check 验证这一算子的发布和生成清单;不带 --slug 的全量检查行为保持严格。未修改算子的既有漂移另列遗留,不更新其镜像、源码摘要或目录记录来凑齐通过。所选 package 的任何摘要漂移仍阻断本次发布。