.dockerignoreとは?

「node_modulesのような不要なファイルまでイメージに含まれてしまう」という悩みを解決するのが.dockerignoreです。docker build実行時に、イメージへコピーしたくないファイル・フォルダを指定する設定ファイルです。

Dockerfileと同じ場所に.dockerignoreというファイルを作り、除外したいパスを1行ずつ書きます。書き方は.gitignoreとよく似ています。

node_modulesや.gitを.dockerignoreに書いておくと、COPY . .を実行してもそれらのフォルダはイメージにコピーされず、イメージサイズを小さく保てます。

よくあるつまずきは、.dockerignoreを作らずに開発を進め、後から「イメージが異常に大きい」ことに気づいて対応が後手に回ることです。プロジェクトの最初から用意しておくのが望ましいです。

実務ではビルド時間の短縮、イメージサイズの削減、機密情報(.envファイルなど)の混入防止のために、ほぼ全てのプロジェクトで用意されます。