wist-release 0.6.2

wist 发布域纯逻辑:安装包身份解析(version/arch)+ 发布计划灰度(切阶段与推进闸门)。不含存储、端点、鉴权。
Documentation

wist-release

wist 发布域的纯逻辑内核:安装包与发布计划两件事的口径,只此一份。

crates.io docs.rs Downloads CI License: Apache-2.0

「包管理」和「发布计划」在两侧应用里原本各写一遍(中心的托管制品发布、网关的 agent 包与灰度 升级),口径很容易漂移:同一套阶梯切分、同一套包身份解析,改了一边忘了另一边。本 crate 把这两块 纯逻辑抽出来共用 —— 不含存储、不含 HTTP 端点、不含鉴权,那三层仍由各应用自己负责。

模块

模块 内容
package 安装包内核:来源读取(本机路径 / URL)、摘要校验、身份解析(version/arch)、内容寻址 id、制品命名、路径段安全、摘要与版本口径
rollout 发布计划的灰度:切阶段(「目标 + 阶段数」→ 互不重叠的 1 / 10% / 30% / 70% / 全量)+ 放行(推进闸门的校验与判定、批次节流、条目状态折叠、确定性 work id)
compat 包/组件的升级兼容声明:从包内 compat.json 读 requires / supports / coexists_with,按当前节点版本判定 ok / warn / error / unknown,产出结构化报告

compat:包内兼容声明

发布侧在包里放一份可选的 compat.json(包根或第一层目录;文件名也接受 wist-compat.json):

{
  "component": "wist-agentd",
  "requires":  { "wist-gateway": ">=0.9.0 <0.10.0" },
  "supports":  { "wist-agentd": ">=0.1.12" },
  "coexists_with": { "wist-gateway": ">=0.8.0" },
  "compat_mode": true,
  "bridge": [],
  "reversible": false
}
  • requires 不满足 → error(默认阻止安装/激活/发布),报告会点名“先升级当前节点”;
  • supports 不在范围 → warn;
  • requires 不满足但 coexists_with 满足且 compat_mode=true → warn(需要开兼容模式);
  • 没有 compat.json → unknown(允许,但必须显式显示“未验证兼容性”)。

版本范围支持 *、1.2.3、>=、>、<=、<、=、^、~, 多个条件用空格/逗号(AND),多个候选用 ||(OR)。

package 里除了安装包身份,还有几个同一套口径只该有一份的小件:

口径 入口
取来源(机制 / 策略分开) read_source、read_source_within、read_source_with_client、read_local_source
摘要 sha256_hex_bytes、parse_digest、read_verified_source
版本 normalize_version、parse_version、version_is_newer
内容寻址 id content_id、package_id_for_sha256
路径段安全 / 命名 is_safe_path_segment、artifact_filename

package 的两套身份口径

安装包的身份解析有两种合理的严格度,本 crate 各给一个入口,调用方按包的类别选:

函数 场景 规则
read_package_identity 中心托管任意包 版本取包内顶层目录名(切得出优先),平台取目录名的 target-triple、切不出再回落来源文件名(部署栈包顶层是 sys/…,版本只在文件名里;galaxy-ops 顶层只有 <name>-<version>,平台只在文件名里)
read_binary_package_identity 网关的 agent 二进制安装包 只认包内目录名,且必须切出已知 target-triple;读不出架构就整体留空,绝不把版本错切出来

消费方

  • wist-center —— 托管制品的发布(包录入、发布计划)。
  • wist-gateway —— agent 安装包的获取与灰度升级。

相关 crate

  • wist-control —— 中心面 seam 报文与领域模型。
  • wist-api —— agent 面 seam 报文。

License

Apache-2.0