Git integration
Cloudflare supports connecting your GitHub and GitLab repository to your Cloudflare Worker, and will automatically deploy your code every time you push a change to a selected branch.
Adding a Git integration also lets you monitor build statuses directly in your Git provider using check runs or commit statuses, so you can manage deployments without leaving your workflow.
Cloudflare supports connecting Cloudflare Workers to your GitHub and GitLab repositories. Workers Builds does not currently support connecting self-hosted instances of GitHub or GitLab.
If you using a different Git provider (e.g. Bitbucket), you can use an external CI/CD provider (e.g. GitHub Actions) and deploy using Wrangler CLI.
Workers Builds provides direct integration with GitHub and GitLab accounts, including both individual and organization accounts, that are not self-hosted.
If you do not have a Git account linked to your Cloudflare account, you will be prompted to set up an installation to GitHub or GitLab when connecting a repository for the first time, or when adding a new Git account. Follow the prompts and authorize the Cloudflare Git integration.
You can check the following pages to see if your Git integration has been installed:
- GitHub Applications page ↗ (if you are in an organization, select Switch settings context to access your GitHub organization settings)
- GitLab Authorized Applications page ↗
For details on providing access to organization accounts, see GitHub organizational access and GitLab organizational access.
You can manage the Git installation associated with your repository connection by navigating to the Worker, then going to Settings > Builds and selecting Manage under Git Repository.
This can be useful for managing repository access or troubleshooting installation issues by reinstalling. For more details, see the GitHub and GitLab guides for how to manage your installation.