ci(docker): add linux/arm64 to image builds (#3168)#3208
Open
abbyshekit wants to merge 1 commit intomainfrom
Open
ci(docker): add linux/arm64 to image builds (#3168)#3208abbyshekit wants to merge 1 commit intomainfrom
abbyshekit wants to merge 1 commit intomainfrom
Conversation
IronClaw ships only linux/amd64 Docker images today, blocking native runs on Apple Silicon, Graviton, and Raspberry Pi 4/5 (arm64). The Cranelift backend already supports aarch64, so the gap is purely in the build matrix. This adds linux/arm64 to both image builds: - .github/workflows/docker.yml (regular + worker) - .github/workflows/rebuild-release-image.yml (runtime + final) Plus a docker/setup-qemu-action step before each Buildx setup so the amd64 GitHub runner can emit the arm64 image via emulation. The inline comment notes the ~2-3x build-time hit and suggests swapping to a native arm64 runner if/when one is available. Dockerfile header comment: removed the `--platform linux/amd64` example (host-arch is the right default once the official images go multi-arch) and added a multi-arch buildx example. Confirmed feasible by @gcaguilar's PoC fork; only armv7 (32-bit) is blocked, tracked separately in #1339. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Code Review
This pull request updates the build instructions in the Dockerfile to include commands for both host-architecture and multi-architecture builds using Docker Buildx. There are no review comments to address, and I have no feedback to provide.
|
Maybe it would be better to do a native build instead of using QEMU, |
This was referenced May 3, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Closes #3168.
IronClaw ships only `linux/amd64` Docker images today, blocking native runs on Apple Silicon, AWS Graviton, Raspberry Pi 4/5, and the broader arm64 fleet. Cranelift (the WASM JIT) already supports `aarch64`, so the gap is purely in the publish matrix.
What this changes
.github/workflows/docker.yml— adds `docker/setup-qemu-action` (pinned by SHA) and switches both image builds (`ironclaw` + `ironclaw-worker`) to `platforms: linux/amd64,linux/arm64`..github/workflows/rebuild-release-image.yml— same treatment for both build paths (`runtime` target + final-stage fallback).Dockerfileheader — removed the `--platform linux/amd64` example (host-arch is the right default for a developer once the official images go multi-arch) and added a Buildx multi-arch example.Cost / risk
QEMU emulation on the amd64 runner adds roughly 2-3x to the arm64 build time vs amd64. If that bites CI minutes, the right next step is provisioning a native arm64 runner (the inline comment in both workflows points at this). Until then, emulation is the correct tradeoff for parity.
Confirmation
@gcaguilar's PoC fork run already showed this works end-to-end: https://github.com/gcaguilar/ironclaw/actions/runs/25252983548. Only armv7 (32-bit) is blocked, which is tracked separately in #1339.
Test plan
🤖 Generated with Claude Code