Reference

SOW 在 Linux 和 macOS 上构建 RPM、DEB 仓库文件。工作区使用受支持的本地文件系统， 再为客户端配置 HTTP 或存储访问。 平台 操作系统 amd64 arm64 发布格式 Linux 是 是 归档、RPM、DEB macOS 是 是 归档 Windows 否 否 — 发布二进制使用 CGO_ENABLED=0，不需要语言运行时。源码构建要求 Go 1.27.1 或更新版本。 归档包含 README、更新日志、Apache-2.0 许可证与第三方许可声明； Linux 软 …

数据命令使用 --json 后，会向 stdout 输出一个以换行结束的 JSON 文档，诊断写入 stderr。 log export 例外：它输出 JSON Lines，不接受 --json。 sow status -r demo --json | jq '.result.status' 顶层封装 每个 JSON 响应都有七个字段： 字段 类型 含义 schema 字符串 sow.cli/v1 command 字符串 包含子命令的名称，如 repo ls ok 布尔值 命令成功；存在错误时 …

脚本使用退出码判断结果，具体原因读取错误诊断。SOW 各命令使用相同的退出码含义。 退出码 含义 下一步 0 成功或无需变更 查看结果；无需变更时可能报告 noop: true 1 运行时 I/O、包解析、渲染或其他未分类错误 修正诊断指出的输入或环境问题后重试 2 命令、工作区查找或配置错误 检查 sow help COMMAND、选择参数和 sow config check 3 部分成功 查看结果，区分已提交工作与失败项 4 无法取得写锁 稍后重试或增加 --timeout 5 完整性/恢 …

对外服务完整的 Managed 仓库目录：pool/ 加 dists/。 工作区配置与 .sow/ 状态应位于 Web 服务根目录之外。 Plain 目录 /srv/offline/ ├── example-1.0-1.x86_64.rpm ├── example_1.0-1_amd64.deb ├── repodata/ │ ├── <sha256>-primary.xml.gz │ ├── <sha256>-filelists.xml.gz │ ├── …

这些页面用于查阅配置字段、包引用、文件路径和脚本接口。 命令语法见命令参考，也可运行 sow help COMMAND。 配置参考 sow.yml 的字段、默认值、校验规则、签名引用和发布目标。 包引用 按摘要、坐标、文件名或包名选择软件包，解决匹配歧义。 仓库布局 查找包文件、索引、私有状态和发布输出的位置。 退出码 解释命令结果，并在脚本中选择下一步操作。 JSON 输出 读取 sow.cli/v1 响应和各命令的结果字段。 平台与集成 检查系统、文件系统、客户端格式和集成测试覆盖。 故障排 …

rm、show 和 where 接受包引用，add 接受文件或目录路径。 先用 sow ls 查到包坐标或 SHA-256，再传给其他命令。 sow ls -r demo -d el9 sow show 'rpm:example-0:1.0-1.x86_64' -r demo 支持的形式 形式 语法 匹配对象 SHA-256 sha256:<64 位小写十六进制数字> 已存储的包字节 RPM 坐标 rpm:<name>-<epoch>:<version>-<release>.<arch> 包含 …

sow.yml 配置 Managed 工作区，声明仓库、Dist、包策略、签名与发布目标。 Plain 命令 sow create 不读取此文件。 编辑后，检查配置并查看实际生效的设置： sow config check sow config show --all config check 校验 YAML、比较配置与已初始化的仓库状态，并解析签名引用。 config show --all 展开默认值。 文件规则 使用一个 YAML 文档，配置 schema: sow/v3。 未知字段和重复键都是 …

先查看报错信息和退出码。 运行 Managed 命令时，明确指定工作区与仓库，检查对应状态： sow version sow status -C /srv/sow -r pgsql sow log -C /srv/sow -r pgsql 将以下示例中的 /srv/sow、pgsql 和目标名 prod 换成实际配置。 数据库需要迁移 将 0.3 或 0.4 工作区升级到 0.5 后，先停止工作区写入并备份完整工作区，再运行： sow repo migrate pgsql -C /srv/sow …