参考
查阅配置、包引用、文件路径、命令结果与故障处理方法。
这些页面用于查阅配置字段、包引用、文件路径和脚本接口。
命令语法见命令参考,也可运行 sow help COMMAND。
- 配置参考 —
sow.yml的字段、默认值、校验规则、签名引用和发布目标。 - 包引用 — 按摘要、坐标、文件名或包名选择软件包,解决匹配歧义。
- 仓库布局 — 查找包文件、索引、私有状态和发布输出的位置。
- 退出码 — 解释命令结果,并在脚本中选择下一步操作。
- JSON 输出 — 读取
sow.cli/v1响应和各命令的结果字段。 - 平台与集成 — 检查系统、文件系统、客户端格式和集成测试覆盖。
- 故障排查 — 处理配置、构建、签名和发布错误,找到下一步操作。
示例约定
命令代码块省略 shell 提示符,便于复制。语法说明中的 NAME、DIR 等大写词是占位符。
方括号表示可选参数,... 表示可重复参数,| 分隔备选项。
输出中的路径、ID、摘要、时间和计数随工作区变化。操作 ID 和构建快照 ID 保持字符串类型, 详见 JSON 输出。
故障处理
处理数据库迁移、待构建变更、中断发布、锁等待和完整性错误。
sow.yml 配置参考
工作区配置字段、默认值、校验规则、签名引用与发布目标。
包引用
按摘要、坐标、文件名或包名选择软件包,并解决匹配歧义。
仓库布局
查找包文件、仓库索引、私有状态和发布输出的位置。
退出码
退出码 0–6 与中断码 130 的含义和示例。
JSON 输出
查阅 JSON 响应字段、包与操作标识、错误和各命令结果。
平台与集成
支持的平台、文件系统要求、仓库格式、客户端与集成测试覆盖。