From 282b41c275649af48a14afde4bfb7c334b7e7ffe Mon Sep 17 00:00:00 2001 From: jasdeepbhalla Date: Mon, 8 Jun 2026 14:29:05 -0700 Subject: [PATCH] docs: document multiplatform limitation for share-image-jobs approach Fixes #25044 --- .../manuals/build/ci/github-actions/share-image-jobs.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/content/manuals/build/ci/github-actions/share-image-jobs.md b/content/manuals/build/ci/github-actions/share-image-jobs.md index c6615ca7fa51..dac4ecd02a15 100644 --- a/content/manuals/build/ci/github-actions/share-image-jobs.md +++ b/content/manuals/build/ci/github-actions/share-image-jobs.md @@ -13,6 +13,14 @@ in a workflow using the [actions/upload-artifact](https://github.com/actions/upl and [actions/download-artifact](https://github.com/actions/download-artifact) actions: +> [!NOTE] +> +> This approach only works for single-platform images. The `type=docker` exporter +> produces a tar archive that `docker load` can import, but multi-platform image +> indexes cannot be exported or loaded this way. For multi-platform builds, use a +> registry to push and pull the image between jobs, or share build cache using the +> [GitHub Actions cache or registry cache exporters](cache.md). + ```yaml name: ci