dongzzirit 님의 블로그

Docker 이미지를 빌드하거나 실행하는 과정에서 플랫폼 설정이 맞지 않아 경고 메시지가 발생하는 경우가 있습니다.

이번 포스팅에서는 Docker 플랫폼 미스매치 문제의 원인과 해결 방법을 간단히 정리해 보겠습니다.

🛑 문제 발생

Docker 이미지를 빌드하는 중 아래와 같은 경고 메시지가 나타났습니다:

원인 분석

• 호스트 플랫폼 (linux/amd64/v3)과 Docker 이미지 플랫폼 (linux/arm64/v8)이 서로 다른 경우 발생.
• 기본적으로 Docker는 호스트 환경과 동일한 플랫폼을 사용합니다. 그러나 플랫폼을 명시하지 않으면 특정 상황에서 호환되지 않는 플랫폼으로 빌드될 수 있습니다.

✅ 해결 방법

1️⃣ 플랫폼 명시하여 빌드

경고를 방지하려면 플랫폼을 명시적으로 설정하여 이미지를 빌드합니다.
아래 명령어를 실행하면 문제가 해결됩니다

docker build --platform linux/amd64 -t <이름> .

2️⃣ 이미지 실행 및 확인

정상적으로 빌드된 이미지를 실행한 후 컨테이너 상태를 확인합니다

docker run -p 8080:8080 -d --name social <이름>

컨테이너 상태 확인

docker ps

컨테이너가 정상적으로 실행 중이라면 다음과 같이 출력됩니다:

 요약

• Docker 플랫폼 미스매치 오류는 호스트와 Docker 이미지의 플랫폼이 다를 때 발생합니다.
• 빌드 시 --platform 옵션을 사용해 호환되는 플랫폼을 명시하면 문제를 해결할 수 있습니다.