ビルドコンテキストとは何か、また .dockerignore ファイルを使う理由は何か？

Question

IT Interview Practice · Accepted Answer

You run `docker build` を実行すると、Docker はビルドディレクトリ内のファイルである **ビルドコンテキスト** をデーモンに送信します。**.dockerignore** ファイルは、このコンテキストから不要なファイルを除外し、ビルドを高速化し、イメージサイズを削減し、機密ファイルの漏洩を防ぎます。

## ビルドコンテキスト

```bash
docker build -t myapp .     # the "." is the build context — the directory sent to the daemon
# → Docker tarballs the ENTIRE context directory and sends it to the daemon BEFORE building
# → a big context (node_modules, .git, large files) = slow builds, more data transferred
```

**ビルドコンテキスト** は、Docker がイメージをビルドするためにデーモンに送信するファイルのセットです。ビルドディレクトリ内のすべてのファイルが除外されない限り含まれるため、肥大したコンテキストはビルドを遅くします。

## .dockerignore — 不要なファイルを除外する

```text
# .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` のように機能し、ビルドコンテキストからファイルを除外します。

## なぜ重要なのか（3つのメリット）

```text
✓ 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 知識です。これは高速で無駄のない安全なビルドのためのシンプルだが重要な実践で、見落としやすいながらも意味のある影響があります。特にイメージへの秘密情報の誤った組み込みを防ぐのに有効です。

ビルドコンテキスト

.dockerignore — 不要なファイルを除外する

なぜ重要なのか（3つのメリット）

なぜ重要なのか

関連する質問