Cloudflare

Cloudflare 推出的 Workers 服务，提供了一个无服务器的 JavaScript 运行环境。

通过在用户的网络边缘部署代码，Cloudflare Workers 使得用户的请求能够直接在最近的节点上执行，大大提高了访问速度和响应效率。

快速开始

在创建应用时，选择 cloudflare 作为运行时环境。

bun create milkio

运行时

你的代码将运行在 Cloudflare Workers 的运行时当中，它不使用 Bun 或 Node.js 作为运行时。因此，在 Cloudflare Workers 环境中编写代码时，你需要依赖于香草 JavaScript 中所拥有的功能，避免使用那些依赖于不被支持的 Node.js 或 Bun 的功能。

微服务

Cloudflare Workers 最终会将你的代码打包为单个 JavaScript 文件并上传，这会提高性能，但也会使 Milkio 失去按需加载的能力，因为你应用程序的全部代码，在一开始，就被全部加载到了内存中。

因此，如果我们的 API 数量非常多，想要在 Cloudflare Workers 始终保持高性能，就不能够在一个 Workers 中，放入太多的 API。你可以创建多个 Milkio 应用，并分别部署到不同的 Workers 中，它们之间，使用你的 客户端包 进行通信。

测试

Cloudflare Workers 使用 Wrangler 作为开发和部署的工具，然而，它目前尚不支持在其自身环境下直接某个执行 JavaScript 文件的能力。因此，在使用 Milkio 进行测试时，实际上是由 Bun 来执行测试的。

为了确保测试能够准确反映在 Cloudflare Workers 环境中的实际表现，我们推荐你使用 test.client 来进行测试。这样，测试将会向 Cloudflare Workers 发送请求，而不是在 Bun 中执行你要测试的代码。

handler: async (test) => {
    await test.execute(...) // ✖ 你所执行的 API 是运行在 Bun 中的
    await test.client.execute(...) // ✔ 你所执行的 API 是运行在 Cloudflare Workers 中的
});

部署

修改你的 /wrangler.toml，将其中的 name 修改为你的 Workers 名称。

#:schema node_modules/wrangler/config-schema.json
name = "your-worker-name"
main = "run-cloudflare.ts"
compatibility_date = "2023-08-23"

运行 bun run deploy，将你的应用部署到 Cloudflare Workers。如果你是第一次运行，可能会要求你登录。