wist-release
wist 发布域的纯逻辑内核:安装包与发布计划两件事的口径,只此一份。
「包管理」和「发布计划」在两侧应用里原本各写一遍(中心的托管制品发布、网关的 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):
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 报文。