[오류 천국 : Docker편] (Mac M1) no matching manifest for linux/arm64/v8 in the manifest list entries

오류

• mac m1 환경에서 docker를 사용하여 mysql 8버전의 이미지를 다운 받으려고 한다.
• docker pull mysql:8 명령어를 실행했더니 다음과 같은 오류가 났다.

원인 분석

도커 허브의 MySQL 공식 이미지 안내에는 ARM 64 태그가 달려있다. 그럼에도 불구하고 정상적으로 이미지를 당겨 올 수 없기 때문에 오류가 뜨는 것으로 보인다.

해결

도커 명령어 옵션으로 ' --platform linux/amd64 '를 덧붙여

이미지를 당겨오는 플랫폼이

arm64 환경이 아닌 amd64의 linux 환경이라고 명시함으로써

에러를 피해 가는 방법을 사용하면 정상적으로 이미지를 다운 받을 수 있다.

이 때 platform 인자는 서버가 여러 종류의 platform을 가지고 있을 때 그 중 무엇으로 할 것인지를 명시하는 인자인데, 여기에서는 amd64의 linux 환경으로 platform을 명시해준다.

따라서

docker pull --platform linux/amd64 mysql:8

로 진행했더니 아래와 같이 정상적으로 작동했다.

+) 다른 해결 방법

비슷하게 docker-compose.yml 파일을 찾아 아래 내용을 추가하고,

platform: linux/amd64

(아래 사진의 빨간 박스 부분에 추가)

터미널에서 아래 명령어를 실행하여 위의 yml파일을 실행한 후 다시 진행해도
오류가 해결된다고 한다.

docker-compose up

참고

• https://onexlab-io.medium.com/apple-m1-chip-no-matching-manifest-for-linux-arm64-v8-docker-mysql-5142060a9309
• https://dpcalfola.tistory.com/entry/docker-no-matching-manifest-for-linuxarm64v8-in-the-manifest-list-entries