Fastly Compute

Fastly Compute 是一个先进的边缘计算系统，它可以在 Fastly 的全球边缘网络上以您喜欢的语言运行您的代码。Hono 也可以在 Fastly Compute 上运行。

您可以使用 Fastly CLI 在本地开发应用程序并通过几条命令发布它，该 CLI 作为模板的一部分会自动安装在本地。

1. 设置

Fastly Compute 的入门模板可用。 使用 "create-hono" 命令开始您的项目。 为本示例选择 fastly 模板。

npm

npm create hono@latest my-app

yarn

yarn create hono my-app

pnpm

pnpm create hono my-app

bun

bun create hono@latest my-app

deno

deno init --npm hono my-app

进入 my-app 并安装依赖项。

npm

cd my-app
npm i

yarn

cd my-app
yarn

pnpm

cd my-app
pnpm i

bun

cd my-app
bun i

2. 你好世界

编辑 src/index.ts：

// src/index.ts
import { Hono } from 'hono'
import { fire } from '@fastly/hono-fastly-compute'

const app = new Hono()

app.get('/', (c) => c.text('Hello Fastly!'))

fire(app)

NOTE

当在应用程序的顶层使用来自 @fastly/hono-fastly-compute' 的 fire（或 buildFire()）时，适合使用来自 'hono' 的 Hono 而不是 'hono/quick'，因为 fire 会导致其路由器在应用程序初始化阶段构建其内部数据。

3. 运行

在本地运行开发服务器。然后，在您的 Web 浏览器中访问 http://localhost:7676。

npm

npm run start

yarn

yarn start

pnpm

pnpm run start

bun

bun run start

4. 部署

要构建并将应用程序部署到您的 Fastly 账户，请输入以下命令。首次部署应用程序时，系统会提示您在账户中创建新服务。

如果您还没有账户，必须 创建您的 Fastly 账户。

npm

npm run deploy

yarn

yarn deploy

pnpm

pnpm run deploy

bun

bun run deploy

绑定

在 Fastly Compute 中，您可以绑定 Fastly 平台资源，例如 KV Stores、Config Stores、Secret Stores、Backends、Access Control Lists、Named Log Streams 和环境变量。您可以通过 c.env 访问它们，并将拥有它们各自的 SDK 类型。

要使用这些绑定，请从 @fastly/hono-fastly-compute 导入 buildFire 而不是 fire。定义您的 绑定 并将它们传递给 buildFire() 以获取 fire。然后在构建 Hono 时使用 fire.Bindings 来定义您的 Env 类型。

// src/index.ts
import { buildFire } from '@fastly/hono-fastly-compute'

const fire = buildFire({
  siteData: 'KVStore:site-data', // 我有一个名为 "site-data" 的 KV Store
})

const app = new Hono<{ Bindings: typeof fire.Bindings }>()

app.put('/upload/:key', async (c, next) => {
  // 例如，访问 KV Store
  const key = c.req.param('key')
  await c.env.siteData.put(key, c.req.body)
  return c.text(`Put ${key} successfully!`)
})

fire(app)