分类: Reference
-
平台与集成
本页说明 SOW 提供哪些构建目标、工作区依赖什么存储语义，以及自动化集成具体覆盖哪些行为。 仓库生成在 SOW 二进制内部完成；部署后的最终门禁仍是实际软件包管理器。 Release 目标 操作系统 amd64 arm64 制品 Linux 是 是 归档、RPM、DEB macOS 是 是 归档 Windows 否 否 不支持 Release 二进制使用 CGO_ENABLED=0，不需要语言运行时。0.4.0 制品使用 Go 1.27.0 构建； 源码 Module 要求 Go 1.27.0 …
本页说明 SOW 提供哪些构建目标、工作区依赖什么存储语义，以及自动化集成具体覆盖哪些行为。 仓库生成在 SOW 二进制内部完成；部署后的最终门禁仍是实际软件包管理器。 Release 目标 操作系统 amd64 arm64 制品 Linux 是 是 归档、RPM、DEB macOS 是 是 归档 Windows 否 否 不支持 Release 二进制使用 CGO_ENABLED=0，不需要语言运行时。0.4.0 制品使用 Go 1.27.0 构建； 源码 Module 要求 Go 1.27.0 …
-
JSON 输出
所有产出数据的命令都接受 --json。输出是 stdout 上的 一行 版本化信封 —— 不管是哪条命令产生的,都能直接管道给 jq。 sow status --json {"schema":"sow.cli/v1","command":"status","ok":true,"repository":"pigsty","operation":null, …
所有产出数据的命令都接受 --json。输出是 stdout 上的 一行 版本化信封 —— 不管是哪条命令产生的,都能直接管道给 jq。 sow status --json {"schema":"sow.cli/v1","command":"status","ok":true,"repository":"pigsty","operation":null, …
-
退出码
每条 sow 命令都以七个退出码之一结束。它们是稳定的、对所有命令一致, 并且就是设计来给脚本做分支判断的 —— 区分"这件事失败了"和"这件事被正确地拒绝了", 正是设置多个非零码的全部意义。 码 含义 0 完整成功,或幂等 no-op 1 运行时 I/O、解析器、渲染器或未知内部错误 2 用法、工作区发现或配置错误 3 部分成功:至少一项已提交,至少一项失败 4 写锁不可用 —— 被占用且指定了 --no-wait,或等待超时 5 完整性/恢复错误,或 check 判定当前结果不可交付 6 …
每条 sow 命令都以七个退出码之一结束。它们是稳定的、对所有命令一致, 并且就是设计来给脚本做分支判断的 —— 区分"这件事失败了"和"这件事被正确地拒绝了", 正是设置多个非零码的全部意义。 码 含义 0 完整成功,或幂等 no-op 1 运行时 I/O、解析器、渲染器或未知内部错误 2 用法、工作区发现或配置错误 3 部分成功:至少一项已提交,至少一项失败 4 写锁不可用 —— 被占用且指定了 --no-wait,或等待超时 5 完整性/恢复错误,或 check 判定当前结果不可交付 6 …
-
仓库布局
SOW 的 Managed 布局只有一种：软件包体在 pool/ 下只存一份，dists/ 只保存客户端视图元数据。对外服务、复制或发布时,单位始终是完整仓库目录。 Plain 模式 sow create 在现有软件包旁写入索引,不修改无关文件: /srv/offline/ ├── blackbox_exporter-0.28.0-1.x86_64.rpm ├── libpq5_18.3-1.pgdg12+1_amd64.deb ├── repodata/ │ ├── …
SOW 的 Managed 布局只有一种：软件包体在 pool/ 下只存一份，dists/ 只保存客户端视图元数据。对外服务、复制或发布时,单位始终是完整仓库目录。 Plain 模式 sow create 在现有软件包旁写入索引,不修改无关文件: /srv/offline/ ├── blackbox_exporter-0.28.0-1.x86_64.rpm ├── libpq5_18.3-1.pgdg12+1_amd64.deb ├── repodata/ │ ├── …
-
参考
这一部分记录配置字段、包引用、路径、退出码、JSON、平台与集成等稳定契约。CLI 语法和状态变化 见命令，使用模型见上手。 输出示例只说明形态；标识符、路径、哈希、时间戳与计数会随工作区变化。二进制自带的 sow help 始终是精确语法权威。 配置参考 完整配置 schema：工作区、仓库、Dist、成员策略、签名与发布目标。 包引用 命令行上指代一个软件包的五种写法、歧义如何裁决,以及 rm / show / where 各自接受哪些形态。 仓库布局 Plain 与 Managed 两种模 …
这一部分记录配置字段、包引用、路径、退出码、JSON、平台与集成等稳定契约。CLI 语法和状态变化 见命令，使用模型见上手。 输出示例只说明形态；标识符、路径、哈希、时间戳与计数会随工作区变化。二进制自带的 sow help 始终是精确语法权威。 配置参考 完整配置 schema：工作区、仓库、Dist、成员策略、签名与发布目标。 包引用 命令行上指代一个软件包的五种写法、歧义如何裁决,以及 rm / show / where 各自接受哪些形态。 仓库布局 Plain 与 Managed 两种模 …
-
包引用
sow rm、sow show、sow where 都接受一个 PACKAGE 参数。本页定义你能在那里写什么。 三条命令共用同一套文法,只有对 歧义名称 的处理不同。 这里的内容与 sow add 无关 —— add 接受的是文件系统路径,不是包引用。 五种形态 形态 例子 匹配 内容摘要 sha256:d06d7f23b9cf...b98b1229 恰好一个包对象 RPM 坐标 rpm:pev2-0:1.23.0-1.noarch 恰好一个 RPM DEB 坐标 …
sow rm、sow show、sow where 都接受一个 PACKAGE 参数。本页定义你能在那里写什么。 三条命令共用同一套文法,只有对 歧义名称 的处理不同。 这里的内容与 sow add 无关 —— add 接受的是文件系统路径,不是包引用。 五种形态 形态 例子 匹配 内容摘要 sha256:d06d7f23b9cf...b98b1229 恰好一个包对象 RPM 坐标 rpm:pev2-0:1.23.0-1.noarch 恰好一个 RPM DEB 坐标 …
-
sow.yml 配置参考
sow.yml 是 Managed 托管工作区(Workspace)唯一的配置文件。它位于工作区根目录, 声明存在哪些仓库(Repository)与 Dist,并保存每次构建都要执行的成员策略与签名设置。 Plain 平面模式(sow create)完全不读它。 本页列出解析器接受的每一个字段。没有列在这里的字段一律拒绝 —— 不存在未公开的 键,也没有为将来预留的键。 文件是怎么读的 SOW 用严格 YAML 解析器读取 sow.yml。具体表现是: 未知字段是错误,不是警告。 把 …
sow.yml 是 Managed 托管工作区(Workspace)唯一的配置文件。它位于工作区根目录, 声明存在哪些仓库(Repository)与 Dist,并保存每次构建都要执行的成员策略与签名设置。 Plain 平面模式(sow create)完全不读它。 本页列出解析器接受的每一个字段。没有列在这里的字段一律拒绝 —— 不存在未公开的 键,也没有为将来预留的键。 文件是怎么读的 SOW 用严格 YAML 解析器读取 sow.yml。具体表现是: 未知字段是错误,不是警告。 把 …