Docker 이미지가 M2 Mac에서는 되는데 GitHub Actions(x86)에서는 "exec format error"로 실패합니다

Question

로컬(M2 Mac)에서 빌드하고 푸시한 이미지를 GitHub Actions Ubuntu 러너에서 풀해서 실행하면 이런 에러가 납니다.
exec /app/server: exec format error
Dockerfile은 단순합니다.
FROM node:22-alpine
WORKDIR /app
COPY . .
RUN npm ci --omit=dev
CMD ["node", "server.js"]
빌드는 로컬에서 docker build -t myreg/app:v1 . && docker push로 했고, CI에서는 docker

김영삼 · Accepted Answer

원인 정확합니다. M2 Mac은 기본적으로 arm64 이미지만 빌드해서 푸시합니다. x86 리눅스에서 pull하면 실행 바이너리 포맷이 달라서 exec format error가 납니다.
해결: buildx로 멀티아키 빌드
# 1) buildx 빌더 준비 (한 번만)
docker buildx create --name xbuilder --use
docker buildx inspect --bootstrap

# 2) 멀티아키 빌드 + 푸시 (한 번에)
docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t myreg/app:v1 \
  --push .
이러면 manifest list가 만들어져서 pull하는 측 아키텍처에 맞는 이미지를 자동 선택합니다.
CI에서 빌드하는 게 정답
실무에서는 로컬 푸시 자체를 금지하고 CI에서만 이미지 빌드·푸시하는 팀이 많습니다. GitHub Actions에서는 docker/build-push

서버지기영호 · Answer

참고로 arm64 전용으로만 배포하는 팀이면 굳이 멀티아키 안 해도 됩니다. AWS Graviton, Ampere GCP 등 최근 클라우드는 arm64 러너가 저렴하니까 아예 CI와 프로덕션을 arm64로 통일하는 게 비용·속도 면에서 유리해요. 저희 팀은 그렇게 이관했습니다.

풀스택지훈 · Answer

CI에서 buildx로 amd64/arm64 동시 빌드 + 캐시 적용하니까 해결됐습니다. 빌드 시간이 처음엔 오래 걸려서 걱정했는데 GHA 캐시 먹으니까 2분 대로 떨어지네요. 감사합니다!

댓글 0