搭建 YUM 仓库
创建托管 RPM 仓库，配置成员策略，对外服务并接入 dnf。
本教程从零创建一个 Managed RPM 仓库。你需要一个可写目录，以及一个或多个
RPM 文件。
1. 创建工作区
mkdir -p /srv/sow
cd /srv/sow
sow init .
sow repo new pigsty
sow dist new el9 --format rpm -r pigsty
Dist 名称由你定义。SOW 不会根据 el9 推断操作系统版本。
2. 配置成员策略
编辑生成的 sow.yml。下面的配置按包名与架构各保留一个版本，并排除调试包：
schema: sow/v3
architectures: [x86_64, aarch64]
repos:
pigsty:
dists:
el9:
format: rpm
limit: 1
exclude:
- kind: [debuginfo, debugsource, llvmjit]
targets: {}
手工修改配置后，先校验再写仓库状态：
sow config check
sow config show --all
策略先执行 exclude，再执行 limit。noarch 包会投影到每个启用的架构视图，不能写进
architectures。
3. 添加 RPM
sow add /path/to/packages/*.rpm -r pigsty -d el9
sow status -r pigsty
sow check -r pigsty
add 解析包头，将每个接纳的包只保存一次，更新 Desired 成员关系并落成新 Generation。
被策略排除的输入会逐项报告，但不算命令失败。
公共树如下：
/srv/sow/pigsty/
├── pool/...
└── dists/el9/
├── x86_64/repodata/...
└── aarch64/repodata/...
rpm-md 的 location href 通过相对路径访问根目录下的 pool/。不要只复制某个架构目录；
它不是独立仓库。
4. HTTP 预览
本地预览可以直接使用：
cd /srv/sow
python3 -m http.server --bind 127.0.0.1 8080
在另一个终端检查入口：
curl --fail http://127.0.0.1:8080/pigsty/dists/el9/x86_64/repodata/repomd.xml >/dev/null
长期服务应使用持续维护的 HTTP Server。它必须完整暴露 pigsty/ 树，确保客户端解析后落到
pigsty/pool/ 的软件包 URL 可访问。
5. 配置 dnf
将 REPO_HOST 替换为客户端可访问的地址：
# /etc/yum.repos.d/pigsty.repo
[pigsty-el9]
name=Pigsty EL9
baseurl=http://REPO_HOST:8080/pigsty/dists/el9/$basearch/
enabled=1
gpgcheck=0
repo_gpgcheck=0
刷新并查询仓库：
sudo dnf clean metadata
sudo dnf makecache --refresh
dnf --disablerepo='*' --enablerepo=pigsty-el9 list available
这里有意使用未签名配置。只有完成仓库签名后，才应打开客户端验签。
6. 发布或导出
交付前必须通过深度校验：
向已配置的 filesystem 或 R2 目标交付时，使用 sow publish。
只有先复制到离线 staging、再原子切换上线时，才适合整根复制；不要对在线仓库做无序原地同步。
默认 dnf reposync 等工具会拒绝指向根包池的父级相对路径。遇到这种消费者时，导出一份
自包含 RPM Leaf：
sow export rpm-leaf el9 x86_64 /srv/export/pigsty-el9-x86_64 -r pigsty
目标目录必须不存在或为空。默认会复制包体；--hardlink 只适用于同一文件系统、可信且只读的
显式优化场景。
更新仓库
sow add /path/to/new.rpm -r pigsty -d el9
sow rm PACKAGE_NAME -r pigsty -d el9
sow build -r pigsty
sow check -r pigsty
add 与 rm 修改 Desired 成员关系；策略或签名配置变化后用 build 收敛；发布门禁是
check，不能只看 status。
自动化客户端与平台覆盖见平台与集成。