在 Cloudflare Workers 部署一个 JSON as a Storage 服务

2023-03-09T01:38:46+08:00

我特别喜欢JSON</a>, 因为它真的很小巧和简单，幸运的是，它还是我使用的主要语言 Javascript 和 Typescript 里的一级公民，也太幸运了吧！

我经常用本地的 JSON 文件来存储一些需要持久化的数据，这样可以省掉要调试 sql 或者 redis 的大把时间，而且数据都是明文纯文本存储，搜索，定位问题都很方便，比如整个 Buzzing</a> 还有整个 Track Awesome List</a> 都只使用 JSON 作为持久化存储的格式。

但是像这样比较大的项目，我会把 JSON 文件存储到 Cloudflare 的 R2 服务里（类似 AWS 的 S3 ），但是除此之外，我还有很多小小的工作流，这些东西通常也需要一个持久化的数据存储，比如一个 RSS 的监控服务，我需要记录哪些 ID 已经被发送过了，这是一个很常见的需求，但是要寻找一个适合的服务也不是一件容易的事，所以今天我尝试搜索了一下 JSON as a Storage 方案，最后决定采用 Cloudfalre 的 Workers 作为 host, 其实也就几十行代码的事，Workers 好就好在一次部署，终生不用再管，所以特别适合这种服务。

部署之后，你会得到一个这样的接口：

写 json 🔗</a></h2>

curl </span>'</span>https://json.owenyoung.com/foo/bar?key=abc</span>'</span> --data </span>'</span>{"foo":"bar"}</span>'
</span></code></pre>
读 json🔗</a></h2>
curl </span>'</span>https://json.owenyoung.com/foo/bar?key=abc</span>'
</span></code></pre>
示例：如何记录已发送的 RSS ids🔗</a></h3>
let </span>sentArr </span>= [];
</span>const </span>response </span>= </span>await </span>fetch</span>(
</span>  "</span>https://json.owenyoung.com/rss/hackernews/sent?key=abc</span>"
</span>);
</span>if </span>(</span>response</span>.</span>ok</span>) {
</span>  </span>sentArr </span>= </span>await </span>response</span>.</span>json</span>();
</span>} </span>else </span>{
</span>  </span>if </span>(</span>response</span>.status === </span>404</span>) {
</span>    </span>sentArr </span>= [];
</span>  } </span>else </span>{
</span>    </span>throw </span>new Error(`</span>${</span>response</span>.status}: ${</span>response</span>.statusText}</span>`);
</span>  }
</span>}
</span>
</span>console</span>.</span>log</span>("</span>current sentArr</span>", </span>sentArr</span>);
</span>
</span>// do some work
</span>
</span>sentArr</span>.</span>push</span>("</span>456</span>");
</span>
</span>// write the newest sentArr to KV
</span>
</span>const </span>writeResponse </span>= </span>await </span>fetch</span>(
</span>  "</span>https://json.owenyoung.com/rss/hackernews/sent?key=abc</span>",
</span>  {
</span>    method: "</span>POST</span>",
</span>    body: JSON.</span>stringify</span>(</span>sentArr</span>),
</span>  }
</span>);
</span>
</span>if </span>(!</span>writeResponse</span>.</span>ok</span>) {
</span>  </span>throw </span>new Error(`</span>${</span>writeResponse</span>.status}: ${</span>writeResponse</span>.statusText}</span>`);
</span>}
</span></code></pre>
好吧，上面那一坨有点烦，我封装了一个叫 JSONBin 的类</a>，我喜欢用 Deno 写这种小脚本，所以你可以在 Deno 中这样使用：</p>
import </span>JSONBin </span>from </span>"</span>https://deno.land/x/jsonbin@v0.0.5/mod.ts</span>";
</span>
</span>const </span>jsonBin </span>= new JSONBin({
</span>  api: "</span>https://json.owenyoung.com</span>",
</span>  key: "</span>abc</span>",
</span>});
</span>
</span>const </span>sentArr </span>= </span>await </span>jsonBin</span>.</span>get</span>("</span>/rss/abc</span>", []);
</span>
</span>console</span>.</span>log</span>("</span>current sentArr</span>", </span>sentArr</span>);
</span>
</span>// do some work
</span>// ...
</span>
</span>sentArr</span>.</span>push</span>("</span>456</span>");
</span>
</span>// write the newest sentArr to KV
</span>
</span>await </span>jsonBin</span>.</span>set</span>("</span>/rss/abc</span>", </span>sentArr</span>);
</span></code></pre>
如何在 Cloudfalre Workers 上部署该服务🔗</a></h2>
如下：</p>

先在 Cloudfalre</a> 创建一个 KV 命名空间, Workers -> KV</code> , 名字可以叫：jsonbin</code></li>
然后在Cloudfalre</a> 创建一个 Worker, 在该 Worker 的 Settings -> Variables -> KV Namespace Bindings , 绑定刚刚创建的 KV， Variable name 填：JSONBIN</code>, kv namespace 选择刚刚那个就可以了.</li>
点击快速编辑，把 main.js</code></a> 里的代码粘贴进去, 记得修改一下密钥。</li>
如果有需要，可以在 Triggers 里面配置绑定的自定义域名，我绑定了一个 json.owenyoung.com</code></li>
</ol>

灵感和初始代码来自 这里 jsonbase </a>，我加了一点鲁棒性在里面！</p>
</blockquote>
希望这个小脚本成为你的工作流中的粘合剂！</p>

Owen的博客 - JSON

在 Cloudflare Workers 部署一个 JSON as a Storage 服务