标签: publish

SOW 0.4.0 是一次面向 Managed 仓库的完整性与恢复版本：它明确了深度校验的 I/O 契约， 禁止跨无关密钥拼装 RPM 信任，提供可审计的发布目标可变配置修正路径，并补齐 v0.3 迁移与 发布中断恢复的剩余缺口。 Plain 仓库行为与公共 pool/ + dists/ 布局均未改变。 从 0.3 升级 必须逐个显式迁移 v0.3 Repository 先停止全部 Workspace 写入并完成备份，再安装 0.4.0；在执行普通读写命令之前，对每个 Repository 运行 …

SOW 0.4.0 已完成最终决策 本记录的早期版本曾提议采用 rclone Executor、publish --dry-run 与独立 sow audit 命令。这些表面均未进入 0.4.0：SOW 不依赖 rclone，publish 没有 --dry-run，sow audit 也不是有效命令。 本页保留决策边界，避免历史提案被误解为当前产品。规范行为以 sow publish与 发布与恢复为准。 最终决策 SOW 0.4.0 保留原生 filesystem 与 r2 发布 …

构建与发布是两个独立状态迁移。构建产生与 target 无关的 Generation；发布把该 Generation 应用到一个供应商前缀，并记录足以在不猜测的前提下恢复的证据。 所有权拆分 Repository 作用域 Target prefix 作用域 Package Object Publication Attempt Desired 与 Built 状态 Applied Checkpoint Generation 与 Changeset 远端 inventory retained 包体/ …

SOW 0.2.0 是 Pigsty 出品的自包含 RPM/DEB 仓库管理器，Release 资产以单个 Go 可执行文件覆盖 Linux 与 macOS 构建目标。 两种工作模式 Plain 模式 给目录顶层已有的 RPM 与 DEB 文件就地生成索引： sow create /srv/repo 它写入 repodata/、Packages 与 Packages.gz。Plain 模式没有 Workspace、状态数据库、 Generation，也不生成或签署 DEB Release。 …

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 …

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] 参数 含义 默认值 …

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 输 …

pgsty/infra-pkg 是 Pigsty Infra 软件包的上游构建源码。 本教程假设双架构 RPM 与 DEB 已经构建完成，只处理后半程：从一堆包开始，用 SOW 建成真正可消费、可维护的 infra 仓库。 1. 把包集中到 ~/repo 本教程固定使用 ~/repo，不再为每条路径定义环境变量。先把已有包复制进两个输入目录： mkdir -p ~/repo/packages/rpm ~/repo/packages/deb cp …

SOW 只生成静态文件，不是 HTTP 服务器。本指南把可写 Workspace 与 Nginx 服务路径分开。 公共与私有路径 模式 公共单元 绝不能服务 Plain 传给 sow create 的目录 临时 .sow-plain-stage-* 输出；没有持久 journal Managed 一个 Repository 的完整 pool/ + dists/ 树 Workspace sow.yml、.sow/、SQLite、锁、日志与 staging 第一个工作区里的源 Repository …

这里的教程都从全新工作区开始。请按顺序执行命令，并按你的环境替换大写占位符与包路径。 如果还没装 SOW，先看安装与快速上手。 下面的教程介绍 Managed 仓库路径。 搭建 YUM 仓库 托管 RPM 仓库：分架构视图、noarch 中性投影、debuginfo 过滤、版本数量上限，以及可用的 dnf 客户端配置。 搭建 APT 仓库 托管 DEB 仓库：Debian 风格包池、by-hash 索引与 deb822 客户端配置。 仓库签名 生成专用 GPG 签名钥，为仓库元数据与 RPM 包 …

设计归档解释 SOW 为什么采纳某项契约、否决了哪些替代方案，以及结论实际达到了哪一层证据。 文章按 date 排列，记录设计理由首次形成可维护正文的日期；lastmod 记录后续编辑或与 实现对齐的日期。功能实际在哪个版本交付，仍以发布注记与源码 Tag 为准。 权威与证据 本专栏是持续维护的设计理由与决策历史权威来源。当前命令、配置与运维行为仍以 SOW 文档为准；历史版本的精确行为则绑定对应源码 Tag 与发布注记。 每项运维结论都应与它真正达到的证据层一致： 设计 -> 实现 -> 聚焦 …