マルチステージビルドとは?

「ビルドに必要なツールと、実際にアプリを動かすのに必要なものを分けたい」というときに使うのがマルチステージビルドです。1つのDockerfileの中に複数のFROMを書き、ビルド専用の環境と、実行専用の軽量な環境を分ける手法です。

FROM node AS builderのように名前を付けたステージでビルドを行い、最後のステージでCOPY --from=builderを使い、ビルド成果物だけを軽量な実行用イメージにコピーします。

たとえばNode.jsでビルドしたファイルを、最終的にはnginxの軽量イメージだけに含めることで、ビルドツール一式を含まない、必要最小限のイメージに仕上げられます。

よくあるつまずきは、マルチステージビルドを使わずに全てを1つのイメージに詰め込み、本番用イメージにビルドツールやソースコード一式まで残ってしまい、サイズが肥大化することです。

実務では本番環境向けのイメージを軽量かつセキュアに保つための標準的なテクニックとして、フロントエンド・バックエンド問わず広く使われています。