Docker - M1 no matching manifest for linux/arm64/v8 in the manifest list entries 에러

 no matching manifest for linux/arm64/v8 in the manifest list entries

 

이 에러는 현재 Docker를 이미지 빌드 혹은 가져오때 플랫폼에 맞는 타입이 없어서 나타난다.

필자는 M1에서 실행하였는데, 실제 M1은 Linux는 아니기 때문에 발생한다.

보통 M1과 같은 일반적이지 않은 클라이언트를 사용시 발생한다. 현재 클라이언트의 종류를 확인하고자 한다면, docker version 명령으로 알 수 있다.

 

이를 해결하기 위해서는 --platform 옵션을 사용해서 호환이 가능한 플랫폼으로 직접 지정하여 적용하여야 한다.

M1의 경우 Linux와 호환이 가능하기 때문에 linux/amd64 혹은 linux로 지정하면 사용이 가능하다.

이는 Docker 이미지를 빌드할 때에도 빌드할 플랫폼을 지정하면 해결이 가능하다.

--platform 관련된 세부적인 내용은 아래에서 확인할 수 있다.

https://docs.docker.com/build/building/multi-platform/