Cloudflare资源管理

技能简介

通过Wrangler CLI管理Cloudflare Workers及其配套云服务，覆盖Worker部署、KV键值存储、D1 SQL数据库、R2对象存储、密钥管理和日志追踪等核心操作。

业务背景

面向使用Cloudflare边缘云的开发运维团队，解决多资源分散管理的痛点。通过自然语言指令自动生成Wrangler CLI命令，统一管控Workers、KV存储、D1数据库、R2对象存储等核心资源，降低CLI学习成本，减少配置错误，提升边缘应用部署与日常运维效率。

落地案例：某团队需将新版本Worker部署至生产环境并更新配置。输入"部署Worker到生产环境"，系统自动生成wrangler deploy命令序列；同时识别到需同步更新KV键值，自动补充kv put或kv bulk操作指引。运维人员按步骤执行即可完成全链路发布，无需记忆复杂参数语法。

能做什么

• 初始化并部署Cloudflare Workers到边缘节点
• 管理KV命名空间及批量键值操作
• 创建和维护D1 SQLite数据库，执行SQL与迁移
• 操作R2对象存储桶，上传下载文件
• 配置Worker密钥与环境变量
• 实时查看生产环境日志流

使用说明

安装Wrangler

npm install -g wrangler
# 或使用npx免安装
npx wrangler

登录认证

wrangler login

Worker开发部署流程

1. 初始化项目：wrangler init my-worker
2. 本地调试：wrangler dev
3. 部署上线：wrangler deploy
4. 查看版本：wrangler deployments list

配置文件选择

支持wrangler.toml或wrangler.json/JSONC格式，两者并存时JSON优先。推荐JSONC格式以获得Schema自动补全：

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "name": "my-worker",
  "main": "src/index.ts",
  "compatibility_date": "2024-12-30"
}

输入与输出

见下方输入与输出表格。

风险提示

• 删除操作（worker/namespace/bucket/database）不可逆，执行前确认目标ID
• 密钥通过wrangler secret put设置后，CLI无法回显值，需自行保管原始数据
• 批量操作（kv bulk/secret bulk）前建议先备份
• 自定义域名需在Cloudflare Dashboard或API配置，Wrangler不直接支持

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/asleep123/wrangler/SKILL.md
来源类型：GitHub仓库