Expand description
wist 发布域纯逻辑(不含存储 / 端点 / 鉴权)。
四个模块,两层:
package:安装包的身份解析 —— 从「来源 + 包字节」读出(version, arch); 它同时原样转出底座 cratewist_artifact的制品口径(取来源 / 摘要 / 版本比较 / 命名)。rollout:发布计划的灰度 —— 切阶段(目标 + 阶段数 → 互不重叠的阶段)与放行 (推进闸门 / 批次节流 / 确定性 work id)。plan:把上面的原子规则串成状态机 —— 建草稿 / 批准 / 推进闸门 / 推进 / 结果回填后 自动推进 / 重试重开;中心与网关共用这一份编排。compat:包/组件的升级兼容声明 —— 读包内compat.json的requires/supports/coexists_with,按当前节点版本产出ok / warn / error / unknown报告。
分层:两边都要用的制品口径在 wist_artifact(被管端 agentd 也只依赖那一层);
本 crate 只装发布域的概念 —— 包长什么样、灰度怎么走。控制面的两侧应用
(wist-center 托管制品的发布、wist-gateway 的 agent 包与灰度升级)共用本 crate。
§例:把机队切成三段灰度
use wist_release::rollout::plan_phases;
let fleet: Vec<String> = (1..=10).map(|i| format!("gw-{i:03}")).collect();
let phases = plan_phases(&fleet, 3)?;
assert_eq!(phases.len(), 3);
assert!(phases[0].is_canary); // 首批 1 台,金丝雀
assert!(phases[2].is_final); // 末批铺满剩余
// 阶段之间**互不重叠**,且每个目标恰好出现一次。
let mut covered: Vec<String> = phases.iter().flat_map(|p| p.target_ids.clone()).collect();
covered.sort();
covered.dedup();
assert_eq!(covered.len(), fleet.len());