build: use arm-native gha runners for distributed multi-platform

Signed-off-by: David Karlsson <[email protected]>
docker · Jan 20, 2025 · b0ef15d · b0ef15d
1 parent 6e529f4
commit b0ef15d
Showing 1 changed file with 20 additions and 22 deletions.
diff --git a/content/manuals/build/ci/github-actions/multi-platform.md b/content/manuals/build/ci/github-actions/multi-platform.md
@@ -100,23 +100,22 @@ jobs:
 
 ## Distribute build across multiple runners
 
-In the previous example, each platform is built on the same runner which can
-take a long time depending on the number of platforms and your Dockerfile.
-
-To solve this issue you can use a matrix strategy to distribute the build for
-each platform across multiple runners and create manifest list using the
+Building multiple platforms on the same runner can significantly extend build
+times, particularly when dealing with complex Dockerfiles or a high number of
+target platforms. By distributing platform-specific builds across multiple
+runners using a matrix strategy, you can drastically reduce build durations and
+streamline your CI pipeline. These examples demonstrate how to allocate each
+platform build to a dedicated runner, including ARM-native runners where
+applicable, and create a unified manifest list using the
 [`buildx imagetools create` command](/reference/cli/docker/buildx/imagetools/create.md).
 
-The following workflow will build the image for each platform on a dedicated
-runner using a matrix strategy and push by digest. Then, the `merge` job will
-create manifest lists and push them to two registries:
+The workflow also highlights tagging and labeling using the [Docker Metadata action](https://github.com/docker/metadata-action),
+pushing platform-specific images by digest, and creating manifest lists for two
+registries:
 
 - Docker Hub: `docker.io/docker-user/my-app`
 - GitHub Container Registry: `ghcr.io/gh-user/my-app`
 
-This example also uses the [`metadata` action](https://github.com/docker/metadata-action)
-to set tags and labels.
-
 ```yaml
 name: ci
 
@@ -129,13 +128,15 @@ env:
 
 jobs:
   build:
-    runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        platform:
-          - linux/amd64
-          - linux/arm64
+        include:
+        - platform: linux/amd64
+          os: ubuntu-latest
+        - platform: linux/arm64
+          os: ubuntu-24.04-arm
+    runs-on: ${{ matrix.os }}
     steps:
       - name: Prepare
         run: |
@@ -163,9 +164,6 @@ jobs:
           username: ${{ github.repository_owner }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Set up QEMU
-        uses: docker/setup-qemu-action@v3
-
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
 
@@ -284,8 +282,7 @@ target "image-all" {
   inherits = ["image"]
   platforms = [
     "linux/amd64",
-    "linux/arm/v6",
-    "linux/arm/v7",
+    "linux/riscv64",
     "linux/arm64"
   ]
 }
@@ -337,13 +334,13 @@ jobs:
           retention-days: 1
 
   build:
-    runs-on: ubuntu-latest
     needs:
       - prepare
     strategy:
       fail-fast: false
       matrix:
         platform: ${{ fromJson(needs.prepare.outputs.matrix) }}
+    runs-on: ${{ matrix.platform == 'linux/arm64' && 'ubuntu-24.04-arm' || 'ubuntu-latest' }}
     steps:
       - name: Prepare
         run: |
@@ -355,14 +352,15 @@ jobs:
         with:
           name: bake-meta
           path: ${{ runner.temp }}
-      
+
       - name: Login to Docker Hub
         uses: docker/login-action@v3
         with:
           username: ${{ vars.DOCKERHUB_USERNAME }}
           password: ${{ secrets.DOCKERHUB_TOKEN }}
 
       - name: Set up QEMU
+        if: ${{ matrix.platform == 'linux/riscv64' }}
         uses: docker/setup-qemu-action@v3
 
       - name: Set up Docker Buildx