第4章 Dockerfileとイメージの管理

LPIC-3 305(352.3)相当

Docker Hubのイメージをそのまま使うだけでなく、自分のアプリケーションや設定を組み込んだイメージを作れるようになると、Dockerの使いどころが一気に広がります。この章では、Dockerfileの書き方と、イメージの管理方法を扱います。

イメージとレイヤー

イメージは、コンテナを起動するためのファイルシステムと設定をまとめたものです。イメージは、読み取り専用のレイヤーを積み重ねた構造になっており、コンテナを起動すると、その上に書き込み用の薄いレイヤーが1枚追加されます。コンテナの中でファイルを変更しても、元のイメージは変わりません。同じイメージから作ったコンテナ同士は、下のレイヤーを共有するため、ディスクの使用量も抑えられます。

イメージ名は「レジストリ/名前空間/リポジトリ:タグ」の形で表します。nginxとだけ書いた場合は、docker.io/library/nginx:latest(Docker Hubの公式イメージの、latestタグ)と解釈されます。

$ sudo docker pull ubuntu:24.04
24.04: Pulling from library/ubuntu
be5c99fb8eee: Pull complete
Digest: sha256:7ef609ac6535c31f3d76e5bcb0169e520a7120fddd3a5804b1e45dba2efb3960
Status: Downloaded newer image for ubuntu:24.04
docker.io/library/ubuntu:24.04
注意:
latestは「最新版」を保証する名前ではなく、タグを省略したときに使われる既定の名前にすぎません。
同じlatestでも、取得した時期によって中身が変わります。
本番環境では、nginx:1.27のようにバージョンを明示するか、ダイジェスト(@sha256:…)で固定しましょう。

Dockerfileの主な命令

Dockerfileは、イメージの作り方を、上から順に実行される命令として書いたテキストファイルです。

命令意味
FROM土台にするイメージを指定する(最初に書く)
RUNイメージを作る途中でコマンドを実行する(パッケージの導入など)
COPYビルドコンテキストのファイルを、イメージの中にコピーする
ADDCOPYの機能に加え、URLからの取得や、tarアーカイブの自動展開ができる
CMDコンテナ起動時に実行する、既定のコマンド(引数)
ENTRYPOINTコンテナ起動時に必ず実行するコマンド
ENV環境変数を設定する
WORKDIR以降の命令と、コンテナでの作業ディレクトリを指定する
EXPOSEコンテナが待ち受けるポートを記録する(公開はしない)
USER以降の命令とコンテナを実行するユーザーを指定する
VOLUMEデータを置く場所を、ボリュームとして扱うよう指定する
ARGビルド時だけ使う変数を定義する(--build-argで値を渡す)

イメージを作る:docker build

静的なWebページを組み込んだ、nginxのイメージを作ってみましょう。ディレクトリにindex.htmlと、次のDockerfileを置きます。

Dockerfile
FROM nginx
COPY index.html /usr/share/nginx/html/

docker buildの-tで名前とタグを付け、最後にビルドコンテキスト(Dockerfileやコピーするファイルがあるディレクトリ)を指定します。カレントディレクトリなら.です。

$ sudo docker build -t mysite:1.0 .
$ sudo docker images
REPOSITORY   TAG      IMAGE ID       CREATED                  SIZE
mysite       1.0      1b857a826762   Less than a second ago   192MB
nginx        latest   39781286c939   2 weeks ago              192MB
$ sudo docker run -d -p 8080:80 mysite:1.0
$ curl http://localhost:8080

ビルドコンテキストの中身は、すべてdockerdに送られます。ログや.gitなど、イメージに不要なファイルは、.dockerignoreというファイルに書いて除外します。

docker historyで、レイヤーを確認する

docker historyは、イメージがどの命令から作られたかを、新しいレイヤーから順に表示します。次は、alpineをベースにcurlを導入し、スクリプトを組み込んだイメージ(myapp:1.0)の例です。

Dockerfile
FROM alpine
RUN apk add --no-cache curl
COPY app.sh /app.sh
CMD ["/app.sh"]
$ sudo docker build -t myapp:1.0 .
$ sudo docker history myapp:1.0
IMAGE          CREATED                  CREATED BY                                        SIZE     COMMENT
dc46c3d4206a   Less than a second ago   CMD ["/app.sh"]                                   0B       buildkit.dockerfile.v0
<missing>      Less than a second ago   COPY app.sh /app.sh                               1.02kB   buildkit.dockerfile.v0
<missing>      Less than a second ago   RUN /bin/sh -c apk add --no-cache curl            12.6MB   buildkit.dockerfile.v0
<missing>      4 weeks ago              CMD ["/bin/sh"]                                   0B       buildkit.dockerfile.v0

ファイルを変更するRUN・COPY・ADDは、サイズを持つレイヤーを作ります。CMDなどは設定だけを記録するため、0Bです。

CMDとENTRYPOINTの違い

どちらもコンテナ起動時に実行されるものですが、docker run イメージ 引数のように引数を渡したときの扱いが異なります。

  • CMDだけの場合:渡した引数で、CMD全体が置き換えられます。
  • ENTRYPOINTがある場合:ENTRYPOINTは必ず実行され、渡した引数(指定しなければCMDの内容)が、その引数として付け加えられます。
