apt on SOW

为什么 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：协议闭包、普通软件包客户端、镜像工具、静态托管与对象存储始终属于彼此独立的证据层。

搭建 APT 仓库

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

本教程从零创建一个 Managed DEB 仓库。你需要一个可写目录，以及一个或多个 DEB 文件。

1. 创建工作区

mkdir -p /srv/sow
cd /srv/sow
sow init .
sow repo new pigsty
sow dist new trixie --format deb -r pigsty

Dist 名称会成为 APT Suite。它由你定义；SOW 不会根据 trixie 推断发行版语义。

教程

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

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

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

搭建 YUM 仓库

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

仓库签名

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

SOW 提供两条互相独立的签名路径：

路径	产物	客户端开关
RPM 元数据	`repodata/repomd.xml.asc`	`repo_gpgcheck=1`
APT 元数据	`InRelease` 与 `Release.gpg`	`Signed-By`
RPM 包体	RPM 内嵌签名	`gpgcheck=1`

APT 通过签名的 Release 信任包哈希；SOW 不重签 DEB 包体。先配置元数据签名；只有当你负责这些 RPM 字节的签名策略时，再启用包体签名。

签名模型

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

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

平台与集成

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

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