You run docker build を実行すると、Docker はビルドディレクトリ内のファイルである ビルドコンテキスト をデーモンに送信します。.dockerignore ファイルは、このコンテキストから不要なファイルを除外し、ビルドを高速化し、イメージサイズを削減し、機密ファイルの漏洩を防ぎます。
docker build -t myapp . # the "." is the build context — the directory sent to the daemon
ビルドコンテキスト は、Docker がイメージをビルドするためにデーモンに送信するファイルのセットです。ビルドディレクトリ内のすべてのファイルが除外されない限り含まれるため、肥大したコンテキストはビルドを遅くします。
# .dockerignore (like .gitignore, for the build context)
node_modules # don't send local deps (they're installed in the image anyway)
.git # don't send version history
*.log
.env # ⚠️ don't send SECRETS into the build context/image
Dockerfile
dist
.vscode
.dockerignore は .gitignore のように機能し、ビルドコンテキストからファイルを除外します。
✓ FASTER builds — a smaller context transfers faster; fewer files to process
(also helps caching: COPY . . won't be invalidated by irrelevant file changes)
✓ SMALLER images — excluded files (node_modules, .git) don't get COPYed into the image
✓ SECURITY — keep SECRETS (.env, keys, credentials) out of the context AND the image
(a COPY . . could otherwise copy a .env file into the image — a real leak risk)
ビルドコンテキストと .dockerignore を理解することは、効率的で安全な Docker ビルド のために価値のある、実践的な知識です。
多くの開発者は、docker build . がビルド前に ビルドコンテキスト全体をデーモンに送信する ことに気づいていません。そのため、肥大したコンテキスト（node_modules、.git、ビルド成果物、大きなファイルを含む）は ビルドのたびに遅くなり （転送とプロセスのデータが増加）、イメージに不要なファイルをコピーするリスクがあります。
.dockerignore ファイル（.gitignore と同様に機能）は、3つの具体的なメリットでこれに対応します。ビルドが高速化 される（より小さなコンテキストが高速に転送・処理され、また COPY . . が無関係なファイルの変更によって無効化されないため、レイヤーキャッシングも改善）、イメージサイズが削減 される（除外されたファイルはコピーされません。例えば、どうせ再インストールされるローカルの node_modules をバンドルしない）、そして重要なのが セキュリティ （.env ファイル、キー、認証情報などの秘密情報をビルドコンテキストとイメージから除外する — COPY . . でなければ .env がイメージにコピーされ、実際の一般的な認証情報漏洩リスクです）。
このセキュリティメリットは特に重要です。なぜなら、широすぎるコピーで秘密情報や機密ファイルをイメージに誤って焼き込むことは、.dockerignore が防ぐのに役立つ実際の過ちだからです。
ビルドは常に行われ、ビルド効率、イメージサイズ、秘密漏洩の防止はすべて重要であり、またビルドコンテキストと .dockerignore を理解して使うことでこれらすべてが直接改善されるため、ビルドコンテキストと .dockerignore を理解することは価値のある、実践的に関連性のある Docker 知識です。これは高速で無駄のない安全なビルドのためのシンプルだが重要な実践で、見落としやすいながらも意味のある影響があります。特にイメージへの秘密情報の誤った組み込みを防ぐのに有効です。