Build Configuration
The Build stage defines how your Docker image is built from source code. Click on the Build node in the workflow builder to open the configuration panel.
Build Settings
| Field | Description |
|---|---|
| Container Registry | Select the registry where the built image will be pushed (ECR, DockerHub, GCR, or GAR). |
| Dockerfile Path | Path to the Dockerfile within your repository (e.g., Dockerfile, docker/Dockerfile.prod). |
| Build Context | The directory used as the Docker build context (e.g., . for root, ./app for a subdirectory). |
Platform
Select the target architecture for the built image:
| Option | Description |
|---|---|
| None | No architecture constraint — the image is built on whatever node is available. |
| AMD64 | Build for x86_64 architecture. The CI pod will be scheduled on an AMD64 node. |
| ARM64 | Build for AArch64 architecture. The CI pod will be scheduled on an ARM64 node. |
The platform selection uses Kubernetes node affinity to ensure the CI pod runs on a node with the matching kubernetes.io/arch label.
Compute Resources
Configure the CPU and memory allocated to the CI build pod:
| Field | Description | Default |
|---|---|---|
| CPU | CPU allocation in millicores (m). | 1000m |
| Memory | Memory allocation in megabytes (Mi). | 1024 Mi |
Volume
Select the storage volume allocated for the build workspace:
| Available Sizes |
|---|
| 10, 20, 30, 40, 50, 100, 150, 200, 250, 300, 350, 400, 450, 500 Gi |
The default volume size is 20 Gi. Increase this if your build requires significant disk space (e.g., large monorepos, heavy dependencies).
Build Optimizations
| Option | Description |
|---|---|
| Use Spot Instance | Enable to run the build on a spot (preemptible) node instead of on-demand. Spot instances are cheaper but may be reclaimed by the cloud provider. |
| Cache Enabled | Enable Docker build layer caching to speed up subsequent builds by reusing unchanged layers. |
Enable build caching for iterative development workflows where the Dockerfile layers change infrequently. This can significantly reduce build times.
Saving the Configuration
Click Save at the bottom of the panel to apply your build configuration.