docker images / pull の使い方

イメージの一覧・取得

書き方

docker images [名前]
docker pull イメージ[:タグ]
docker images -q
docker images -f dangling=true

手元にあるイメージを表示します。pull はレジストリからイメージを取ってきます。タグを書かないと latest。

よく使うオプション

オプション意味
-a途中の層のイメージも出す
-qイメージの ID だけを出す
-f dangling=true名前の無い（<none>）イメージだけを出す
--digestsダイジェスト（中身の指紋）も出す
--platform linux/amd64（pull）別の CPU 向けのイメージを取る

例

$ docker pull nginx:alpinealpine: Pulling from library/nginx
Digest: sha256:2140dad235c130ac861018a4e13a6bc8aea3a35f3a40e20c1b060d51a7efd250
Status: Downloaded newer image for nginx:alpine
docker.io/library/nginx:alpine

Docker Hub から nginx の alpine 版を取ってきます。タグを書かないと latest になります。

$ docker imagesREPOSITORY   TAG       IMAGE ID       CREATED       SIZE
nginx        alpine    1ff4bb4faebc   2 weeks ago   47.9MB
nginx        latest    3b25b682ea82   2 weeks ago   192MB
postgres     17        f49abb9855df   3 weeks ago   438MB

手元にあるイメージの一覧を出します。SIZE で大きさも分かります。

$ docker images nginx

名前で絞り込み、nginx のイメージだけを出します。

$ docker images -f dangling=true

作り直したときに名前を失った古いイメージ（<none>）を探します。片付けの前の確認に使います。

よくある間違い・注意

  • latest は「最新」という意味ではなく、タグを付けなかったときの名前です。本番では nginx:1.27 のように版を決めて書きます。
  • 同じ IMAGE ID のものは、名前が違っても中身は同じです。容量も 1 つ分しか使いません。

実際に打って練習する

Docker コースの Lv12「積み荷 docker images と pull」で覚えます（第1章 はじめてのコンテナ）。ブラウザの中のシミュレーターで、本物と同じように打って確かめられます。

Lv1〜7 はログインすると無料で試せます（それより先はゴールド以上のプランで遊べます）。

Docker コースのレベル一覧

関連するコマンド

Docker コマンド一覧（使い方と例）へ戻る