|
|
# Cloudflare Pages GitHub Action
|
|
|
|
|
|
GitHub Action for creating Cloudflare Pages deployments, using the new [Direct Upload](https://developers.cloudflare.com/pages/platform/direct-upload/) feature and [Wrangler](https://developers.cloudflare.com/pages/platform/direct-upload/#wrangler-cli) integration.
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
1. Create an API token in the Cloudflare dashboard with the "Cloudflare Pages — Edit" permission.
|
|
|
1. Add that API token as a secret to your GitHub repository, `CLOUDFLARE_API_TOKEN`.
|
|
|
1. Create a `.github/workflows/publish.yml` file in your repository:
|
|
|
|
|
|
```yml
|
|
|
on: [push]
|
|
|
|
|
|
jobs:
|
|
|
publish:
|
|
|
runs-on: ubuntu-latest
|
|
|
permissions:
|
|
|
contents: read
|
|
|
deployments: write
|
|
|
name: Publish to Cloudflare Pages
|
|
|
steps:
|
|
|
- name: Checkout
|
|
|
uses: actions/checkout@v3
|
|
|
|
|
|
# Run a build step here if your project requires
|
|
|
|
|
|
- name: Publish to Cloudflare Pages
|
|
|
uses: cloudflare/pages-action@1
|
|
|
with:
|
|
|
apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
|
|
|
accountId: YOUR_ACCOUNT_ID
|
|
|
projectName: YOUR_PROJECT_NAME
|
|
|
directory: YOUR_ASSET_DIRECTORY
|
|
|
gitHubToken: ${{ secrets.GITHUB_TOKEN }}
|
|
|
```
|
|
|
|
|
|
1. Replace `YOUR_ACCOUNT_ID`, `YOUR_PROJECT_NAME` and `YOUR_ASSET_DIRECTORY` with the appropriate values to your Pages project.
|
|
|
|
|
|
### Get account ID
|
|
|
To find your account ID, log in to the Cloudflare dashboard > select your zone in Account Home > find your account ID in Overview under **API** on the right-side menu. If you have not added a zone, add one by selecting **Add site** . You can purchase a domain from [Cloudflare’s registrar](https://developers.cloudflare.com/registrar/).
|
|
|
|
|
|
### Generate an API Token
|
|
|
To generate an API token:
|
|
|
1. Log in to the Cloudflare dashboard.
|
|
|
2. Select My Profile from the dropdown menu of your user icon on the top right of your dashboard.
|
|
|
3. Select API Tokens > Create Token.
|
|
|
4. Under Custom Token, select Get started.
|
|
|
5. Name your API Token in the Token name field.
|
|
|
6. Under Permissions, select Account, Cloudflare Pages and Edit:
|
|
|
7. Select Continue to summary > Create Token.
|
|
|
|
|
|
More information can be found on [our guide for making Direct Upload deployments with continous integration](https://developers.cloudflare.com/pages/how-to/use-direct-upload-with-continuous-integration/#use-github-actions).
|