SuperAPI AI 工具集

wrangler

部署与运维

查看项目

更新于 10-22 19:40

技能介绍

Wrangler 是 Cloudflare 提供的命令行工具,用于在本地和云端管理 Cloudflare Workers 及其配套资源。

用途 主要用于通过 CLI 完成 Worker 项目的初始化、本地开发、部署与运维,并管理 Secrets、KV、R2、D1、Pages 等 Cloudflare 资源。

安装与认证 安装命令为 npm i -g wrangler,可用 wrangler --version 验证安装。登录使用 wrangler login,查看认证状态使用 wrangler whoami。文档建议在以程序化方式调用命令时,在支持的命令上使用 --json 标志以获得 JSON 输出。

主要能力 Workers:wrangler init 初始化项目,wrangler dev 启动本地开发服务器,wrangler deploy 部署,wrangler publish 为部署别名,wrangler tail 流式查看已部署 Worker 的实时日志,wrangler delete 删除已部署 Worker。 Secrets:wrangler secret put SECRET_NAME 设置密钥(会提示输入值),wrangler secret list 列出密钥,wrangler secret delete SECRET_NAME 删除密钥。 KV:支持命名空间的列出、创建与删除,以及键值对的写入、读取、删除和键列表查询,相关命令通过 --namespace-id 指定命名空间。 R2:支持桶的列出、创建与删除,以及对象的下载、上传(--file 指定本地文件路径)与删除。 D1:支持数据库的列出、创建、删除、详情查看(wrangler d1 info),并可通过 --command 执行单条 SQL 或通过 --file 执行 SQL 文件。 Pages:支持部署目录(wrangler pages deploy <directory>)、列出与创建项目、列出部署。

使用方式 各资源均以 wrangler 加子命令的形式调用,例如 wrangler kv namespace create <name>、wrangler r2 bucket create <name>、wrangler d1 execute <name> --command "SELECT * FROM users"。全局标志包括 --json(JSON 输出)、--config <path>(指定 wrangler.toml 配置路径)、--env <name>(指定环境)、--compatibility-date <date>(设置兼容日期)。

适用场景 适合需要在命令行中开发、部署和维护 Cloudflare Workers 应用,并集中管理其关联存储与配置的开发者。

限制 资料未说明各项命令的配额、计费、平台兼容性或具体限制,这些内容暂未提供,使用时应以 Cloudflare 官方文档为准。