Skip to content
Cloudflare Docs

GitLab integration

Cloudflare supports connecting your GitLab repository to your Cloudflare Worker, and will automatically deploy your code every time you push a change to a selected branch.

Features

Beyond automatic builds and deployments, the Cloudflare GitLab integration lets you monitor builds directly in GitLab, keeping you informed without leaving your workflow.

Commit Status

If you have one or multiple Workers connected to a repository (i.e. a monorepo), you can check on the status of each build within GitLab via GitLab commit status ↗.

You can see the statuses by selecting the status icon next to a commit or by going to Build > Pipelines within your GitLab repository. In the example below, you can select on the green check mark to see the results of the check run.

GitLab Status

Check runs will appear like the following in your repository. You can select one of the statuses to view the build on the Cloudflare Dashboard.

GitLab Commit Status

Note that when using build watch paths, only projects that trigger a build will generate a commit status.

Manage access

You can deploy projects to Cloudflare Workers from your company or side project on GitLab using the Cloudflare Pages app.

Organizational access

When you authorize Cloudflare Workers to access your GitLab account, you automatically give Cloudflare Workers access to organizations, groups, and namespaces accessed by your GitLab account. Managing access to these organizations and groups is handled by GitLab.

Remove access

You can remove Cloudflare Workers' access to your GitLab account by navigating to Authorized Applications page ↗ on GitLab. Find the applications called Cloudflare Pages and select the Revoke button to revoke access.

Note that the GitLab application Cloudflare Workers is shared between Workers and Pages projects, and removing access to GitLab will disable new builds for Workers and Pages, though your previous deployments will continue to be hosted by Cloudflare Workers.

Reinstall the Cloudflare GitLab App

  1. Go to your application settings page on GitLab: https://gitlab.com/-/profile/applications ↗
  2. Click the "Revoke" button on your Cloudflare Workers installation if it exists.
  3. Go back to the Workers & Pages overview ↗ page. Select Create application > Pages > Connect to Git.
  4. Select the + Add account button, select the GitLab account you want to add, and then select Install & Authorize.
  5. You should be redirected to the create project page with your GitLab account or organization in the account list.
  6. Attempt to make a new deployment with your project which was previously broken.