wrangler-action

by cloudflare

cloudflare /wrangler-action

πŸ§™β€β™€οΈ zero-config cloudflare workers application deployment using wrangler and github actions

193 Stars 24 Forks Last release: about 1 month ago (1.3.0) Other 64 Commits 9 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Wrangler GitHub Action

✨ Zero-config Cloudflare Workers deployment using Wrangler and GitHub Actions

Usage

Add

wrangler-action
to the workflow for your Workers application. The below example will publish your application on pushes to the
master
branch:
name: Deploy

on: push: branches: - master

jobs: deploy: runs-on: ubuntu-latest name: Deploy steps: - uses: actions/[email protected] - name: Publish uses: cloudflare/[email protected] with: apiToken: ${{ secrets.CF_API_TOKEN }}

Authentication

You'll need to configure Wrangler using GitHub's Secrets feature - go to "Settings -> Secrets" and add your Cloudflare API token (for help finding this, see the Workers documentation). Your API token is encrypted by GitHub, and the action won't print it into logs, so it should be safe!

With your API token set as a secret for your repository, pass it to the action in the

with
block of your workflow. Below, I've set the secret name to
CF_API_TOKEN
:
jobs:
  deploy:
    name: Deploy
    steps:
      uses: cloudflare/[email protected]
      with:
        apiToken: ${{ secrets.CF_API_TOKEN }}

wrangler-action
also supports using your global API key and email as an authentication method, although API tokens are preferred. Pass in
apiKey
and
email
to the GitHub Action to use this method:
jobs:
  deploy:
    name: Deploy
    steps:
      uses: cloudflare/[email protected]
      with:
        apiKey: ${{ secrets.CF_API_KEY }}
        email: ${{ secrets.CF_EMAIL }}

Configuration

If you're using Wrangler's environments feature, you can customize where the action deploys to by passing an

environment
in the
with
block of your workflow:
jobs:
  deploy:
    steps:
      uses: cloudflare/[email protected]
      with:
        apiToken: ${{ secrets.CF_API_TOKEN }}
        environment: 'production'

If you need to install a specific version of Wrangler to use for deployment, you can also pass the input

wranglerVersion
to install a specific version of Wrangler from NPM. This should be a SemVer-style version number, such as
1.6.0
:
jobs:
  deploy:
    steps:
      uses: cloudflare/[email protected]
      with:
        apiToken: ${{ secrets.CF_API_TOKEN }}
        wranglerVersion: '1.6.0'

Optionally, you can also pass a

workingDirectory
key to the action. This will allow you to specify a subdirectory of the repo to run the Wrangler command from.
jobs:
  deploy:
    steps:
      uses: cloudflare/[email protected]
      with:
        apiToken: ${{ secrets.CF_API_TOKEN }}
        workingDirectory: 'subfoldername'

Worker secrets can be optionally passed as a new line deliminated string of names in

secrets
. Each secret name must match an environment variable name specified in the
env
attribute. Creates or replaces the value for the Worker secret using the
wrangler secret put
command.
jobs:
  deploy:
    steps:
      uses: cloudflare/[email protected]
      with:
        apiToken: ${{ secrets.CF_API_TOKEN }}
        secrets: |
            SECRET1
            SECRET2
      env:
        SECRET1: ${{ secrets.SECRET1 }}
        SECRET2: ${{ secrets.SECRET2 }}

If you need to run additional shell commands before or after

wrangler publish
, you can specify them as input to
preCommands
(before publish) or
postCommands
(after publish). These can include additional
wrangler
commands (i.e.
build
,
kv:key put
) or any other commands available inside the
wrangler-action
context.
jobs:
  deploy:
    steps:
      uses: cloudflare/[email protected]
      with:
        apiToken: ${{ secrets.CF_API_TOKEN }}
        preCommands: echo "*** pre command ***"
        postCommands: |
          echo "*** post commands ***"
          wrangler kv:key put --binding=MY_KV key2 value2
          echo "******"

