Cloudflare Artifacts provides Git-compatible storage within Cloudflare. Workers Builds can build and deploy a Worker directly from an Artifacts repository.
With Artifacts and Workers Builds, you can host source code, run builds, test changes with Worker Previews, and deploy Workers entirely within Cloudflare.
Your Cloudflare account role must include Artifacts Read and Artifacts Edit permissions. Your repository must contain the source code and project configuration required to build and deploy your Worker.
Push your project to the repository before you connect it to Workers Builds. You can connect an empty repository, but the first build will fail because there is nothing to build. Push a commit to start a new build.
-
In the Cloudflare dashboard, go to Workers & Pages.
Go to Workers & Pages ↗ -
Select Create application > Continue with Artifacts.
-
Select the namespace that contains your repository.
-
Select the repository that contains your project.
-
Review the project name, deploy command, and Preview command.
-
(Optional) Enter a build command if your project requires one.
-
(Optional) Under Advanced settings, set Path if your project is not in the repository root.
-
Select Deploy.
Before you begin, push the existing Worker's source code and configuration to Artifacts. Connecting an existing Worker does not copy its original source code from the deployed Worker.
-
In the Cloudflare dashboard, go to Workers & Pages.
Go to Workers & Pages ↗ -
Select the Worker you want to connect.
-
Go to Settings > Builds.
-
Select Connect.
-
From the Git connection dropdown, select the Artifacts namespace that contains your repository.
-
Select the repository.
-
Review the build command, deploy command, and Preview command. Confirm that the Wrangler configuration targets the existing Worker.
-
(Optional) Under Advanced settings, set Path if your project is not in the repository root.
-
Save the connection.
-
Push a commit to the repository to start a build.
Pushes to the production branch run the configured build and deploy commands. The Artifacts integration only supports main as the production branch. The default deploy command, npx wrangler deploy, deploys the change to production.
To test changes before production, open your Worker in the Cloudflare dashboard. Go to Settings > Builds, select Previews Base, and turn on Builds for Preview branches. For more information, refer to Preview builds. Pushes to non-production branches run the Preview command, which defaults to npx wrangler preview. A successful build creates or updates a branch Preview URL in the Worker's Previews section.
To change the repository or source provider, disconnect Workers Builds and create another connection. Existing deployments continue serving traffic after you disconnect a repository.
For build settings and environment variables, refer to Workers Builds configuration.