https://sow.pgsty.com/zh/tags/object-storage/ Recent content in object-storage on SOW Hugo zh-CN Fri, 28 Aug 2026 18:32:04 +0800 https://sow.pgsty.com/zh/blog/design/coordinated-publication/ Fri, 14 Aug 2026 00:00:00 +0000 https://sow.pgsty.com/zh/blog/design/coordinated-publication/ <div class="td-callout td-callout--important" role="note"> <div class="td-callout__title"><i class="td-callout__icon fa-solid fa-circle-exclamation" aria-hidden="true"></i><span class="td-callout__label">SOW 0.4.0 已完成最终决策</span></div> <div class="td-callout__body"> <p>本记录的早期版本曾提议采用 rclone Executor、<code>publish --dry-run</code> 与独立 <code>sow audit</code> 命令。这些表面均未进入 0.4.0：SOW 不依赖 rclone，<code>publish</code> 没有 <code>--dry-run</code>，<code>sow audit</code> 也不是有效命令。</p> https://sow.pgsty.com/zh/blog/design/publication/ Sat, 08 Aug 2026 00:00:00 +0000 https://sow.pgsty.com/zh/blog/design/publication/ <p>构建与发布是两个独立状态迁移。构建产生与 target 无关的 Generation；发布把该 Generation 应用到一个供应商前缀，并记录足以在不猜测的前提下恢复的证据。</p> <h2 id="所有权拆分">所有权拆分 </h2> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">Repository 作用域</th> <th scope="col">Target prefix 作用域</th> </tr> </thead> <tbody> <tr> <td>Package Object</td> <td>Publication Attempt</td> </tr> <tr> <td>Desired 与 Built 状态</td> <td>Applied Checkpoint</td> </tr> <tr> <td>Generation 与 Changeset</td> <td>远端 inventory</td> </tr> <tr> <td>retained 包体/元数据引用</td> <td>grace 与删除证据</td> </tr> </tbody> </table> </div> <p>这项拆分避免把 filesystem 发布成功当成 R2 的证据，也避免一个 target 的半完成尝试污染另一个。</p> https://sow.pgsty.com/zh/docs/reference/compatibility/ Mon, 01 Jan 0001 00:00:00 +0000 https://sow.pgsty.com/zh/docs/reference/compatibility/ <p>本页说明 SOW 提供哪些构建目标、工作区依赖什么存储语义，以及自动化集成具体覆盖哪些行为。 仓库生成在 SOW 二进制内部完成；部署后的最终门禁仍是实际软件包管理器。</p> https://sow.pgsty.com/zh/docs/command/publish/ Mon, 01 Jan 0001 00:00:00 +0000 https://sow.pgsty.com/zh/docs/command/publish/ <p><code>sow publish</code> 将某个 Repository 的当前 Built Generation 交付到 <code>sow.yml</code> 的 <code>targets:</code> 中指定的 目标。目标已经绑定 Repository 与 Provider，因此命令不接受 <code>--repo</code> 或 <code>--dist</code>。</p> <h2 id="语法">语法 </h2> <div class="td-code td-code--untitled" id="td-code-bd7a1741-fence-0" data-td-code data-td-code-auto-id data-td-language="text" data-td-line-count="1"> <div class="td-code__viewport" id="td-code-bd7a1741-fence-0-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">sow publish TARGET [--abort | --rebind] [-C|--workdir DIR] [-T|--timeout DUR | -N|--no-wait] [--json]</span></span></code></pre></div></div> </div> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">参数</th> <th scope="col">含义</th> <th scope="col">默认值</th> </tr> </thead> <tbody> <tr> <td><code>--abort</code></td> <td>放弃已对账、但尚未写入持久 commit intent 的尝试</td> <td>false</td> </tr> <tr> <td><code>--rebind</code></td> <td>确认并记录允许修改的目标名称、公共端点或缓存 TTL</td> <td>false</td> </tr> <tr> <td><code>-C, --workdir DIR</code></td> <td>工作区发现起点</td> <td>当前目录</td> </tr> <tr> <td><code>-T, --timeout DUR</code></td> <td>最长 Repository 等锁时间；<code>0</code> 表示无限等待</td> <td><code>0</code></td> </tr> <tr> <td><code>-N, --no-wait</code></td> <td>锁被占用时立即失败</td> <td>false</td> </tr> <tr> <td><code>--json</code></td> <td>输出 <code>sow.cli/v1</code> Envelope</td> <td>false</td> </tr> </tbody> </table> </div> <p><code>TARGET</code> 必须是已配置的 <code>filesystem</code> 或 <code>r2</code> 发布目标。<code>--abort</code> 与 <code>--rebind</code> 互斥。</p>