[Docker] Colima를 이용한 아키텍처 호완성 문제 해결, 멀티 아키텍처 이미지 빌드, docker buildx build --platform

ㅁ 들어가며

 MacBook M3에서 로컬에서 빌드한 Docker 이미지가 개발 환경에서 문제가 발생하는 경우가 있다. 그 이유는 주로 아키텍처 호환성 문제 때문일 수 있다.

 MacBook M3는 ARM 아키텍처를 사용하지만, 많은 서버 환경은 여전히 x86 아키텍처를 사용한다. 이로 인해, ARM에서 빌드한 이미지를 x86 환경에서 실행하려고 하면 문제가 발생할 수 있다.

 

ㅁ 해결방법

ㅇ 이 문제를 해결하기 위해 Colima를 사용하여 Docker 이미지를 빌드하는 것이 도움이 될 수 있다.

ㅇ Colima는 MacOS에서 Docker를 실행하기 위한 경량의 대안으로, 기본적으로 QEMU를 사용하여 다양한 아키텍처를 지원한다.
ㅇ 다음은 Colima를 사용하여 멀티 아키텍처 Docker 이미지를 빌드하는 방법이다.

 

ㅁ Colima 설치 및 시작

brew install colima
colima start --arch x86_64

ㅇ Colima를 실행할 때에  x86 아키텍처를 사용한다.

 

ㅁ Docker Buildx 사용

docker buildx create --use

ㅇ Docker Buildx는 멀티 플랫폼 이미지를 빌드할 수 있도록 도와준다.

ㅇ 위 명령어를 사용하여 Buildx를 활성화한다.

 

ㅁ 멀티 아키텍처 이미지 빌드

docker buildx build --platform linux/amd64,linux/arm64 -t your_image_name:tag .

ㅇ Dockerfile이 있는 디렉토리에서 다음 명령어를 실행하여 멀티 아키텍처 이미지를 빌드한다.

ㅇ 이렇게 하면 ARM과 x86 아키텍처에서 모두 실행 가능한 Docker 이미지를 빌드할 수 있다.

 

ㅁ 또 다른 방법: amd로 빌드하도록 지정하는 옵션

DOCKER_BUILD_OPTS=
if [[ $(arch) == 'arm64' ]]; then
  DOCKER_BUILD_OPTS="--platform=linux/amd64"
fi

${DOCKERCLI} build $DOCKER_BUILD_OPTS -t ${IMAGE_NAME} . -f ./docker/Dockerfile

ㅇ docker 이미지 빌드 옵션(DOCKER_BUILD_OPTS)에 amd"로 지정할 수 있다.

 를 추가해서 이미지 빌드를 하고 aws에 배포를 실행하니 에러 없이 해결할 수 있었다!

 

참조: [Docker] M1 mac 이미지 배포 오류

 

ㅁ 함께 보면 좋은 사이트

ㅇ 알아두면 유용한 도커 빌드 팁 - 멀티 스테이지 빌드
ㅇ Docker buildx로 멀티 플랫폼 이미지 빌드하기

ㅇ [Docker] 맥북M1에 도커 컨테이너 colima설치