本番想定での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 登録は、本番運用では必須の設定と考えてください。