Docker 컨테이너 실행 시 플랫폼 불일치 오류 해결 방법

1. 개요

이 글은 Docker 컨테이너 실행 시 발생할 수 있는 플랫폼 불일치 오류 문제를 해결하는 방법을 안내합니다.

 

Windows 10에서 Node.js 애플리케이션을 Docker 이미지로 빌드한 후, Raspberry Pi 4에서 실행하려 했을 때 다음과 같은 오류가 발생했습니다.

WARNING: The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested

 

2. 오류 원인

해당 오류는 로컬 개발 환경과 실행 환경의 아키텍처 차이에서 비롯됩니다.

• 개발 환경: Windows 10 (x64, AMD64 아키텍처)
• 배포 환경: Raspberry Pi 4 (ARM64, AARCH64 아키텍처)

Windows에서 빌드된 x86_64 기반 Docker 이미지를 ARM64 아키텍처를 사용하는 Raspberry Pi 4에서 실행하려 했기 때문에 오류가 발생하게 된 것입니다.

 

3. 해결 방법

이 문제는 Docker의 --platform 옵션을 사용하여 해결할 수 있습니다. 이 옵션을 통해 원하는 아키텍처에 맞는 이미지를 빌드할 수 있습니다.

 

Docker는 여러 아키텍처를 지원하며, --platform 옵션을 사용하면 Raspberry Pi 4에서 실행할 수 있는 ARM64 이미지를 빌드할 수 있습니다.

docker build --platform linux/arm64 .

 

4. 결론

이 글에서는 Docker 컨테이너 실행 시 발생할 수 있는 플랫폼 불일치 오류를 해결하는 방법을 다뤘습니다.

 

오류는 주로 로컬 개발 환경과 실행 환경의 아키텍처 차이로 발생하며, --platform 옵션을 사용하여 이를 해결할 수 있습니다.