.dockerignore完全ガイド｜書き方・推奨テンプレ・ビルド高速化と情報漏洩の防止

「docker build の最初に “Sending build context to Docker daemon 800MB” と出て数十秒待たされる」「.git や .env が本番イメージに混入していた」——これらの問題はすべて .dockerignore で解決します。

.dockerignore は .gitignore と似た仕組みで、ビルドコンテキストから除外するファイルを指定するものです。地味ですが、ビルド高速化・イメージ軽量化・情報漏洩防止の3つの効果があります。この記事では書き方から言語別テンプレートまで解説します。

目次

1. そもそも「ビルドコンテキスト」とは
2. .dockerignore が必要な3つの理由
3. 基本構文と除外パターンの書き方
4. 推奨テンプレート（全プロジェクト共通）
5. 言語別テンプレ① Node.js
6. 言語別テンプレ② Python
7. 言語別テンプレ③ Go
8. 除外されているか確認する方法
9. よくあるミスと注意点
10. まとめ

1. そもそも「ビルドコンテキスト」とは

docker build -t myapp . の最後の .（ドット）は「カレントディレクトリ」を指しています。この指定されたディレクトリ全体を、Dockerはビルド開始時に Dockerデーモンに送信します。これを ビルドコンテキストと呼びます。

2. .dockerignore が必要な3つの理由

理由① ビルド時間の短縮

コンテキストが大きいと、ビルドの開始前から時間を消費します。

理由② イメージサイズの削減とレイヤーキャッシュの安定化

COPY . . のようにディレクトリ全体をコピーすると、本番に不要なファイルも一緒にイメージに入ります。さらに、不要ファイル（例：logs/access.log）が毎回更新されると、COPYレイヤーのキャッシュが毎回壊れる問題も起こります。

理由③ 機密情報の混入防止

最も深刻なリスクです。.env、.aws/credentials、id_rsa などが本番イメージに混入→レジストリに pushされると情報漏洩に直結します。

3. 基本構文と除外パターンの書き方

.dockerignore は Dockerfileと同じ階層に置きます。構文は .gitignore とほぼ同じです。

# コメント（# で始まる行）
 
 # 特定ファイル
 .env
 secret.key
 
 # 拡張子で除外
 *.log
 *.tmp
 
 # ディレクトリ全体
 node_modules/
 .git/
 dist/
 
 # ワイルドカード（サブディレクトリ以下すべて）
 **/*.log
 **/__pycache__
 
 # 除外の除外（! で上書き）
 *.md
 !README.md
 # → .md は全て除外するが、README.md だけは含める

主なパターン構文

4. 推奨テンプレート（全プロジェクト共通）

言語に関わらず、ほぼすべてのプロジェクトで除外すべきものです。まずこれをベースに、言語固有のものを追加していきます。

# ============================================
 # 全プロジェクト共通の .dockerignore テンプレ
 # ============================================
 
 # Git関連（最重要）
 .git/
 .gitignore
 .gitattributes
 
 # Docker自体のファイル
 Dockerfile
 docker-compose.yml
 docker-compose.*.yml
 .dockerignore
 
 # 環境変数・秘密情報（最重要）
 .env
 .env.*
 *.pem
 *.key
 id_rsa
 .aws/
 .ssh/
 
 # IDE・エディタ
 .vscode/
 .idea/
 *.swp
 *.swo
 .DS_Store
 Thumbs.db
 
 # ログ・一時ファイル
 *.log
 logs/
 tmp/
 temp/
 
 # テスト・カバレッジ
 coverage/
 .nyc_output/
 htmlcov/
 .pytest_cache/
 
 # ドキュメント・CI設定
 README.md
 LICENSE
 CHANGELOG.md
 .github/
 .gitlab-ci.yml
 .circleci/
 
 # テスト用ディレクトリ
 test/
 tests/
 __tests__/
 *.test.js
 *.spec.ts

5. 言語別テンプレ① Node.js

