π€ wrangler
wrangler
is a CLI tool designed for folks who are interested in using Cloudflare Workers.
Installation
You have many options to install wrangler!
Install with npm
Install with cargo
If you don't have cargo
or npm
installed, you will need to follow these additional instructions.
Updating
For information regarding updating Wrangler, click here.
Getting Started
Once you have installed Wrangler, spinning up and deploying your first Worker is easy!
$ wrangler generate my-worker
$ cd my-worker
# update your wrangler.toml with your Cloudflare Account ID
$ wrangler config
$ wrangler publish
ποΈ Top Level Commands
π― generate
Scaffold a project, including boilerplate code for a Rust library and a Cloudflare Worker.
All of the arguments and flags to this command are optional:
name
: defaults toworker
template
: defaults to thehttps://github.com/cloudflare/worker-template
type
: defaults to "webpack"
π₯ init
Creates a skeleton wrangler.toml
in an existing directory. This can be used as an alternative to generate
if you prefer to clone a repository yourself.
All of the arguments and flags to this command are optional:
name
: defaults to the name of your working directorytype
: defaults to "webpack".
π¦βοΈ build
Build your project. This command looks at your wrangler.toml
file and runs the build steps associated
with the "type"
declared there.
Additionally, you can configure different environments.
π§ config
Configure your global Cloudflare user. This is an interactive command that will prompt you for your API token:
You can also provide your email and global API key (this is not recommended for security reasons):
You can also use environment variables to configure these values.
βοΈ π publish
Publish your Worker to Cloudflare. Several keys in your wrangler.toml
determine whether you are publishing to a workers.dev subdomain or your own registered domain, proxied through Cloudflare.
Additionally, you can configure different environments.
You can also use environment variables to handle authentication when you publish a Worker.
```bash
# e.g.
CF_API_TOKEN=superlongtoken wrangler publish
# where
# $CF_API_TOKEN -> your Cloudflare API token
CF_API_KEY=superlongapikey CF_EMAIL=testuser@example.com wrangler publish
# where
# $CF_API_KEY -> your Cloudflare API key
# $CF_EMAIL -> your Cloudflare account email
```
π kv
Interact with your Workers KV store. This is actually a whole suite of subcommands. Read more about in Wrangler KV Documentation.
Additional Documentation
All information regarding wrangler or Cloudflare Workers is located in the Cloudflare Workers Developer Docs. This includes:
- Using wrangler commands
- Wrangler configuration
- General documentation surrounding Workers development
- All wrangler features such as Workers Sites and KV
β¨Workers Sites
To learn about deploying static assets using wrangler
, see the Workers Sites Quickstart.