Dockerfile
FROM ubuntu:24.04
RUN apt-get update && apt-get install -y curl
ENTRYPOINT ["curl"]
CMD ["--help"]

このイメージをdocker run mycurlで起動するとcurl --helpが、docker run mycurl -I https://example.comで起動するとcurl -I https://example.comが実行されます。命令は["curl"]のような配列の形(exec形式)で書くのが基本です。CMD curl --helpのような書き方(シェル形式)では/bin/sh -c経由で実行されるため、停止のシグナルがアプリケーションに直接届かないことがあります。

イメージを小さく、安全に保つ書き方

  • RUNをまとめる:apt-get updateとapt-get installは、&&でつないで1つのRUNに書き、最後にrm -rf /var/lib/apt/lists/*でキャッシュを消します。別のRUNに分けると、古いパッケージ一覧が残ったレイヤーがキャッシュされ、意図しない版が入る原因になります。
  • 変更の少ない命令を先に書く:ビルドは、変更のあった命令以降だけをやり直します。依存パッケージの導入を先に、頻繁に変わるソースコードのCOPYを後に書くと、ビルドが速くなります。
  • マルチステージビルド:FROM golang:1.23 AS buildでビルドし、FROM alpineの段階にCOPY --from=buildで成果物だけをコピーすると、コンパイラを含まない小さなイメージにできます。
  • rootで動かさない:USERで一般ユーザーを指定すると、万一コンテナが乗っ取られたときの被害を小さくできます。
  • 秘密情報を入れない:パスワードやキーをCOPYやENVで埋め込むと、docker historyやイメージの中身から読み取れてしまいます。

イメージの受け渡し:tag・push・save・load

コマンド用途
docker tag 元 新しい名前同じイメージに別の名前・タグを付ける(レジストリへの送信前など)
docker push 名前レジストリへ送信する(事前にdocker loginが必要)
docker save -o ファイル イメージイメージをtar形式のファイルに書き出す
docker load -i ファイルsaveで書き出したファイルから、イメージを読み込む
docker rmi イメージイメージを削除する
$ sudo docker save -o myapp.tar myapp:1.0
$ sudo docker rmi myapp:1.0
$ sudo docker load -i myapp.tar
Loaded image: myapp:1.0

インターネットに接続できない環境へイメージを持ち込むときは、saveとloadが便利です。なお、docker export・docker importはコンテナのファイルシステムだけを扱い、レイヤーの履歴やCMDなどの設定は失われる点がsave・loadと異なります。

よくある間違い:
起動中のコンテナで作業した結果をdocker commitでイメージにすることもできます。
ただし、どんな手順で作ったのかが記録に残らず、同じイメージを作り直せません。
検証の途中経過を残すような場面に限り、通常はDockerfileで管理するのが基本です。

この章のまとめ

イメージは読み取り専用のレイヤーの積み重ねで、Dockerfileの命令がそのままレイヤーになります。docker buildで作り、docker historyで中身を確かめ、tag・push・save・loadで受け渡します。CMDとENTRYPOINTの違い、RUNのまとめ方、秘密情報を入れないことは、試験でも実務でも重要なポイントです。次の章では、コンテナのネットワークとデータの保存方法を扱います。

この記事を書いた人:
こすけ(コマンド学習道場 運営者)。
AWSの運用保守に携わるエンジニアで、保有資格はCCNA・AWS-SAA・LPIC-3(305)。
詳しくは運営者情報をご覧ください。

この章で使ったコマンド

この章の実行例に出てきたコマンドです(全2個)。名前を選ぶと、オプションや実行例を詳しく確認できます。復習や、あとから調べ直すときに使ってください。

docker・curl

この章の内容を練習できる課題

読んだ内容は、実際に打ってみると定着します。次の課題は、ブラウザの練習用ターミナルで、この章のコマンドを使って進めるものです。リンクを開くと、すぐに始まります。

ほかの課題は、練習問題の一覧から選べます。

確認クイズ

Q1. Dockerfileで、ビルドコンテキストのファイルをイメージにコピーする命令のうち、URLからの取得やtarの自動展開を行わないものはどれですか?

解説:
COPYは単純なコピーだけを行います。
ADDはURLからの取得やtarの展開も行うため、意図しない動作を避ける目的で、通常はCOPYが推奨されます。

Q2. ENTRYPOINT ["curl"]とCMD ["--help"]を持つイメージを、docker run イメージ -I https://example.comで起動したとき、実行されるコマンドはどれですか?

解説:
ENTRYPOINTは必ず実行され、docker runに渡した引数がCMDの代わりにその引数になります。

Q3. イメージがどの命令から作られたか、レイヤーごとに確認するコマンドはどれですか?

解説:
docker historyはイメージのレイヤーの履歴を表示します。
docker diffは、コンテナで変更されたファイルの一覧を表示するコマンドです。

Q4. インターネットに接続できないサーバーへ、イメージをファイルで持ち込む方法として適切なものはどれですか?

解説:
docker saveはイメージをtar形式で書き出し、docker loadで読み込めます。
レイヤーやタグの情報も保たれます。