runc · Docker
Die Meldung
OCI runtime create failed: exec: "bash": executable file not found in $PATH: unknown
Was es bedeutet
Der Container wurde erstellt, aber das Programm, das er ausführen sollte, war darin nicht im $PATH. Alpine-basierte Images bringen sh und kein bash mit, deshalb endet docker run -it myapp bash oder ein CMD ["bash", ...] genau in diesem Fehler — ebenso jedes Werkzeug, das Sie im Image vermuteten und das nur auf dem Host existiert. docker run --rm -it myapp sh gibt Ihnen eine Shell, um zu sehen, was das Image wirklich enthält. Brauchen Sie wirklich bash, fügt RUN apk add --no-cache bash im Dockerfile es hinzu — um den Preis eines größeren Images.
Die Lösung
docker run --rm -it myapp sh- Ausgegeben von
- runc
- Docker
- 12
Docker-Fehler werden erst lesbar, wenn man sie einer Schicht zuordnet — der Client erreicht den Daemon nicht, die Registry verweigert, ein RUN scheitert im Build, ein Container stirbt sofort beim Start: das sind vier verschiedene Probleme — und in der Build- und Laufzeitschicht ist die Zeile selbst nicht der Grund: der Grund steht in der Ausgabe des Befehls, der darin lief, und auch der Preis jeder Behebung unterscheidet sich je Schicht.
Eine Fehlermeldung lesen
- Von der ersten Zeile abwärts lesen. Weiter unten geht es um das Innere des Werkzeugs; die Ursache steht meist oben.
- Gibt es Datei und Zeilennummer, dort anfangen — nicht der oberste Stack-Frame, sondern die oberste Zeile, die eine eigene Datei nennt.
- Die Meldung wörtlich suchen, vorher aber eigene Pfade und Variablennamen entfernen; genau die verhindern den Treffer.
- Dieselbe Lage wird je Werkzeugversion anders formuliert. Passen die Treffer nicht, die Versionsnummer mit in die Suche.
- Vor dem Einfügen einer Lösung prüfen, was sie verwirft. Manches davon lässt sich nicht zurückholen.
Häufige Fragen
Q. Was bedeutet „OCI runtime create failed: exec: "bash": executable file not found in $PATH: unknown“?
Der Container wurde erstellt, aber das Programm, das er ausführen sollte, war darin nicht im $PATH. Alpine-basierte Images bringen sh und kein bash mit, deshalb endet docker run -it myapp bash oder ein CMD ["bash", ...] genau in diesem Fehler — ebenso jedes Werkzeug, das Sie im Image vermuteten und das nur auf dem Host existiert. docker run --rm -it myapp sh gibt Ihnen eine Shell, um zu sehen, was das Image wirklich enthält. Brauchen Sie wirklich bash, fügt RUN apk add --no-cache bash im Dockerfile es hinzu — um den Preis eines größeren Images.
Q. Wie behebe ich das?
docker run --rm -it myapp sh — vor dem Ausführen oben prüfen, was dieser Befehl verwirft.
Q. Welches Werkzeug gibt das aus?
runc. Es gehört zu Docker, und die Meldung hat 13 Wörter.