docker · Docker
メッセージ
exec /usr/local/bin/entrypoint.sh: exec format error
何を意味するか
カーネルがその実行ファイルのヘッダを認識できなかったという意味で、今ではほぼ必ずアーキテクチャの食い違いです — Apple Silicon で作った arm64 のイメージを amd64 のホストで動かした、あるいはその逆です。シェルスクリプトで一行目の #!/bin/sh が抜けている場合も同じ文言が出ます。docker build --platform=linux/amd64 で焼くのがよくある対処ですが、それは食い違いを消すのではなくエミュレーションで覆う手です — QEMU を通る実行は本来のアーキテクチャより数倍遅くなります。長く使うイメージなら、buildx で両方のアーキテクチャを焼くのが実行時に代償の無い道です。
直しかた
docker build --platform=linux/amd64 .- 出す道具
- docker
- Docker
- 12
docker の誤りは、まずどの層で起きたかを分けないと読めません — クライアントがデーモンに届かない、レジストリが拒む、ビルド中に RUN が失敗する、コンテナが起動した途端に死ぬ、はそれぞれ別の問題です。とくにビルドと実行の層では文言そのものが理由ではなく、中で動いていた命令が残した出力に理由があり、直す命令の代償も層ごとに違います。
エラーメッセージの読み方
- 一行目から読みます。下に行くほど道具の内部の話で、原因はたいてい一番上に書かれています。
- ファイル名と行番号があればそこが出発点です — スタックの最上段ではなく、自分が書いたファイルが出てくる一番上の行です。
- 文句はそのまま検索します。ただし自分のパスや変数名は消します — その部分が検索を邪魔します。
- 同じ事情が道具の版ごとに違う言い方で出ます。結果が合わないときは版番号も入れてみます。
- 直す命令を貼る前に、その命令が何を捨てるかを確かめます。取り消せないものが混ざっています。
よくある質問
Q. exec /usr/local/bin/entrypoint.sh: exec format error はどういう意味ですか。
カーネルがその実行ファイルのヘッダを認識できなかったという意味で、今ではほぼ必ずアーキテクチャの食い違いです — Apple Silicon で作った arm64 のイメージを amd64 のホストで動かした、あるいはその逆です。シェルスクリプトで一行目の #!/bin/sh が抜けている場合も同じ文言が出ます。docker build --platform=linux/amd64 で焼くのがよくある対処ですが、それは食い違いを消すのではなくエミュレーションで覆う手です — QEMU を通る実行は本来のアーキテクチャより数倍遅くなります。長く使うイメージなら、buildx で両方のアーキテクチャを焼くのが実行時に代償の無い道です。
Q. どう直しますか。
docker build --platform=linux/amd64 . — 実行する前に、この命令が何を捨てるかを上の説明で確かめてください。
Q. どの道具が出すエラーですか。
docker です。Dockerの仲間で、文句は5語です。