docker · Docker
メッセージ
COPY failed: file not found in build context or excluded by .dockerignore
何を意味するか
COPY はビルドコンテキストの中のものしか持ってこられず、その場所にそのファイルが無いという意味です。コンテキストは docker build の最後の引数なので、上の階層のファイルを ../x で指したか、.dockerignore がそのファイルを除いた場合がほとんどです — node_modules や *.env を除外しておいて、その中のファイルを COPY しようとするのが典型です。文言が二つの原因を併記するので、まず cat .dockerignore を読み、経路をコンテキストの根から書き直してください。コンテキストを広げて解決すると、そのフォルダ全体がデーモンへ送られ、ビルドが遅くなります。
直しかた
cat .dockerignore- 出す道具
- docker
- Docker
- 12
docker の誤りは、まずどの層で起きたかを分けないと読めません — クライアントがデーモンに届かない、レジストリが拒む、ビルド中に RUN が失敗する、コンテナが起動した途端に死ぬ、はそれぞれ別の問題です。とくにビルドと実行の層では文言そのものが理由ではなく、中で動いていた命令が残した出力に理由があり、直す命令の代償も層ごとに違います。
エラーメッセージの読み方
- 一行目から読みます。下に行くほど道具の内部の話で、原因はたいてい一番上に書かれています。
- ファイル名と行番号があればそこが出発点です — スタックの最上段ではなく、自分が書いたファイルが出てくる一番上の行です。
- 文句はそのまま検索します。ただし自分のパスや変数名は消します — その部分が検索を邪魔します。
- 同じ事情が道具の版ごとに違う言い方で出ます。結果が合わないときは版番号も入れてみます。
- 直す命令を貼る前に、その命令が何を捨てるかを確かめます。取り消せないものが混ざっています。
よくある質問
Q. COPY failed: file not found in build context or excluded by .dockerignore はどういう意味ですか。
COPY はビルドコンテキストの中のものしか持ってこられず、その場所にそのファイルが無いという意味です。コンテキストは docker build の最後の引数なので、上の階層のファイルを ../x で指したか、.dockerignore がそのファイルを除いた場合がほとんどです — node_modules や *.env を除外しておいて、その中のファイルを COPY しようとするのが典型です。文言が二つの原因を併記するので、まず cat .dockerignore を読み、経路をコンテキストの根から書き直してください。コンテキストを広げて解決すると、そのフォルダ全体がデーモンへ送られ、ビルドが遅くなります。
Q. どう直しますか。
cat .dockerignore — 実行する前に、この命令が何を捨てるかを上の説明で確かめてください。
Q. どの道具が出すエラーですか。
docker です。Dockerの仲間で、文句は12語です。