sow rm

从选定 Dist 中移除期望成员，并提供不写盘的预览模式。

sow rm 把包从你选定的 Dist 的期望成员集中拿掉，并默认立即重建受影响的索引。它不会从 pool/ 删除字节——成员关系与内容是两个概念,回收由独立的保守操作 sow gc 完成。

语法

sow rm PACKAGE... [-c|--check] [--skip] [-j|--jobs N] [-C|--workdir DIR] [-r|--repo NAME] [-d|--dist NAME]... [-T|--timeout DUR | -N|--no-wait] [--json]

参数

参数说明默认
-c, --check只预览：计算并打印方案，不写任何东西关闭
--skip只更新期望状态，不构建关闭
-j, --jobs N并发 worker 数逻辑 CPU 数
-C, --workdir DIR工作区发现的起始目录当前目录
-r, --repo NAME选择一个仓库按选择规则
-d, --dist NAME选择一个 Dist；可重复按选择规则
-T, --timeout DUR等待锁的最长时间；0 无限等待0
-N, --no-wait锁被占用时立即失败false
--json输出版本化 JSON envelopefalse

--check 与 --skip 互斥：

sow rm epel-release -c --skip
usage error: --check and --skip are mutually exclusive

包引用

PACKAGE 接受五种形态。完整文法与歧义规则见包引用，简版如下：

形态例子
内容哈希sha256:d6f332ed157de1d42058ec785b392a1cc4b5836c27830af8fbf083cce29ef0ab
RPM 坐标rpm:epel-release-0:7-5.noarch
DEB 坐标deb:libpq5=18.3-1:amd64
完整文件名epel-release-7-5.noarch.rpm
裸二进制包名epel-release

裸名表示选定 Dist 中该名称的全部版本与原生架构——正因如此，sow rm patroni 才是一条好用的下架 命令。非裸名的模糊短引用会失败并列出候选，而不是替你猜。

sow ls 会直接打印精确的 sha256: 引用与规范化坐标，你不需要手工 拼接。

引用匹配不到任何东西属于拒绝，不是静默成功：

sow rm nosuch -r pigsty -d el9
operation rejected: managed: operation rejected: package reference not found: package reference "nosuch" matches no Desired Membership

没有 --allow-empty、没有 --all、没有 --yes、没有 --source-list。

用 –check 预览

-c/--check 精确算出会移除什么、策略随后会怎么判定、以及立即构建会触碰哪些文件——并且什么都不写。

sow rm centos-release -r pigsty -d el9 -c
{"repository":"pigsty","desired_revision":6,"built_generation":6,"dirty":false,"check":true,"removed":[{"dist":"el9","sha256":"ffd9e7bdaa4884831a6c055ada01dac96b84c50a8d518dac409b445af5dadc16","coordinate":"rpm:centos-release-0:6-0.el6.centos.5.x86_64","name":"centos-release"},{"dist":"el9","sha256":"b4111ef2a51542eacc9bd1ebd080da02e53d400f9d172530c75a1e4ac06e7ead","coordinate":"rpm:centos-release-0:7-2.1511.el7.centos.2.10.x86_64","name":"centos-release"}],"dists":["el9"],"changes":[{"op":"add","path":"dists/el9/x86_64/repodata/29eb03d70470cb4ed836017414d6039482e6ee8e4cdfbafe9cc78ba052c8d2dc-filelists.xml.gz","phase":"metadata","size":374,"sha256":"29eb03d70470cb4ed836017414d6039482e6ee8e4cdfbafe9cc78ba052c8d2dc"},{"op":"update","path":"dists/el9/x86_64/repodata/repomd.xml","phase":"pointer","size":1511,"sha256":"ef071821e06c9e86ab4f6d2a56906d82bb66df251e79d1086cfd44dc8395513e"},{"op":"delete","path":"dists/el9/x86_64/repodata/85de802ed1249f8693c973ae44d704e3cc5047da571b52c1ddebc8de35a46b60-primary.xml.gz","phase":"delete"}]}

注意两个 centos-release 版本都被裸名命中了。changes 数组是一份真实的交付计划，按 payload → metadata → pointer → delete 的阶段顺序排列。

--check 有意不取写锁。把它与锁参数一起用是用法错误，免得有人以为预览会排队等待写事务：

sow rm centos-release -r pigsty -d el9 -c -T 5s
usage error: rm --check does not accept --timeout or --no-wait

默认行为：移除并重建

不带 --check 或 --skip 时，rm 提交期望状态变更，并在返回前重建每个受影响的 Dist。pool 对象 留在磁盘上。

sow rm 'rpm:centos-release-0:6-0.el6.centos.5.x86_64' -r pigsty -d el9
{"operation":"1811402670494469758","repository":"pigsty","desired_revision":6,"built_generation":6,"dirty":false,"check":false,"removed":[{"dist":"el9","sha256":"ffd9e7bdaa4884831a6c055ada01dac96b84c50a8d518dac409b445af5dadc16","coordinate":"rpm:centos-release-0:6-0.el6.centos.5.x86_64","name":"centos-release"}],"dists":["el9"],"changes":[...]}

和 sow build、sow show 一样，rm 即使不加 --json 也在 stdout 打印结构化 JSON；加上 --json 则套上标准 envelope。

移除一个 Dist 的最后一个成员是允许的。SOW 仍会渲染合法的空索引（配了 key 就带签名）——空的 Packages 配可验签的 InRelease，或每架构的空 repodata/。

–skip

--skip 提交期望状态变更并把仓库标为 dirty，不触碰公开树。旧的 Built Generation 对客户端依然完全 自洽。

sow rm 'rpm:centos-release-0:6-0.el6.centos.5.x86_64' -r pigsty -d el9 --skip
{"operation":"1811402670494469758","repository":"pigsty","desired_revision":6,"built_generation":5,"dirty":true,"check":false,"removed":[...],"dists":["el9"],"changes":[]}

sow status -r pigsty
repository=pigsty status=dirty ready_to_copy=false revision=6 generation=5 dirty_dists=el9 pending=0/0 locked=false

changes 为空是因为什么都没构建。执行 sow build 收敛。

与策略的交互

移除属于期望状态编辑，因此策略会在新的候选集上重新求值——移除操作绝不会让先前被 limit 挤掉的包 复活。如果你从一个 limit: 1 的 Dist 里删掉 libpq5 18.3-1，18.2-1 不会回来；需要重新显式 add。

示例

安全下架——先预览，再执行：

sow rm patroni -r pgsql -d el9 -c
sow rm patroni -r pgsql -d el9

一次从两个 Dist 中移除同一个精确对象：

sow rm sha256:d6f332ed157de1d42058ec785b392a1cc4b5836c27830af8fbf083cce29ef0ab -r pgsql -d el9 -d el9-beta

批量移除后只重建一次：

sow rm old-tool legacy-agent -r pgsql -d el9 --skip
sow build -r pgsql -d el9
sow check -r pgsql

把预览计划喂给其他工具：

sow rm patroni -r pgsql -d el9 -c --json | jq -r '.result.changes[] | "\(.phase)\t\(.op)\t\(.path)"'

退出码

码触发条件
0成员已移除并重建，或 --check 预览已打印
1运行时 I/O 或渲染失败
2用法错误——--check 与 --skip 同用、--check 与锁参数同用、选择有歧义、工作区未找到
3部分批次——至少一个引用被移除，至少一个失败
4仓库锁被占用，且给了 --no-wait 或 --timeout 到期
5完整性或恢复错误
6引用无匹配，或非裸名的引用有歧义

参见

最后修改：2026-08-08: docs: align site with SOW v0.2.0 (9c98f8c)