sow export
SOW 提供一个导出子命令：sow export rpm-leaf。它创建外部、独立的 RPM 仓库，
repodata 使用本地 pool/... href。
语法
| 参数 | 要求 |
|---|---|
DIST |
已配置的规范 RPM Dist 名称 |
ARCH |
x86_64 或 aarch64 |
DIR |
不存在或为空，且不与 Repository、私有状态、filesystem 目标根重叠的目录 |
| 选项 | 含义 | 默认值 |
|---|---|---|
--hardlink |
对可信、同文件系统、只读目标使用硬链接 | 复制文件 |
-C, --workdir DIR |
工作区发现起点 | 当前目录 |
-r, --repo NAME |
选择 Repository | 选择规则 |
--json |
输出 sow.cli/v1 Envelope |
false |
该命令不接受 --dist、jobs、timeout 或锁参数。
输出
目标目录包含：
- 使用本地包体 href 重写的 RPM repodata；
- 所需软件包目录树；
- 导出 Manifest；
.sow-export.json来源记录。
源必须是已完成的 Built Generation。导出物是独立制品，不属于 Desired Membership、 Built Generation、发布输入或 GC 根。
导出失败可能在 DIR 留下半成品；导出没有 journal 或自动回滚。保持该目录离线，修正原因
（例如签名私钥不可用），然后换一个不存在或为空的输出目录重试。不要发布失败产物，也不要
期望重跑命令自动合并非空目录。
Managed RPM 与 export rpm-leaf 的 repomd data 时间戳固定为 0，没有
--metadata-timestamp 选项。因此它们不能直接接管保留了正数时间戳缓存的同一个 EL7
repository ID；换 baseurl 本身不能解决。需要客户端采用新的 repository ID 或清理元数据缓存。
若必须保留旧 ID 和缓存继续更新，请使用带显式时间戳的 Plain create，按
迁移指南 维护发布时间并重签 repomd。
复制与硬链接
复制是安全默认值。--hardlink 只适用于同一文件系统、且消费者无法修改的可信只读目标。硬链接
包体与 SOW 包池共享 inode，不能用于可写或不可信目标。创建（以及之后删除）这些硬链接会改变共享
Pool 文件的 ctime，因此下一次构建会对这些包体重新哈希一次，以刷新其快速校验指纹。
SOW 会拒绝与已配置 filesystem 发布根重叠的输出，避免导出物被误认为或修改 Managed 发布目标。
退出行为
| 代码 | 触发条件 |
|---|---|
0 |
独立 RPM leaf 导出完成 |
1 |
文件系统、复制、硬链接或元数据写入错误 |
2 |
命令语法、Dist/架构 Token 无效，或发现/隐式 Repository 选择有歧义 |
5 |
源 Generation 或 Repository 状态不一致 |
6 |
显式 Repository 未配置、Dist 不是 RPM、视图/签名者不可用，或目标不安全/非空/重叠 |
参见
- 平台与集成 —— 已验证与明确不支持的工作流
- 仓库布局 —— 源目录与导出边界
sow publish—— 向配置目标执行 Managed 交付