Skip to main content

wist_release/
lib.rs

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