runc · Docker
A mensagem
OCI runtime create failed: exec: "bash": executable file not found in $PATH: unknown
O que significa
O contêiner foi criado, mas o programa que você pediu para executar não estava no $PATH dentro dele. Imagens baseadas em Alpine trazem sh e não bash, então docker run -it myapp bash ou um CMD ["bash", ...] termina exatamente neste erro — assim como qualquer ferramenta que você supôs estar na imagem e só existe no seu host. docker run --rm -it myapp sh te dá um shell para ver o que a imagem realmente contém. Se precisar mesmo de bash, RUN apk add --no-cache bash no Dockerfile adiciona, ao custo de uma imagem maior.
A correção
docker run --rm -it myapp sh- Impresso por
- runc
- 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 “OCI runtime create failed: exec: "bash": executable file not found in $PATH: unknown”?
O contêiner foi criado, mas o programa que você pediu para executar não estava no $PATH dentro dele. Imagens baseadas em Alpine trazem sh e não bash, então docker run -it myapp bash ou um CMD ["bash", ...] termina exatamente neste erro — assim como qualquer ferramenta que você supôs estar na imagem e só existe no seu host. docker run --rm -it myapp sh te dá um shell para ver o que a imagem realmente contém. Se precisar mesmo de bash, RUN apk add --no-cache bash no Dockerfile adiciona, ao custo de uma imagem maior.
Q. Como corrigir?
docker run --rm -it myapp sh — antes de rodar, veja acima o que este comando descarta.
Q. Qual ferramenta imprime isso?
runc. Fica em Docker e a mensagem tem 13 palavras.