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. Hello World

编辑 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('你好 Fastly！'))

fire(app)

NOTE

在应用程序的顶层使用来自 @fastly/hono-fastly-compute' 的 fire（或 buildFire()）时，适合使用来自 'hono' 而不是 'hono/quick' 的 Hono，因为 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 存储、配置存储、密钥存储、后端、访问控制列表、命名日志流和环境变量。您可以通过 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 存储
})

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

app.put('/upload/:key', async (c, next) => {
  // 例如，访问 KV 存储
  const key = c.req.param('key')
  await c.env.siteData.put(key, c.req.body)
  return c.text(`成功放置 ${key}！`)
})

fire(app)