Docker Builders
Build Docker images with WarpBuild
WarpBuild provides powerful Docker builders that significantly accelerate your Docker build times, delivering superior performance for your containerization workflow.
Features
- 🚀 Fast Docker builds with WarpBuild's remote builder nodes.
- 🔄 Automatic Docker BuildX integration.
- 🔐 Secure TLS authentication.
- 🌐 Works with both WarpBuild runners and non-WarpBuild runners.
- 🔌 Integrate anywhere via API, supporting local development and various CI platforms (GitHub, GitLab, Bitbucket, Buildkite, etc.).
- 🏗️ Multi-architecture builds (amd64, arm64) out of the box.
See it in Action
Experience up to 50% faster Docker builds compared to traditional solutions. Our optimized builder infrastructure handles the heavy lifting so your CI/CD pipeline runs more efficiently.
To get started with Docker builders, go to the Docker Builders page and create a builder profile.
Concurrency
Each builder profile corresponds to one optimized, dedicated Docker builder virtual machine with caching. Multiple jobs can run on the same builder profile in parallel and these will effectively run on the same VM in parallel.
While there is no limit on the number of builds that can be run concurrently on a builder profile, the recommended minimum resource requirements for builders is approximately 8vcpu and 16GB memory per build job.
Usage
Using WarpBuild's Build Push Action (Recommended)
WarpBuild provides a drop-in replacement for the widely used docker/build-push-action
. Our action automatically sets up the WarpBuild's Remote Docker builders for you.
Note: We recommend that you remove the
docker/setup-buildx-action
step from your workflow if you are only using it to setup builders.
Here's how you can use the Warpbuilds/build-push-action
in your workflows, whether you are using WarpBuild Runners or non-WarpBuild Runners.
Using WarpBuild's Bake Action
WarpBuild provides a drop-in replacement for the widely used docker/bake-action
. Our action automatically sets up the WarpBuild's Remote Docker builders for you.
Note: We recommend that you remove the
docker/setup-buildx-action
step from your workflow if you are only using it to setup builders.
Here's how you can use the Warpbuilds/bake-action
in your workflows, whether you are using WarpBuild Runners or non-WarpBuild Runners.
Using WarpBuild's Docker Configure Action
For users wanting more control over their workflows, WarpBuild provides a docker-configure
action. This action sets up the builder for you in the VM and outputs all their details which you can then use in your workflow. Although, we recommend using the Warpbuilds/build-push-action
as it is easier to use, this action allows you to use builders with your custom steps.
With WarpBuild Runners
Learn more about the outputs of the docker-configure
action in the docker-configure action docs.
From CLI
You can use WarpBuild's Docker builders directly from your CLI.
-
Set your API key as an environment variable:
-
Assign builders from your profile:
-
Get the builder details and certificates:
-
Create a buildx instance with your builder:
-
Use the builder for your Docker builds:
You can now use this builder for faster Docker builds directly from your terminal!
-
Terminate the assigned builders after usage:
Note : User will be billed for entire duration till the assigned builders are terminated by user.
Resetting the cache
If you need to reset the cache for a builder profile, you can do so by using the following steps.
- Get the builder profile id using the following command.
- Reset the cache for the builder profile id.
Working with multiple builders
If your assignment returns multiple builders, you can set up additional nodes:
With multiple builders configured, your buildx instance can distribute build workloads more efficiently.
Multi platform builds
WarpBuild supports multi-platform builds for Docker images. You can specify the platforms you want to build for using the platforms
option in the docker/build-push-action
.
Note: Make sure that the builder profile being used has both architectures enabled in WarpBuild UI.
Deleting a Builder Profile
You can delete a builder profile from the Docker Builders page. It is necessary to wait for all the builds to finish before deleting a builder profile.
Pricing
Usage is charged for the duration of the builder and the builder size. Any number of builds can be run concurrently on a builder profile.
Size | Price / min |
---|---|
16vCPU, 32GB RAM, 100GB Disk | $0.06 |
32vCPU, 64GB RAM, 200GB Disk | $0.12 |
64vCPU, 128GB RAM, 200GB Disk | $0.24 |
96vCPU, 192GB RAM, 600GB Disk | $0.36 |
192vCPU, 384GB RAM, 600GB Disk | $0.72 |
Any number of container builds can run on the builders in parallel.
Multi-arch builders are billed at 2x the price of single-arch builders.
F.A.Q.
How does caching work for concurrent builds?
For caching behavior between concurrent builds, note that the cache is shared but eventually consistent
. This means that layer caching from one build may not be immediately available to another concurrent build, but will be available for future builds after synchronization occurs.
Build summary doesn't get generated
At the moment, build summary will not be generated from docker/build-push-action
. The action might also display a warning. This is expected and does not affect the build process.
We recommend to add the following env variables in docker/build-push-action
to disable the build summary.
Docker Builder is timing out
Docker Builders have timeout built-in so that users don't get charged for builders that are idle. We recommend that you invoke the WarpBuilds/docker-configure
action just before the build-and-push
action or any other step that performs docker build.
How to use cache-to
and cache-from
with Docker Builders
When using Docker Builders, the cache-to
and cache-from
options are not required. A cached Docker Builder will automatically cache the layers and reuse them for subsequent builds.
Is the size of the Docker machine related to the the GitHub runner?
No, the size of the Docker machine is not limited by or related to the size of the GitHub runner used. It is determined by the size of the builder profile that you have selected.
Do I get charged for both the GitHub runner and the WarpBuild Docker builder runtime?
Yes. These are two separate, independent resources and you will be charged for both.
exec format error
while building for arm64 / multi-platform builds
This is likely because the builder profile does not have the correct architectures selected for your builder profile. Ensure the builder profile has both the architectures enabled.
Last updated on