docker · Docker
A mensagem
exec /usr/local/bin/entrypoint.sh: exec format error
O que significa
O kernel não reconheceu o cabeçalho daquele executável e, hoje, é quase sempre incompatibilidade de arquitetura — uma imagem arm64 construída no Apple Silicon rodando num host amd64, ou o contrário. Um script de shell sem a primeira linha #!/bin/sh produz o mesmo texto. Construir com docker build --platform=linux/amd64 é a resposta comum, mas não remove a incompatibilidade: encobre com emulação, e tudo que passa pelo QEMU fica várias vezes mais lento que o nativo. Para uma imagem que você vai manter, construir as duas arquiteturas com buildx é o caminho que não cobra nada em execução.
A correção
docker build --platform=linux/amd64 .- Impresso por
- docker
- Docker
- 12
Os erros do Docker só ficam legíveis quando você os coloca numa camada — o cliente que não alcança o daemon, o registro que te recusa, um RUN que falha durante o build e um contêiner que morre ao subir são quatro problemas diferentes — e nas camadas de build e execução a linha em si não é o motivo: o motivo está na saída do comando que rodava dentro, e o preço de cada correção também muda por camada.
Como ler uma mensagem de erro
- Leia da primeira linha para baixo. Quanto mais abaixo, mais são as tripas da ferramenta; a causa costuma estar no topo.
- Se há arquivo e número de linha, comece ali — não o quadro superior da pilha, e sim a linha mais alta que nomeie um arquivo seu.
- Pesquise a mensagem literal, mas tire primeiro seus caminhos e nomes de variáveis: é isso que impede a busca de casar.
- A mesma condição é redigida de formas diferentes conforme a versão. Se os resultados não batem, some o número da versão.
- Antes de colar uma correção, veja o que ela descarta. Algumas não dá para desfazer.
Perguntas frequentes
Q. O que significa “exec /usr/local/bin/entrypoint.sh: exec format error”?
O kernel não reconheceu o cabeçalho daquele executável e, hoje, é quase sempre incompatibilidade de arquitetura — uma imagem arm64 construída no Apple Silicon rodando num host amd64, ou o contrário. Um script de shell sem a primeira linha #!/bin/sh produz o mesmo texto. Construir com docker build --platform=linux/amd64 é a resposta comum, mas não remove a incompatibilidade: encobre com emulação, e tudo que passa pelo QEMU fica várias vezes mais lento que o nativo. Para uma imagem que você vai manter, construir as duas arquiteturas com buildx é o caminho que não cobra nada em execução.
Q. Como corrigir?
docker build --platform=linux/amd64 . — antes de rodar, veja acima o que este comando descarta.
Q. Qual ferramenta imprime isso?
docker. Fica em Docker e a mensagem tem 5 palavras.