Accueil·Messages d’erreur

runc · Docker

Le message

OCI runtime create failed: exec: "bash": executable file not found in $PATH: unknown

Ce que cela veut dire

Le conteneur a bien été créé, mais le programme que vous lui demandiez d'exécuter n'était pas dans son $PATH. Les images basées sur Alpine fournissent sh et pas bash : docker run -it myapp bash ou un CMD ["bash", ...] finit donc exactement sur cette erreur — comme tout outil que vous croyiez dans l'image alors qu'il n'existe que sur votre hôte. docker run --rm -it myapp sh vous donne un shell pour voir ce que l'image contient vraiment. S'il vous faut réellement bash, RUN apk add --no-cache bash dans le Dockerfile l'ajoute, au prix d'une image plus grosse.

Le correctif

docker run --rm -it myapp sh
Émis par
runc
Docker
12

Les erreurs de Docker ne deviennent lisibles qu'une fois rangées par couche — le client qui n'atteint pas le démon, le registre qui refuse, un RUN qui échoue au build, un conteneur qui meurt dès son démarrage sont quatre problèmes distincts — et pour les couches build et exécution, la ligne n'est pas la raison : la raison est dans la sortie de la commande qui tournait à l'intérieur, tandis que le coût de chaque correctif varie aussi selon la couche.

Lire un message d’erreur

  • Lisez à partir de la première ligne. Plus on descend, plus il s’agit des entrailles de l’outil ; la cause est généralement en haut.
  • S’il y a un fichier et un numéro de ligne, commencez là — pas la première image de la pile, mais la ligne la plus haute qui nomme un fichier de vous.
  • Cherchez le message tel quel, mais retirez d’abord vos chemins et vos noms de variables : c’est cela qui empêche la correspondance.
  • La même situation se formule autrement selon la version de l’outil. Si les résultats sonnent faux, ajoutez le numéro de version.
  • Avant de coller un correctif, vérifiez ce qu’il jette. Certains sont irréversibles.

Questions fréquentes

Q. Que veut dire « OCI runtime create failed: exec: "bash": executable file not found in $PATH: unknown » ?

Le conteneur a bien été créé, mais le programme que vous lui demandiez d'exécuter n'était pas dans son $PATH. Les images basées sur Alpine fournissent sh et pas bash : docker run -it myapp bash ou un CMD ["bash", ...] finit donc exactement sur cette erreur — comme tout outil que vous croyiez dans l'image alors qu'il n'existe que sur votre hôte. docker run --rm -it myapp sh vous donne un shell pour voir ce que l'image contient vraiment. S'il vous faut réellement bash, RUN apk add --no-cache bash dans le Dockerfile l'ajoute, au prix d'une image plus grosse.

Q. Comment le corriger ?

docker run --rm -it myapp sh — avant de le lancer, vérifiez plus haut ce que cette commande jette.

Q. Quel outil émet cela ?

runc. Cela relève de Docker, et le message compte 13 mots.

Erreurs voisines