Skip to main content

Crate wist_release

Crate wist_release 

Source
Expand description

wist 发布域纯逻辑(不含存储 / 端点 / 鉴权)。

四个模块,两层:

  • package:安装包的身份解析 —— 从「来源 + 包字节」读出 (version, arch); 它同时原样转出底座 crate wist_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());

Modules§

compat
安装包 / 组件的升级兼容性声明与检查。
package
安装包的身份解析:从「来源 + 包字节」读出 (version, arch)。
plan
发布计划的编排口径(与存储 / 物化 / 端点无关)。
rollout
发布计划的灰度:两件事共用一份口径。