Docs: Builder types

Mon, 01 Jan 0001 00:00:00 +0000

Skaffold supports the following builder types:

Docs: Build environments

Mon, 01 Jan 0001 00:00:00 +0000

Skaffold supports the following build environments:

Docs: Cross-platform and multi-platform build support

Mon, 01 Jan 0001 00:00:00 +0000

Skaffold selectively supports building for an architecture that is different than the development machine architecture (cross-platform build) or building for multiple architectures (multiple-platform build). The target platforms for an artifact can be specified in one of the following ways:

The pipeline’s platforms property in the skaffold.yaml file.

build:
  platforms: ["linux/arm64"]
  artifacts:
    - image: example

The artifact’s platforms constraints in the skaffold.yaml file. This overrides the value specified in the pipeline’s platforms property.

build:
  artifacts:
    - image: app1
      platforms: ["linux/arm64"]
    - image: app2
      platforms: ["linux/amd64"]

The CLI flag --platform which overrides the values set in both the previous ways.

skaffold build --platform=linux/arm64,linux/amd64

Additionally, for skaffold dev, skaffold debug and skaffold run commands, where the build output gets deployed immediately, skaffold checks the platform for the kubernetes cluster nodes and attempts to build artifacts for that target platform.

The final list of target platforms need to ultimately be supported by the target builder, otherwise it’ll fail the build. The cross-platform build support for the various builders can be summarized in the following table:

	Local Build	In Cluster Build	Remote on Google Cloud Build
Dockerfile	Cross-platform and multi-platform supported	Cross-platform supported but platform should match cluster node running the pod.	Cross-platform and multi-platform supported
Jib Maven and Gradle	Cross-platform and multi-platform supported	-	Cross-platform and multi-platform supported
Cloud Native Buildpacks	Only supports `linux/amd64`	-	Only supports `linux/amd64`
Bazel	Cross-platform supported	-	-
ko	Cross-platform and multi-platform supported	-	Cross-platform and multi-platform supported
Custom Script	Cross-platform and multi-platform supported but requires user to implement it in the build script	Cross-platform and multi-platform supported but requires user to implement it in the build script	-

Note

Skaffold supports multi-platform image builds natively for the jib builder, the ko builder and the custom builder. For other builders that support building cross-architecture images, Skaffold will iteratively build a single platform image for each target architecture and stitch them together into a multi-platform image, and push it to the registry.

Skaffold – Build

Docs: Builder types

Docs: Build environments

Docs: Cross-platform and multi-platform build support

Note