rpm on SOW

下载 SOW

Mon, 01 Jan 0001 00:00:00 +0000

可以用 apt install sow 或 dnf install sow 从 Pigsty infra 软件源安装 SOW，也可以使用固定版本的 RPM / DEB 安装包、面向 Linux 与 macOS（amd64 与 arm64）的 tar.gz 归档，或者从某个 Tag 的源码自行构建。每条路径安装的都是同一个自包含可执行文件；每个已发布制品都在 SHA256SUMS 中列出 SHA-256 摘要。安装完成后执行 sow version 与 sow help，然后把 sow create 指向一个存放软件包的目录。

为什么 SOW 每个仓库只保留一棵包体树

Wed, 05 Aug 2026 00:00:00 +0000

这项决策起草于 2026-08-05 的 v0.2 发布前设计收敛阶段，并在 2026-08-08 随 SOW v0.2.0 正式交付，随后延续为 v0.3 与 v0.4 的布局契约。它记录的是架构选择，不是笼统的兼容性 PASS：协议闭包、普通软件包客户端、镜像工具、静态托管与对象存储始终属于彼此独立的证据层。

sow create

Mon, 01 Jan 0001 00:00:00 +0000

sow create 把一个已经放着 .rpm / .deb 的目录变成平面仓库（flat repository）：在包旁边写出索引文件。它就是 Plain 平面模式的全部——没有 sow.yml、没有 SQLite、不做工作区发现。本页讲清单遍扫描契约、--pigsty 完成门禁，以及 --sign-with 的 RPM 包签名。

安装

Mon, 01 Jan 0001 00:00:00 +0000

SOW 只有一个可执行文件，不需要启用服务，也不依赖语言运行时。Release 构建目标是 Linux 与 macOS 的 amd64、arm64；Linux 另外提供 RPM 与 DEB 安装包。不支持 Windows。

搭建 YUM 仓库

Mon, 01 Jan 0001 00:00:00 +0000

本教程从零创建一个 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 推断操作系统版本。

Plain 平面仓库

Mon, 01 Jan 0001 00:00:00 +0000

sow create 接手一个已经放着 .rpm / .deb 的目录，在包旁边生成平面仓库索引。Plain 模式没有工作区、配置文件、数据库、期望状态，也没有操作 journal。包目录就是权威事实来源，所有索引都是当前目录内容的可丢弃投影。

快速上手

Mon, 01 Jan 0001 00:00:00 +0000

Plain 模式在一个目录内生成平面仓库。它不读取 sow.yml，不创建工作区，也不维护数据库。

准备目录

把 RPM 和/或 DEB 文件放在目录顶层。sow create 不递归扫描，也不移动或改名包文件。

包引用

Mon, 01 Jan 0001 00:00:00 +0000

sow rm、sow show、sow where 都接受一个 PACKAGE 参数。本页定义你能在那里写什么。三条命令共用同一套文法,只有对 歧义名称 的处理不同。

这里的内容与 sow add 无关 —— add 接受的是文件系统路径,不是包引用。

包池与元数据视图

Mon, 01 Jan 0001 00:00:00 +0000

不变式

在一个 Repository 内，每个 live Package Object 在 pool/ 下只有一条正典 payload 路径。 Dist 与架构 view 拥有元数据，不拥有包体 alias：

<repo>/pool/...                              正典包体
<repo>/dists/<rpm-dist>/<arch>/repodata/... 纯 RPM 元数据
<repo>/dists/<deb-dist>/main/binary-*/...   纯 APT 元数据

相同 digest 出现在另一个 Repository 或发布 prefix 时，仍是另一个 owner 下的独立对象。 SOW 不会为了本地去重而制造共享的分布式所有权。

演练构建 pigsty-infra 仓库

Mon, 01 Jan 0001 00:00:00 +0000

pgsty/infra-pkg 是 Pigsty Infra 软件包的上游构建源码。本教程假设双架构 RPM 与 DEB 已经构建完成，只处理后半程：从一堆包开始，用 SOW 建成真正可消费、可维护的 infra 仓库。

1. 把包集中到 ~/repo

本教程固定使用 ~/repo，不再为每条路径定义环境变量。先把已有包复制进两个输入目录：

签名模型

Mon, 01 Jan 0001 00:00:00 +0000

客户端会对一个仓库提两个不同的问题,SOW 用两套彼此独立的机制分别回答。把它们混为一谈,是"我明明签了名,dnf 还是报错"这类问题最常见的来源 —— 所以本页先把两者拆开。

平台与集成

Mon, 01 Jan 0001 00:00:00 +0000

本页说明 SOW 提供哪些构建目标、工作区依赖什么存储语义，以及自动化集成具体覆盖哪些行为。仓库生成在 SOW 二进制内部完成；部署后的最终门禁仍是实际软件包管理器。

sow export

Mon, 01 Jan 0001 00:00:00 +0000

SOW 提供一个导出子命令：sow export rpm-leaf。它创建外部、独立的 RPM 仓库， repodata 使用本地 pool/... href。

语法

sow export rpm-leaf DIST ARCH DIR [--hardlink] [-C|--workdir DIR] [-r|--repo NAME] [--json]

参数	要求
`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 或锁参数。