`docker image prune`でimageが削除されない理由を教えてください

Question

環境

• XUbuntu 16.04 LTS
• Docker version 18.03.1-ce, build 9ee9f40

背景

Dockerを勉強しています。
docker image pruneの動作を確認したいです。

実行内容

docker image pruneを実行しましたが、imageは削除されませんでした。
containerは1つも存在しない状態です。

$ docker image ls -a
REPOSITORY            TAG                 IMAGE ID            CREATED             SIZE
<none>                <none>              e290f676487a        2 hours ago         177MB
webapp                latest              b4c14f6096b8        2 hours ago         177MB
<none>                <none>              760dd2c9c191        2 hours ago         177MB
kawamatsu/webserver   1.0                 ae513a47849c        41 hours ago        109MB
nginx                 latest              ae513a47849c        41 hours ago        109MB
ubuntu                latest              452a96d81c30        4 days ago          79.6MB
hello-world           latest              e38bc07ac18e        2 weeks ago         1.85kB
sample                1.0                 e934aafc2206        3 weeks ago         199MB
sample                2.0                 e934aafc2206        3 weeks ago         199MB
centos                centos7             e934aafc2206        3 weeks ago         199MB
centos                latest              e934aafc2206        3 weeks ago         199MB
$ docker container ls -a
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
$ docker image prune
WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N] y
$ docker image ls -a
REPOSITORY            TAG                 IMAGE ID            CREATED             SIZE
webapp                latest              b4c14f6096b8        2 hours ago         177MB
<none>                <none>              e290f676487a        2 hours ago         177MB
<none>                <none>              760dd2c9c191        2 hours ago         177MB
kawamatsu/webserver   1.0                 ae513a47849c        41 hours ago        109MB
nginx                 latest              ae513a47849c        41 hours ago        109MB
ubuntu                latest              452a96d81c30        4 days ago          79.6MB
hello-world           latest              e38bc07ac18e        2 weeks ago         1.85kB
centos                centos7             e934aafc2206        3 weeks ago         199MB
centos                latest              e934aafc2206        3 weeks ago         199MB
sample                1.0                 e934aafc2206        3 weeks ago         199MB
sample                2.0                 e934aafc2206        3 weeks ago         199MB
$ 

質問

docker image pruneでimageが削除されないのは、なぜでしょうか?

docker image pruneコマンドのマニュアルページには、「Remove unused images」と書かれています。
「unused images」とは、何でしょうか？
私は、「containerとして参照されなかったimageを『unused image』」と思っているんですが、これが間違いなんだと思います。

Answer 1

docker image prune はオプションなしで実行した時は dangling image だけを削除します。dangling image は、なにかの理由（予期せぬエラーなど）でゴミのように残ってしまったイメージのことです。

ご質問のように unused image（containerから参照されてない image）を削除するには -a オプションを追加してください。

$ docker image prune -a

Comments

[yuji38kwmt]

ありがとうございます。`-a`で削除することができました！
Extend Discriptionに書いてありましたね。
>Remove all dangling images. If -a is specified, will also remove all images not referenced by any container.

ただの「Discription」には「Remove unused images」としか書いていないので、疑問に思いました。