Dockerを使ってイメージをビルドする際に、重要な概念の一つが「ビルドコンテキスト」です。Dockerfileだけでなく、コンテキストの設定次第でビルドの成功や効率性に大きく影響します。この記事では、ビルドコンテキストが何か、その仕組み、設定方法、そして効率的な使い方について解説します。
ビルドコンテキストとは？
ビルドコンテキスト（Build Context）とは、docker buildコマンドで指定したディレクトリやファイルの集合を指します。Dockerはイメージをビルドする際に、このビルドコンテキスト内のファイルにアクセスし、必要なファイルをコンテナ内にコピーしたり、Dockerfileの指示に従って処理を行います。
ビルドコンテキストの役割
- ファイルやディレクトリを含む: Dockerfileで指定されたファイル（たとえば、
COPY命令やADD命令で参照されるファイル）は、ビルドコンテキストに含まれていなければなりません。 - 送信されるデータ: ビルドプロセスが開始されると、ビルドコンテキスト内の全ファイルがDockerデーモンに送信されます。大きなコンテキストはビルド時間を遅らせる原因になるため、効率的に構成することが大切です。
ビルドコンテキストの指定方法
docker buildコマンドを使ってイメージをビルドする際、ビルドコンテキストはコマンドの最後に指定します。通常は、現在のディレクトリをビルドコンテキストに指定することが一般的です。
docker build -t my-app .
上記の例では、現在のディレクトリ（.）がビルドコンテキストとして使用されます。このディレクトリ内のファイルがDockerデーモンに送信され、Dockerfileの内容に基づいてビルドが進行します。
-tオプションは、タグ (tag) を指定するためのものです。my-app はそのタグ（＝イメージ名）にあたります。
ビルドコンテキストとDockerfileの関係
Dockerfile内でファイルを参照する際（COPYやADD命令）、そのファイルがビルドコンテキスト内に存在している必要があります。ビルドコンテキスト外のファイルはDockerfileからアクセスできないため、注意が必要です。
例: COPY命令
COPY ./src /app/src
このCOPY命令では、./srcディレクトリをコンテナ内の/app/srcにコピーしていますが、./srcディレクトリがビルドコンテキスト内に存在していなければなりません。もしビルドコンテキスト外のディレクトリを指定した場合、Dockerはエラーを返します。
効率的なビルドコンテキストの管理方法
ビルドコンテキストに含まれるファイルのサイズが大きくなると、ビルドが遅くなるだけでなく、無駄なデータが含まれるリスクも高まります。効率的にビルドコンテキストを管理するためのいくつかの方法を紹介します。
.dockerignoreファイルを使う
.dockerignoreファイルを使うことで、ビルドコンテキストに含めたくないファイルやディレクトリを指定できます。Gitの.gitignoreファイルと似た構文で、不要なファイルを除外することができます。
例: .dockerignore
node_modules
.git
*.log
この例では、node_modulesディレクトリ、.gitディレクトリ、すべての.logファイルがビルドコンテキストから除外されます。
必要最小限のファイルを含める
Dockerfileで使用するファイルだけをビルドコンテキストに含めるようにしましょう。アプリケーションの実行に必要のないドキュメントや開発用ファイル（例: テスト用ファイルや設定ファイル）は、コンテキストから除外することができます。
適切なディレクトリをビルドコンテキストに設定する
コンテキスト全体が大きすぎる場合、ビルドプロセスに必要なサブディレクトリだけをビルドコンテキストとして指定することもできます。たとえば、アプリケーションのソースコードだけが格納されたappディレクトリをビルドコンテキストに設定する場合は次のようにします。
docker build -t my-app ./app
これにより、不要なファイルやディレクトリをビルドコンテキストに含めることなく、効率的なビルドが可能です。
ビルドコンテキストを意識したDockerfileの設計
ビルドコンテキストを効率化するために、Dockerfileの設計にも工夫が必要です。以下の点に留意しましょう。
最小限のファイルコピー
COPYやADD命令を使用する際には、最小限のディレクトリやファイルだけをコンテナにコピーするようにします。必要なファイルだけをまとめたディレクトリ構成を作ると良いでしょう。
COPY ./app /app
キャッシュを有効活用
RUN命令などはキャッシュが利用されるため、頻繁に変更される部分（例: アプリケーションのソースコード）はDockerfileの後半に記述し、依存関係のインストールなどは先に実行すると、効率的なビルドが可能です。
まとめ
ビルドコンテキストはDockerのイメージビルドの基本的な概念ですが、コンテキストのサイズや構成がビルド効率に大きく影響します。.dockerignoreファイルを使った不要ファイルの除外や、必要最小限のファイルをコンテキストに含めることがポイントです。
