runc · Docker
メッセージ
OCI runtime create failed: exec: "bash": executable file not found in $PATH: unknown
何を意味するか
コンテナは作られたが、その中で実行するよう頼んだプログラムが $PATH に見つからなかったという意味です。alpine 系のイメージには bash が無く sh だけなので、docker run -it myapp bash や CMD ["bash", ...] はまさにこの誤りで終わります — コンテナの中にあると思っていた道具が実はホストにしか無い場合も同じです。docker run --rm -it myapp sh で入ってみれば、そのイメージに何があるのかすぐ分かります。どうしても bash が必要なら Dockerfile に RUN apk add --no-cache bash を入れられますが、イメージが大きくなる代償が付きます。
直しかた
docker run --rm -it myapp sh- 出す道具
- runc
- Docker
- 12
docker の誤りは、まずどの層で起きたかを分けないと読めません — クライアントがデーモンに届かない、レジストリが拒む、ビルド中に RUN が失敗する、コンテナが起動した途端に死ぬ、はそれぞれ別の問題です。とくにビルドと実行の層では文言そのものが理由ではなく、中で動いていた命令が残した出力に理由があり、直す命令の代償も層ごとに違います。
エラーメッセージの読み方
- 一行目から読みます。下に行くほど道具の内部の話で、原因はたいてい一番上に書かれています。
- ファイル名と行番号があればそこが出発点です — スタックの最上段ではなく、自分が書いたファイルが出てくる一番上の行です。
- 文句はそのまま検索します。ただし自分のパスや変数名は消します — その部分が検索を邪魔します。
- 同じ事情が道具の版ごとに違う言い方で出ます。結果が合わないときは版番号も入れてみます。
- 直す命令を貼る前に、その命令が何を捨てるかを確かめます。取り消せないものが混ざっています。
よくある質問
Q. OCI runtime create failed: exec: "bash": executable file not found in $PATH: unknown はどういう意味ですか。
コンテナは作られたが、その中で実行するよう頼んだプログラムが $PATH に見つからなかったという意味です。alpine 系のイメージには bash が無く sh だけなので、docker run -it myapp bash や CMD ["bash", ...] はまさにこの誤りで終わります — コンテナの中にあると思っていた道具が実はホストにしか無い場合も同じです。docker run --rm -it myapp sh で入ってみれば、そのイメージに何があるのかすぐ分かります。どうしても bash が必要なら Dockerfile に RUN apk add --no-cache bash を入れられますが、イメージが大きくなる代償が付きます。
Q. どう直しますか。
docker run --rm -it myapp sh — 実行する前に、この命令が何を捨てるかを上の説明で確かめてください。
Q. どの道具が出すエラーですか。
runc です。Dockerの仲間で、文句は13語です。