マルチステージビルドの定義方法

マルチステージビルドにおけるビルドステージと実行ステージの関係を以下に示します。

マルチステージビルドを行うには、1つのDockerfileの中に FROM 命令を複数回記述します。Docker公式のMulti-stage buildsでも「With multi-stage builds, you use multiple FROM statements in your Dockerfile. Each FROM instruction can use a different base, and each of them begins a new stage of the build.」と説明されています。

それぞれの FROM が新しいステージ(段階)の始まりを意味します。また、特定のステージに名前をつけることで、後のステージから参照しやすくします。

つまり「FROMの命令の数だけ、複数のステージを用意できる」というものです。

なお、実際にイメージに含まれるのは「最後のステージ(FROM)に含まれる内容」のみとなります。そのため、他のステージで使用したファイルやツールは、実際のイメージには含まれません。

実際の定義方法を見ていきます。

# 第1ステージ:ビルド用(名前を 'builder' とする)
FROM <イメージA> AS builder
# ...ここでビルド処理を行う...

# 第2ステージ:実行用(ここが最終的なイメージになる)
FROM <イメージB>
# ...必要なものだけをコピーして起動...

FROMを2つ記載し、1つ目はビルド用、2つ目は実行用として使用します。 1つ目のFROMには、AS builder という記述で、ステージにbuilderという名前をつけています。 これ自体がなくてもマルチステージビルドは定義できますが、2つ目のステージにファイルを受け渡す際に、名前があった方が「どこからコピーするか」を明確に指定できるため、このように名前をつけるのが一般的です。

1. ファイルの受け渡し(COPY --from)

ステージを跨いでファイルの受け渡しを行う方法を説明します。

まず重要な点として、異なるステージ間のファイルは自動的には引き継がれません。 そのため、ビルド用のステージで作成した成果物(実行ファイルなど)を、実行用のステージへ明示的にコピーする必要があります。

COPYコマンドに、以下のように --from=ステージ名 を記述することで、別のステージにあるファイルをコピーしてくることができます。

COPY --from=builder /app/main /app/main

この記述は、「builderステージにある /app/main というファイル(コピー元)」を、「現在の実行ステージの /app/main (コピー先)」にコピーする、という意味になります。 これにより、ビルド用ステージで作られた成果物だけを、最終的なイメージに取り込むことができます。