Skip to content
🎉 Launch sale:50% off everything over $22 — automatically applied at checkout· ends Aug 2Shop the sale →
DevOps AI ToolKit
Newsletter
All prompts
AI for Kubernetes & Helm Difficulty: Intermediate ClaudeChatGPT

Kubernetes Multi-Arch Image Scheduling Prompt

Fix pods that crash with 'exec format error' or fail to pull on mixed amd64/arm64 clusters — covering multi-arch manifest lists, node affinity on kubernetes.io/arch, and Graviton/ARM migration.

Target user
platform engineers running mixed-architecture or ARM-based Kubernetes clusters
Difficulty
Intermediate
Tools
Claude, ChatGPT

The prompt

You are a senior Kubernetes platform engineer who has migrated workloads onto mixed amd64/arm64 node pools (including AWS Graviton) and knows how OCI manifest lists, node labels, and the scheduler interact.

I will provide:
- The symptom (CrashLoopBackoff with `exec format error`, `no match for platform`, or ImagePullBackOff on some nodes)
- The image reference(s) and whether they are multi-arch manifest lists
- The node pool architecture mix (`kubectl get nodes -L kubernetes.io/arch`)

Your job:

1. **Verify image architecture support** — show how to inspect the image with `docker buildx imagetools inspect` / `crane manifest` to confirm whether it is a manifest list covering `linux/amd64` and `linux/arm64` or a single-arch image.
2. **Explain the failure modes** — `exec format error` means a wrong-arch binary ran (single-arch image landed on the wrong node); `no match for platform` / pull failure means the manifest list lacks that arch.
3. **Pin with node affinity** — when an image is single-arch, write `nodeAffinity` on `kubernetes.io/arch` (or `nodeSelector`) so the pod only schedules where its binary runs.
4. **Recommend the real fix** — multi-arch build with `docker buildx --platform linux/amd64,linux/arm64` and a pushed manifest list so the kubelet pulls the correct arch automatically and no affinity is needed.
5. **Audit dependencies** — flag sidecars, init containers, and base images that may be single-arch and silently break only on one node pool.
6. **Plan a safe rollout** — suggest tainting ARM nodes during migration so only validated, multi-arch workloads land there until coverage is proven.

Output as: a root-cause classification, a node-affinity YAML patch for the interim, and a multi-arch build recommendation for the permanent fix.

Never assume an image is multi-arch because it runs locally — the local pull may have only fetched your host architecture's layer.

Run this prompt with AI

Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.

Related prompts

More Kubernetes & Helm prompts & error guides

Browse every Kubernetes & Helm prompt and troubleshooting guide in one place.

Free download · 368-page PDF

Reading prompts? Get all 500 in one free PDF

500 battle-tested, copy-paste AI prompts engineered by a senior systems engineer — every one with fill-in placeholders and safety/back-out notes. Drop your email and it's yours.

  • 500 prompts: Linux · Kubernetes · Terraform · OpenStack · GitLab · Docker · Monitoring · Incident Response
  • Instant PDF download — yours free, forever
  • Plus one practical AI-workflow email a week (no spam)

Single opt-in · unsubscribe anytime · no spam.