【ITニュース解説】"exec /entrypoint.sh: no such file or directory" (but the file is right there)
2026年10月28日に「Dev.to」が公開したITニュース「"exec /entrypoint.sh: no such file or directory" (but the file is right there)」について初心者にもわかりやすく解説しています。
ITニュース概要
Dockerコンテナ起動時に「no such file or directory」などのエラーが出る際、ファイルがあっても改行コード、実行権限、または指定シェル不足が原因の場合がある。改行コードをLFに修正し、実行権限を付与し、必要なシェルをイメージに追加すれば解決する。
ITニュース解説
システムエンジニアとしてキャリアをスタートさせる際、Dockerコンテナは非常に便利なツールである反面、初心者にとって思わぬところで躓きやすい落とし穴が潜んでいる。特に、「ファイルが存在するはずなのに、『ファイルが見つからない』というエラーでコンテナが起動しない」という状況は、多くの人が一度は経験するであろう混乱の元だ。この一見矛盾したエラーメッセージの裏には、いくつか典型的な原因が隠されている。ここでは、その代表的な三つのケースを掘り下げ、それぞれの原因と解決策を詳しく解説する。
まず一つ目の原因は、スクリプトの改行コードだ。特にWindows環境でスクリプトを作成し、それをLinuxベースのDockerコンテナで実行しようとすると、この問題に遭遇しやすい。Windowsのテキストファイルでは、行の終わりに「キャリッジリターン(\r)」と「ラインフィード(\n)」の二つの特殊文字(CRLF)が使われるのが一般的だ。一方、LinuxやUnix系のシステムでは、行の終わりには「ラインフィード(\n)」一つ(LF)だけが使われる。この改行コードの違いが、問題を引き起こすのだ。
Dockerコンテナ内でシェルスクリプトを実行する際、カーネル(OSの核となる部分)はスクリプトの最初の行、通称「shebang(シバン)」と呼ばれる「#!」で始まる部分を読み込み、どのプログラムでそのスクリプトを実行すべきかを判断する。例えば、「#!/bin/sh」と書かれていれば、/bin/shというシェルプログラムを使ってスクリプトを実行しようとする。しかし、もしスクリプトがCRLF形式で書かれていると、カーネルはshebangの行を「#!/bin/sh\r」と解釈してしまう。つまり、末尾に目には見えない\r(キャリッジリターン)が付いたプログラムを探しに行ってしまうのだ。当然、/bin/sh\rなどという名前のプログラムはコンテナ内には存在しないため、「ファイルが見つからない」というエラーが発生する。この時、「見つからない」と言われているのは、実はあなたの作ったスクリプトではなく、スクリプトを実行するための「インタープリタ(今回の場合はシェル)」の方なのである。
この問題を解決する方法はいくつかある。最も確実なのは、Gitの設定で.shファイルを常にLF形式でチェックアウトするように指定することだ。リポジトリのルートに.gitattributesファイルを作成し、「*.sh text eol=lf」と記述することで、Gitが自動的に改行コードを変換してくれる。また、すでにCRLF形式でチェックアウトしてしまったファイルは、VS Codeなどのエディタで改行コードをLFに変換できる。一時的な対策としては、Dockerfile内でsedコマンドを使い、ビルド時にCRLFをLFに置換してしまう方法もあるが、根本的な解決にはならないため、最初の二つの方法を推奨する。
二つ目の原因は、スクリプトに実行権限がないケースだ。LinuxなどのUnix系システムでは、ファイルには読み取り(r)、書き込み(w)、実行(x)という三種類の権限が設定されており、プログラムやスクリプトを実行するためには「実行(x)」権限が必要となる。Windowsのファイルシステムではこのような権限の概念が異なるため、Windows上で作成したスクリプトや、ZIPファイルなどから展開されたスクリプトには、しばしば実行権限が付与されていないことがある。
コンテナがスクリプトを実行しようとした際に実行権限がないと、「permission denied(許可されていない)」というエラーが発生する。このエラーメッセージは、デーモン(Dockerのバックグラウンドプロセス)から始まり、OCIランタイム、runcといった多くのレイヤーを経由して表示されるため、非常に長く複雑に見えるかもしれない。しかし、重要なのは一番最後の「exec: "/entrypoint.sh": permission denied」という部分だ。ここが、あなたのスクリプトの実行が許可されていないことを明確に示している。
この問題を解決する最も簡単な方法は、DockerfileのCOPYコマンドで、ファイルをコピーする際に実行権限を明示的に設定することだ。「COPY --chmod=755 entrypoint.sh /entrypoint.sh」のように記述すれば、755というパーミッション(所有者は読み書き実行、グループとその他のユーザーは読み取りと実行が可能)でファイルがコピーされ、実行権限が付与される。LinuxやmacOS環境でファイルを準備している場合は、ビルド前にchmod +x entrypoint.shコマンドを実行して実行権限を付与することもできる。Gitはファイルの実行権限も管理できるため、この変更はリポジトリにも反映される。
三つ目の原因は、スクリプトが指定するシェルがコンテナイメージ内に存在しない場合だ。先ほども触れたshebangは、スクリプトを実行するプログラムを指定する重要な役割を果たす。例えば、「#!/bin/bash」と書かれていれば、bashシェルを使ってスクリプトが実行されることを意味する。しかし、コンテナイメージ、特にAlpine Linuxのような軽量なイメージでは、デフォルトでbashシェルがインストールされておらず、より軽量なshシェル(BusyBox sh)が使われていることが多い。この状態でbashが必要なスクリプトを実行しようとすると、「executable file not found in $PATH(実行ファイルがPATHに見つからない)」というエラーが発生する。このエラーは、CMDで指定したプログラム名が間違っていたり、そもそもイメージにコピーされていなかったりする場合にも同様に発生する。
この問題の解決策は単純で、スクリプトが本当にbashを必要とするのであれば、イメージ内にbashをインストールすることだ。例えば、Alpine Linuxベースのイメージであれば、Dockerfileに「RUN apk add --no-cache bash」という行を追加してbashをインストールすればよい。また、もしスクリプトがbash特有の機能を使っていないのであれば、shebangを「#!/bin/sh」に変更し、shで実行できるように修正するのも一つの手だ。しかし、もしbash特有の構文を使っているのにshebangを#!/bin/shにすると、BusyBox shで実行され、さらに理解しにくい別のエラーで失敗する可能性があるので注意が必要だ。shebangは、実際にスクリプトが必要とするシェルと一致させるべきである。
これらのエラーは、一見すると「ファイルが見つからない」という同じようなメッセージに見えるかもしれないが、その根本原因は全く異なる。システムエンジニアを目指す初心者にとって、これらの問題を理解し、デバッグのスキルを身につけることは非常に重要だ。エラーメッセージの後半に注目し、od -cコマンドでファイルの内部を確認したり、ls -lで権限をチェックしたり、command -vでシェルが存在するか確認したりといった基本的なデバッグ手法が、問題解決の大きな助けとなるだろう。目の前のエラーメッセージが示す表面的な情報だけでなく、その背後にあるシステムやツールの挙動を深く理解しようとする姿勢が、技術者としての成長に繋がるのである。