# === 共通テンプレをベースに追加 ===
 
 # Node.js の依存（イメージ内で npm install するため）
 node_modules/
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 .pnpm-debug.log*
 
 # ビルド成果物（マルチステージで再生成するため）
 dist/
 build/
 .next/
 .nuxt/
 out/
 
 # パッケージマネージャのキャッシュ
 .npm/
 .yarn/
 .pnpm-store/
 
 # TypeScript 関連
 *.tsbuildinfo
 
 # Next.js・Nuxt
 .next/cache
 .nuxt/cache
 
 # テスト
 coverage/
 .nyc_output/

6. 言語別テンプレ② Python

# === 共通テンプレをベースに追加 ===
 
 # Python キャッシュ
 __pycache__/
 *.py[cod]
 *$py.class
 *.so
 
 # 仮想環境（イメージ内でpip installするため）
 venv/
 .venv/
 env/
 ENV/
 
 # 配布・ビルド
 build/
 dist/
 *.egg-info/
 .eggs/
 
 # テスト・カバレッジ
 .pytest_cache/
 .coverage
 .coverage.*
 htmlcov/
 .tox/
 
 # Jupyter
 .ipynb_checkpoints/
 
 # mypy・ruff
 .mypy_cache/
 .ruff_cache/
 
 # Django・Flask
 *.sqlite3
 *.db
 media/
 staticfiles/
 
 # poetry
 poetry.lock
 # ^ 本番ビルド時は含めるべきなので、プロジェクトによって判断

7. 言語別テンプレ③ Go

# === 共通テンプレをベースに追加 ===
 
 # ビルド成果物
 bin/
 dist/
 
 # テスト
 *.test
 *.out
 coverage.txt
 
 # Go モジュールキャッシュ（ローカル）
 vendor/
 # ^ vendoring してる場合はコメントアウト
 
 # ベンダリング済みの場合は逆に必要
 # !vendor/
 
 # デバッガ
 debug
 __debug_bin*

8. 除外されているか確認する方法

方法① ビルド時のメッセージを見る

docker build 実行時、最初に「Sending build context to Docker daemon XX MB」と表示されます（BuildKit だと別の表示）。サイズが想定より大きければ .dockerignore が効いていません。

方法② BuildKit の出力で確認

$ docker build -t myapp .
 [+] Building 2.3s
  => [internal] load build definition from Dockerfile 0.0s
  => [internal] load .dockerignore 0.0s
  => => transferring context: 1.2kB ← ここを確認
  => [internal] load metadata for docker.io/library/... 0.4s

transferring context のサイズが、実際に送信されたコンテキストの大きさです。

方法③ コンテキストに何が入っているか実ファイルで確認

# ダミー Dockerfile でコンテキストの中身を丸ごと確認
 cat << 'EOF' > Dockerfile.inspect
 FROM alpine
 COPY . /context
 CMD ["sh"]
 EOF
 
 docker build -f Dockerfile.inspect -t inspect .
 docker run --rm inspect ls -la /context

これで、Docker が実際に受け取っているファイル一覧を確認できます。.env や node_modules が含まれていたら .dockerignore を見直しましょう。

9. よくあるミスと注意点

# すべて除外
 *
 # ただし以下は含める
 !src/
 !package.json
 !Dockerfile

10. まとめ

.dockerignore は「たかがignoreファイル」ですが、ビルド速度・イメージ品質・セキュリティの3つに直接効く、Docker運用の必須ファイルです。

参考リンク

• .dockerignore files（Docker公式） — 構文とビルドコンテキストの公式仕様。
• github/gitignore — 言語別の .gitignore テンプレート集。.dockerignore のベースとして流用できる。
• Build context（Docker公式） — ビルドコンテキストの詳細仕様。

Dockerの基礎を動画で体系的に学びませんか？

実務で使う基礎だけを3時間に凝縮。環境構築から丁寧に解説しています。

クーポン割引で講座を見る →