publish on SOW

SOW v0.4.0

Mon, 24 Aug 2026 00:00:00 +0000

SOW 0.4.0 是一次面向 Managed 仓库的完整性与恢复版本：它明确了深度校验的 I/O 契约，禁止跨无关密钥拼装 RPM 信任，提供可审计的发布目标可变配置修正路径，并补齐 v0.3 迁移与发布中断恢复的剩余缺口。

协同发布决策记录

Fri, 14 Aug 2026 00:00:00 +0000

SOW 0.4.0 已完成最终决策

本记录的早期版本曾提议采用 rclone Executor、publish --dry-run 与独立 sow audit 命令。这些表面均未进入 0.4.0：SOW 不依赖 rclone，publish 没有 --dry-run，sow audit 也不是有效命令。

SOW v0.2.0

Sat, 08 Aug 2026 00:00:00 +0000

SOW 0.2.0 是 Pigsty 出品的自包含 RPM/DEB 仓库管理器，Release 资产以单个 Go 可执行文件覆盖 Linux 与 macOS 构建目标。

两种工作模式

Plain 模式 给目录顶层已有的 RPM 与 DEB 文件就地生成索引：

设计归档

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

设计归档解释 SOW 为什么采纳某项契约、否决了哪些替代方案，以及结论实际达到了哪一层证据。文章按 date 排列，记录设计理由首次形成可维护正文的日期；lastmod 记录后续编辑或与实现对齐的日期。功能实际在哪个版本交付，仍以发布注记与源码 Tag 为准。

发布与恢复

Sat, 08 Aug 2026 00:00:00 +0000

构建与发布是两个独立状态迁移。构建产生与 target 无关的 Generation；发布把该 Generation 应用到一个供应商前缀，并记录足以在不猜测的前提下恢复的证据。

所有权拆分

Repository 作用域	Target prefix 作用域
Package Object	Publication Attempt
Desired 与 Built 状态	Applied Checkpoint
Generation 与 Changeset	远端 inventory
retained 包体/元数据引用	grace 与删除证据

这项拆分避免把 filesystem 发布成功当成 R2 的证据，也避免一个 target 的半完成尝试污染另一个。

教程

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

这里的教程都从全新工作区开始。请按顺序执行命令，并按你的环境替换大写占位符与包路径。

如果还没装 SOW，先看安装与快速上手。下面的教程介绍 Managed 仓库路径。

搭建 YUM 仓库

托管 RPM 仓库：分架构视图、noarch 中性投影、debuginfo 过滤、版本数量上限，以及可用的 dnf 客户端配置。

服务与发布仓库

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

SOW 只生成静态文件，不是 HTTP 服务器。本指南把可写 Workspace 与 Nginx 服务路径分开。

公共与私有路径

模式	公共单元	绝不能服务
Plain	传给 `sow create` 的目录	临时 `.sow-plain-stage-*` 输出；没有持久 journal
Managed	一个 Repository 的完整 `pool/ + dists/` 树	Workspace `sow.yml`、`.sow/`、SQLite、锁、日志与 staging

第一个工作区里的源 Repository 是 /srv/sow/local。不要把 /srv/sow 设为 document root。

演练构建 pigsty-infra 仓库

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

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

1. 把包集中到 ~/repo

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

sow changes

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

sow changes 比较 Built Generation，输出物理的 Repository 相对文件差异。它不显示尚未构建的 Desired 变化，也不是远端事务协议。

语法

sow changes [BASE_GENERATION] [-C|--workdir DIR] [-r|--repo NAME] [--json]

参数	含义	默认值
`-C, --workdir DIR`	工作区发现起点	当前目录
`-r, --repo NAME`	选择 Repository	选择规则
`--json`	输出 `sow.cli/v1` Envelope	false

该命令作用于整个 Repository，明确拒绝 -d/--dist。

sow publish

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

sow publish 将某个 Repository 的当前 Built Generation 交付到 sow.yml 的 targets: 中指定的目标。目标已经绑定 Repository 与 Provider，因此命令不接受 --repo 或 --dist。

语法

sow publish TARGET [--abort | --rebind] [-C|--workdir DIR] [-T|--timeout DUR | -N|--no-wait] [--json]

参数	含义	默认值
`--abort`	放弃已对账、但尚未写入持久 commit intent 的尝试	false
`--rebind`	确认并记录允许修改的目标名称、公共端点或缓存 TTL	false
`-C, --workdir DIR`	工作区发现起点	当前目录
`-T, --timeout DUR`	最长 Repository 等锁时间；`0` 表示无限等待	`0`
`-N, --no-wait`	锁被占用时立即失败	false
`--json`	输出 `sow.cli/v1` Envelope	false

TARGET 必须是已配置的 filesystem 或 r2 发布目标。--abort 与 --rebind 互斥。

sow gc

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

sow gc 有两种严格分离的模式：不带位置目标时，回收本地不可达包体；带 TARGET 时，维护一个已配置发布目标。

语法

sow gc          [-C|--workdir DIR] [-r|--repo NAME] [-T|--timeout DUR | -N|--no-wait] [--json]
sow gc TARGET   [-C|--workdir DIR]                  [-T|--timeout DUR | -N|--no-wait] [--json]

参数	含义	默认值
`-C, --workdir DIR`	工作区发现起点	当前目录
`-r, --repo NAME`	仅用于选择本地 GC 的 Repository	选择规则
`-T, --timeout DUR`	最长 Repository 等锁时间；`0` 表示无限等待	`0`
`-N, --no-wait`	锁被占用时立即失败	false
`--json`	输出 `sow.cli/v1` Envelope	false

目标自身已绑定 Repository，因此 gc TARGET -r NAME 属于用法错误。两种模式都不接受 --dist。