'The requested image's platform (linux/arm64) does not match the detected host platform (linux/amd64/v3)' 에러 Troubleshooting

상황

프론트엔드 빌드 파일을 도커 이미지로 만들어 서버에 수동 배포를 시도했을 때 발생한 문제이다.

결론부터 말하자면 해당 에러는 Docker 이미지의 플랫폼(linux/arm64)이 현재 호스트의 플랫폼(linux/amd64)과 일치하지 않을 때 발생한다. M1 칩을 사용하는 macOS 환경에서 x86_64 아키텍처용 이미지를 실행하려고 할 때나, 또는 반대의 경우에도 발생한다.

해결 방법

가장 간단한 방법은 배포하려는 호스트의 플랫폼에 맞추는 것이다. 필자는 ec2 ubuntu 인스턴스에 배포할 목적이기 때문에 플랫폼을 linux/amd64로 지정했다.

아래의 명령어로 다시 빌드 후 배포하였다.

docker buildx build --platform linux/amd64 .