SuperAPI AI 工具集

cloudflare

部署与运维

查看项目

更新于 10-15 12:00

技能介绍

用途

本技能用于在 Cloudflare 边缘平台上构建和部署应用,适用于创建 Workers、Pages、D1 数据库、R2 存储、AI 推理或 KV 存储等场景。目标是在 Cloudflare 的全球边缘网络上运行分布式应用。

快速开始

通过 Wrangler CLI 完成安装、登录、初始化与部署:

# Install Wrangler CLI
npm install -g wrangler

# Login
wrangler login

# Create new Worker
wrangler init my-worker

# Deploy
wrangler deploy

主要能力

Workers

提供基础 Worker 的 fetch 处理函数示例,以及请求路由(路由表匹配与通配符匹配)的写法。

wrangler.toml 配置

展示项目名称、入口文件、兼容日期、环境变量,以及 KV、D1、R2、AI、Durable Objects 等绑定的配置写法,并包含 Durable Objects 的迁移配置。

KV 存储

演示 put(支持 expirationTtl 与 metadata)、get、getWithMetadata、list(支持 prefix)和 delete 操作。

D1 数据库(SQLite)

演示通过 prepare/bind 执行查询、插入、批量操作(batch)以及获取单条结果(first),并给出建表 schema 示例,说明可通过 wrangler d1 execute 执行 schema 文件。

R2 对象存储

演示按请求方法处理上传(PUT)、下载(GET,含 httpMetadata 与 etag)、删除(DELETE),以及列出对象(list,支持 prefix 与 limit)。

Cloudflare AI

演示文本生成(如 @cf/meta/llama-3-8b-instruct)、图像生成(如 @cf/stabilityai/stable-diffusion-xl-base-1.0)、文本嵌入(如 @cf/baai/bge-base-en-v1.5)、图像分类(如 @cf/microsoft/resnet-50)和语音转文字(如 @cf/openai/whisper)。

Durable Objects

给出 Durable Object 类(含状态存储读写)与在 Worker 中通过 idFromName/get 调用 Durable Object 的示例。

Cloudflare Pages

提供 pages.toml 的构建、重定向与响应头配置,以及 Pages Functions 的 onRequestGet/onRequestPost、动态路由参数([id].ts)和中间件(_middleware.ts)示例。

Queues

演示生产者发送单条与批量消息,以及消费者通过 queue 处理批次、ack 与 retry。

Cron 触发

演示在 wrangler.toml 中配置 crons,并在 scheduled 处理函数中按 event.cron 分支执行任务。

WebSockets

演示通过 Upgrade 头判断并建立 WebSocket 连接、接收消息并回显。

使用方式

按照快速开始安装并登录 Wrangler,初始化项目后在 wrangler.toml 中声明所需绑定,编写 Worker 或 Pages Functions 代码,最后通过 wrangler deploy 部署。D1 建表可通过 wrangler d1 execute 执行 schema 文件。

适用场景

需要在边缘运行无服务器后端、使用 KV/D1/R2 存储、调用 Workers AI 推理、使用 Durable Objects 维护状态、通过 Queues 异步处理、使用 Cron 定时任务或 WebSocket 实时通信的开发场景。

限制

资料未提供关于收费、价格、平台限制、配额或性能指标的信息,暂未提供。

参考资源

  • Workers Docs: https://developers.cloudflare.com/workers/
  • D1 Docs: https://developers.cloudflare.com/d1/
  • R2 Docs: https://developers.cloudflare.com/r2/
  • Pages Docs: https://developers.cloudflare.com/pages/
  • AI Docs: https://developers.cloudflare.com/workers-ai/
  • Wrangler CLI: https://developers.cloudflare.com/workers/wrangler/