Optimize multi-arch docker image build

Author: maxsxu

Dockerfile

@@ -1,5 +1,5 @@
 # Build the manager binary
-FROM golang:1.25.8-trixie AS builder
+FROM --platform=$BUILDPLATFORM golang:1.25.8-trixie as builder
 
 WORKDIR /workspace/api
 COPY api/ .
@@ -20,11 +20,13 @@ COPY controllers/ controllers/
 COPY utils/ utils/
 
 # Build
-RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 GO111MODULE=on go build -a -o manager main.go
+ARG TARGETOS
+ARG TARGETARCH
+RUN CGO_ENABLED=0 GOOS=${TARGETOS:-linux} GOARCH=${TARGETARCH:-amd64} GO111MODULE=on go build -a -o manager main.go
 
 # Use distroless as minimal base image to package the manager binary
 # Refer to https://github.com/GoogleContainerTools/distroless for more details
-FROM gcr.io/distroless/static:nonroot
+FROM --platform=$TARGETPLATFORM gcr.io/distroless/static:nonroot
 WORKDIR /
 COPY --from=builder /workspace/manager .
 USER 65532:65532

Makefile

@@ -133,11 +133,11 @@ generate: controller-gen
 
 # Build the docker image
 docker-build: test
-	docker build --platform linux/amd64 . -t ${IMG}
+	docker buildx build --platform linux/amd64,linux/arm64 . -t ${IMG} --load
 
 # Build image for red hat certification
 docker-build-redhat:
-	docker build --platform linux/amd64 -f redhat.Dockerfile . -t ${IMG} --build-arg VERSION=${VERSION} --no-cache
+	docker buildx build --platform linux/amd64,linux/arm64 -f redhat.Dockerfile . -t ${IMG} --build-arg VERSION=${VERSION} --load --no-cache
 
 # Push the docker image
 image-push:
@@ -171,7 +171,7 @@ bundle: yq kustomize manifests
 # Build the bundle image.
 .PHONY: bundle-build
 bundle-build:
-	docker build --platform linux/amd64 -f bundle.Dockerfile -t $(BUNDLE_IMG) .
+	docker buildx build --platform linux/amd64,linux/arm64 -f bundle.Dockerfile -t $(BUNDLE_IMG) --load .
 
 .PHONY: bundle-push
 bundle-push: ## Push the bundle image.
@@ -187,7 +187,7 @@ rbac: manifests
 release: manifests kustomize crd rbac manager operator-docker-image helm-crds
 
 operator-docker-image: manager test
-	docker build --platform linux/amd64 -f operator.Dockerfile -t $(OPERATOR_IMG) .
+	docker buildx build --platform linux/amd64,linux/arm64 -f operator.Dockerfile -t $(OPERATOR_IMG) --load .
 	docker tag $(OPERATOR_IMG) $(OPERATOR_IMG_LATEST)
 
 docker-push:
@@ -256,7 +256,7 @@ function-mesh-docker-image-name:
 
 # Build the docker image without tests
 docker-build-skip-test:
-	docker build --platform linux/amd64 . -t ${IMG}
+	docker buildx build --platform linux/amd64,linux/arm64 . -t ${IMG} --load
 
 e2e: skywalking-e2e yq
 	$(E2E) run -c .ci/tests/integration/e2e.yaml
@@ -297,7 +297,7 @@ redhat-certificated-bundle: yq kustomize manifests
 # Build the bundle image.
 .PHONY: redhat-certificated-bundle-build
 redhat-certificated-bundle-build:
-	docker build --platform linux/amd64 -f bundle.Dockerfile -t $(BUNDLE_IMG) .
+	docker buildx build --platform linux/amd64,linux/arm64 -f bundle.Dockerfile -t $(BUNDLE_IMG) --load .
 
 .PHONY: redhat-certificated-bundle-push
 redhat-certificated-bundle-push: ## Push the bundle image.
@@ -307,7 +307,7 @@ redhat-certificated-bundle-push: ## Push the bundle image.
 # Build the bundle image.
 .PHONY: redhat-certificated-image-build
 redhat-certificated-image-build:
-	docker build --platform linux/amd64 -f redhat.Dockerfile . -t ${OPERATOR_IMG} --build-arg VERSION=${VERSION} --no-cache
+	docker buildx build --platform linux/amd64,linux/arm64 -f redhat.Dockerfile . -t ${OPERATOR_IMG} --build-arg VERSION=${VERSION} --load --no-cache
 
 .PHONY: redhat-certificated-image-push
 redhat-certificated-image-push: ## Push the bundle image.

operator.Dockerfile

@@ -1,4 +1,4 @@
-FROM alpine:3.21
+FROM --platform=$TARGETPLATFORM alpine:3.21
 
 ENV GID=10001
 ENV UID=10000
@@ -9,6 +9,7 @@ RUN apk upgrade --no-cache \
     && addgroup -g $GID pulsar \
     && adduser -u $UID -G pulsar -D -g '' $USER
 
-ADD bin/function-mesh-controller-manager /manager
+ARG TARGETARCH
+ADD bin/function-mesh-controller-manager-${TARGETARCH:-amd64} /manager
 
 USER $USER

redhat.Dockerfile

@@ -1,5 +1,5 @@
 # Build the manager binary
-FROM golang:1.25.8-trixie as builder
+FROM --platform=$BUILDPLATFORM golang:1.25.8-trixie AS builder
 
 WORKDIR /workspace/api
 COPY api/ .
@@ -20,12 +20,14 @@ COPY controllers/ controllers/
 COPY utils/ utils/
 
 # Build
-RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 GO111MODULE=on go build -a -o manager main.go
+ARG TARGETOS
+ARG TARGETARCH
+RUN CGO_ENABLED=0 GOOS=${TARGETOS:-linux} GOARCH=${TARGETARCH:-amd64} GO111MODULE=on go build -a -o manager main.go
 
 # Use ubi image as the base image which is required by the red hat certification.
 # Base on the image size, the order is ubi > ubi-minimal > ubi-micro.
 # https://access.redhat.com/documentation/en-us/red_hat_software_certification/8.45/html/red_hat_openshift_software_certification_policy_guide/assembly-requirements-for-container-images_openshift-sw-cert-policy-introduction#con-image-metadata-requirements_openshift-sw-cert-policy-container-images
-FROM registry.access.redhat.com/ubi8/ubi-micro:latest
+FROM --platform=$TARGETPLATFORM registry.access.redhat.com/ubi8/ubi-micro:latest
 
 ARG VERSION