docker · Docker
오류 문구
exec /usr/local/bin/entrypoint.sh: exec format error
무슨 뜻인가
커널이 그 실행 파일의 헤더를 알아보지 못했다는 뜻이고, 요즘은 거의 언제나 아키텍처가 어긋난 것입니다 — Apple Silicon에서 만든 arm64 이미지를 amd64 서버에서 돌리거나 그 반대입니다. 셸 스크립트라면 첫 줄의 #!/bin/sh가 빠졌을 때도 같은 문구가 나옵니다. docker build --platform=linux/amd64로 굽는 것이 흔한 대처지만, 그것은 어긋남을 없애는 것이 아니라 에뮬레이션으로 덮는 것입니다 — QEMU를 거치는 빌드와 실행은 원래 아키텍처보다 몇 배 느려집니다. 오래 쓸 이미지라면 buildx로 두 아키텍처를 함께 굽는 것이 값을 치르지 않는 길입니다.
고치는 명령
docker build --platform=linux/amd64 .- 내는 도구
- docker
- Docker
- 12
docker의 오류는 어느 층에서 났는지를 먼저 갈라야 읽히는데 — 클라이언트가 데몬에 닿지 못한 것, 레지스트리가 거절한 것, 빌드 중에 RUN이 실패한 것, 컨테이너가 뜨자마자 죽은 것이 서로 다른 문제입니다 — 특히 빌드와 실행 단계의 오류는 문구 자체가 이유가 아니라 그 안에서 돌던 명령이 남긴 출력에 이유가 있고, 고치는 명령의 값도 층마다 다릅니다.
오류 문구를 읽는 법
- 첫 줄부터 읽습니다. 아래로 갈수록 도구 내부 이야기이고, 정작 원인은 맨 위에 적혀 있습니다.
- 파일 이름과 줄 번호가 있으면 거기가 시작점입니다 — 스택의 가장 위가 아니라, 내가 쓴 파일이 나오는 가장 위 줄입니다.
- 문구를 그대로 검색합니다. 다만 내 경로와 변수 이름은 지웁니다 — 그 부분이 검색을 방해합니다.
- 같은 문구가 도구 판마다 다르게 나옵니다. 검색 결과가 안 맞으면 판 번호를 함께 넣어 봅니다.
- 고치는 명령을 붙여 넣기 전에 그 명령이 무엇을 버리는지 확인합니다. 되돌릴 수 없는 것이 섞여 있습니다.
자주 묻는 질문
Q. exec /usr/local/bin/entrypoint.sh: exec format error 는 무슨 뜻인가요?
커널이 그 실행 파일의 헤더를 알아보지 못했다는 뜻이고, 요즘은 거의 언제나 아키텍처가 어긋난 것입니다 — Apple Silicon에서 만든 arm64 이미지를 amd64 서버에서 돌리거나 그 반대입니다. 셸 스크립트라면 첫 줄의 #!/bin/sh가 빠졌을 때도 같은 문구가 나옵니다. docker build --platform=linux/amd64로 굽는 것이 흔한 대처지만, 그것은 어긋남을 없애는 것이 아니라 에뮬레이션으로 덮는 것입니다 — QEMU를 거치는 빌드와 실행은 원래 아키텍처보다 몇 배 느려집니다. 오래 쓸 이미지라면 buildx로 두 아키텍처를 함께 굽는 것이 값을 치르지 않는 길입니다.
Q. 어떻게 고치나요?
docker build --platform=linux/amd64 . — 실행 전에 위의 설명에서 이 명령이 무엇을 버리는지 확인하세요.
Q. 어느 도구가 내는 오류인가요?
docker입니다. Docker 갈래에 있고, 문구는 5낱말입니다.