本番想定でのDockerfileの工夫
ここまでで、マルチステージビルドを使って最終イメージから不要なビルドツールを取り除き、軽量化する方法を学びました。本番運用を意識すると、これに加えてDockerfileに盛り込んでおきたい工夫がいくつかあります。ここでは代表的な3つを紹介します。
1. 軽量なベースイメージの選定
マルチステージビルドで最終イメージから不要なツールを除いても、ベースイメージ自体に不要なファイルが多く含まれていると、イメージはなかなか小さくなりません。そこで、ベースイメージを選ぶ段階から軽量なものを意識する、というのが本番想定の工夫の1つ目です。
公式イメージには、用途に応じていくつかのバリエーションが用意されていることが多く、Pythonの場合は次のような種類があります。
| イメージ | 特徴 |
|---|---|
python:3.13 |
標準イメージ。Debianベースで、開発に必要なツールが一通り含まれる。サイズは大きめ |
python:3.13-slim |
標準イメージから不要なパッケージを削った軽量版。多くのアプリケーションでまず候補になる |
python:3.13-alpine |
Alpine Linuxベースで非常に軽量。ただしOSのライブラリ(musl libc)が標準的なものと異なるため、依存ライブラリのビルドで問題が出ることがある |
gcr.io/distroless/python3 |
アプリケーション実行に必要な最小構成だけのイメージ。シェルすら含まれず、攻撃面が最小化される |
迷ったら、まず -slim を選ぶと失敗が少ないです。よりサイズや攻撃面を絞りたい場合は distroless を検討する、という選び方が一般的です。各バリエーションの詳細はPython公式イメージ(Docker Hub)、distrolessはGoogleContainerTools/distroless(GitHub)に記載があります。
たとえば、これまで FROM python:3.13 と書いていた箇所を、以下のように書き換えるだけでイメージサイズを大きく削減できます。
FROM python:3.13-slim
2. 実行ユーザの非rootユーザへの切り替え
Dockerコンテナは、デフォルトでは root ユーザでアプリケーションが実行されます。動かすだけなら問題なく動きますが、本番運用ではこれを 一般ユーザ(非rootユーザ)に切り替えておく のがセオリーです。
理由は、アプリケーションに脆弱性が見つかったときの被害を小さく抑えるためです。コンテナ内が root のままだと、攻撃者が任意のコマンドを実行できる脆弱性を突いた際に、システムファイルを書き換えたりパッケージをインストールしたりといった広い操作が可能になってしまいます。一般ユーザで動かしておけば、そのユーザの権限の範囲内に被害を抑え込めます。Docker公式のBuilding best practicesでも「If a service can run without privileges, use USER to change to a non-root user.」と明記されており、特権が不要なサービスはUSER命令で非rootユーザに切り替えることが推奨されています。
Dockerfileで実行ユーザを切り替えるには、USER 命令を使います。一般的な書き方は次のとおりです。
RUN useradd -m appuser
USER appuser
RUN useradd -m appuser で appuser という一般ユーザを作成し、USER appuser でそれ以降の命令とコンテナ起動時の実行ユーザを appuser に切り替えています。USER 命令は、依存関係のインストールなどrootでないと実行できない処理が終わった Dockerfileの末尾近くに書く のがポイントです。
正しく切り替わっているかは、コンテナを起動した状態で次のコマンドを実行して確認できます。
docker container exec <コンテナ名> whoami
以下のような実行結果が表示されます。
appuser
appuser と表示されれば、コンテナ内のプロセスが非rootユーザで動いていることを確認できます。
| 💡 ポイント |
|---|
| 非rootユーザで動くコンテナは、Linuxの仕様上 1024未満のポート(80・443など)をbindできません。本番でHTTPS(443)やHTTP(80)で待ち受けたい場合は、コンテナ自身は8000・8080などの番号で待ち受け、外向きの80・443はALB(ロードバランサー)で終端する、という構成を取るのが一般的です。 |
3. .dockerignoreによる不要ファイルの除外
docker build を実行すると、Dockerはまずビルドを実行する作業フォルダ(ビルドコンテキスト)の中身をすべてDockerデーモンに送信します。このとき、ビルドに不要なファイルまで送信されると、ビルドが遅くなったり、本来含めたくないファイル(.git 内の履歴、.env の機密情報など)がイメージに紛れ込むリスクがあります。
これを防ぐために使用するのが .dockerignore ファイルです。.dockerignore を作業フォルダの直下に置き、除外したいファイルやフォルダを記述しておくと、docker build 時にそれらは送信されなくなります。
書き方は .gitignore と同じ感覚で、1行に1パターンずつ記述します。
.git
.env
__pycache__/
*.log
node_modules/
.vscode/
それぞれの行の意味は次のとおりです。
.git— Gitの履歴フォルダ。コンテナ内では不要.env— 機密情報を含む環境変数ファイル。イメージに含めてはいけない__pycache__/— Pythonのキャッシュフォルダ*.log— ログファイル全般node_modules/— Node.jsの依存ライブラリ。コンテナ内で改めてインストールするため不要.vscode/— エディタ設定。コンテナ実行には不要
.dockerignore を置いた状態で docker build を実行すると、これらのファイルがビルドコンテキストから除外され、ビルドが高速化し、イメージにも含まれなくなります。
📝 .env を .dockerignore に書き忘れた場合のリスク |
|---|
.env には、データベースのパスワードやAPIキーなどの機密情報が書かれていることが多くあります。これを .dockerignore に書き忘れたままイメージをビルドし、ECRなどの公開リポジトリにPushすると、誰でも docker pull してイメージから機密情報を取り出せる状態になってしまいます。.env の .dockerignore 登録は、本番運用では必須の設定と考えてください。 |