Set the optional

publish
input to false to skip publishing your Worker project and secrets. Useful in conjunction with pre and post commands. For example, if you only wanted to run
wrangler build
against your project:
jobs:
  deploy:
    steps:
      uses: cloudflare/[email protected]
      with:
        apiToken: ${{ secrets.CF_API_TOKEN }}
        publish: false
        preCommands: wrangler build

Use cases

Deploying when commits are merged to master

The above workflow examples have already shown how to run

wrangler-action
when new commits are merged to the master branch. For most developers, this workflow will easily replace manual deploys and be a great first integration step with
wrangler-action
:
on:
  push:
    branches:
      - master

jobs: deploy: runs-on: ubuntu-latest name: Deploy steps: - uses: actions/[email protected] - name: Publish uses: cloudflare/[email protected] with: apiToken: ${{ secrets.CF_API_TOKEN }}

Note that there are a number of possible events, like

push
, that can be used to trigger a workflow. For more details on the events available, check out the GitHub Actions documentation.

Deploying on a schedule

If you'd like to deploy your Workers application on a recurring basis – for instance, every hour, or daily – the

schedule
trigger allows you to use cron syntax to define a workflow schedule. The below example will deploy at the beginning of every hour:
on:
  schedule:
    - cron: '0 * * * *'

jobs: deploy: runs-on: ubuntu-latest name: Deploy steps: - uses: actions/[email protected] - name: Publish app uses: cloudflare/[email protected] with: apiToken: ${{ secrets.CF_API_TOKEN }}

If you need help defining the correct cron syntax, check out crontab.guru, which provides a friendly user interface for validating your cron schedule.

Deploying on a "dispatched" event

If you need to trigger a deployment at-will, you can use GitHub's API to fire a

repository_dispatch
event on your repository. By setting your workflow to trigger on that event, you'll be able to deploy your application via an API call:
on:
  repository_dispatch:

jobs: deploy: runs-on: ubuntu-latest name: Deploy steps: - uses: actions/[email protected] - name: Publish app uses: cloudflare/[email protected] with: apiToken: ${{ secrets.CF_API_TOKEN }}

To make the GitHub API request, you can deploy a custom Cloudflare Workers function, which will send a

POST
request to GitHub's API and trigger a new deploy:
const headers = {
  Accept: 'application/vnd.github.everest-preview+json',
  Authorization: 'Bearer $token',
}

const body = JSON.stringify({ event_type: 'repository_dispatch' })

const url = https://api.github.com/repos/$owner/$repo/dispatches

const handleRequest = async evt => { await fetch(url, { method: 'POST', headers, body }) return new Response('OK') }

addEventListener('fetch', handleRequest)

Note that

$token
in this code sample is a GitHub "Personal Access Token". For information on how to generate this token, see the GitHub documentation on "repository_dispatch".

Troubleshooting

This action is in beta, and I'm looking for folks to use it! If something goes wrong, please file an issue! That being said, there's a couple things you should know:

"I just started using Workers/Wrangler and I don't know what this is!"

No problem! Check out the Quick Start guide in our docs to get started. Once you have a Workers application, you may want to set it up to automatically deploy from GitHub whenever you change your project. That's where this action comes in - nice!

"I'm trying to deploy my static site but it isn't working!"

To deploy static sites and frontend applications to Workers, check out the documentation for Workers Sites.

Note that this action makes no assumptions about how your project is built! If you need to run a pre-publish step, like building your application, you need to specify a build step in your Workflow. For instance, if I have an NPM command called

build
, my workflow TOML might resemble the following:
jobs:
  deploy:
    runs-on: ubuntu-latest
    name: Deploy
    steps:
      - uses: actions/[email protected]
      - name: Build site
        run: 'npm run build'
      - name: Publish
        uses: cloudflare/[email protected]
        with:
          apiToken: ${{ secrets.CF_API_TOKEN }}

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.