docker rmi の使い方

イメージを消す

書き方

docker rmi イメージ...
docker rmi -f イメージ
docker image rm イメージ

イメージを消します。コンテナ(止まっているものも)が使っているイメージは消せません。

よく使うオプション

オプション意味
-fタグが複数あっても、止まったコンテナが使っていても消す
--no-pruneタグの無い親の層を残す

例

$ docker rmi nginx:alpineUntagged: nginx:alpine
Deleted: sha256:1ff4bb4faebcfb1f7e01144fa9904a570ab9bab88694457855feb6c6bba3fa07

nginx:alpine のイメージを消します。ほかのタグが同じ中身を指していると、名前だけが外れます。

$ docker image rm myapp:old

docker rmi と同じ働きの、新しい書き方です。

$ docker rmi $(docker images -q -f dangling=true)

名前の無い古いイメージをまとめて消します。docker image prune -f と同じ働きです。

よくある間違い・注意

  • 「image is being used by stopped container」と出たら、止まったコンテナがまだ使っています。先に docker rm でコンテナを消します。
  • rmi -f で消しても、動いているコンテナが使っているイメージの中身は消えません。名前が外れるだけです。

実際に打って練習する

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

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

Docker コマンド一覧(使い方と例)へ戻る