docker imagesコマンド

##| はじめに

ここでは[公式リファレンス](http://docs.docker.com/v1.7/docker/reference/commandline/images/)を参考に`docker images`コマンドについて説明しています。
ただ、バージョンや環境等により若干挙動が異なるかもしれませんが、その点についてはご容赦ください。
また、その他の`docker`サブコマンドについては[こちら](http://qiita.com/kooohei/items/8acb82c6c0bf00bfb9bb)に記載していますので、もしよければ参考にしていただければと思います。

##| 使い方

ローカルに保存したコンテナイメージ一覧を表示します。

```:使い方
使い方： docker images [オプション] [リポジトリ]
```

以下がデフォルトの出力結果です。

```bash:デフォルト
$ docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
registry            latest              1cb234ccb22b        8 days ago          422.9 MB
ubuntu              vivid               1aaa18adf220        10 days ago         131.3 MB
ubuntu              14.04               e9ae3c220b23        10 days ago         187.9 MB
ubuntu              latest              e9ae3c220b23        10 days ago         187.9 MB
fedora              latest              a887c7ad7f3f        2 weeks ago         204.3 MB
busybox             latest              c51f86c28340        2 weeks ago         1.109 MB
ubuntu              15.10               5eb72b199374        4 weeks ago         131.4 MB
ubuntu              wily                5eb72b199374        4 weeks ago         131.4 MB
centos              centos6             1a895dd3954a        5 weeks ago         190.6 MB
centos              centos7             e9fa5d3a0d0e        5 weeks ago         172.3 MB
centos              latest              e9fa5d3a0d0e        5 weeks ago         172.3 MB
```

リポジトリを指定すると、その指定したリポジトリに含まれるイメージのみを表示します。

```bash:例.リポジトリ指定
$ docker images ubuntu
REPOSITORY          TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
ubuntu              vivid               1aaa18adf220        10 days ago         131.3 MB
ubuntu              latest              e9ae3c220b23        10 days ago         187.9 MB
ubuntu              14.04               e9ae3c220b23        10 days ago         187.9 MB
ubuntu              wily                5eb72b199374        4 weeks ago         131.4 MB
ubuntu              15.10               5eb72b199374        4 weeks ago         131.4 MB
```

##| オプション

###・-a
中間イメージも含め、すべてのイメージを表示します。

```bash:例.-a,--all
$ docker images --all
REPOSITORY          TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
registry            latest              1cb234ccb22b        8 days ago          422.9 MB
<none>              <none>              8b6906266e10        8 days ago          422.9 MB
<none>              <none>              b8920c5da9b4        8 days ago          422.9 MB
<none>              <none>              7f7baa145866        8 days ago          422.9 MB
<none>              <none>              75223bf2060b        8 days ago          422.9 MB
<none>              <none>              f19a0609fffe        8 days ago          422.8 MB
<none>              <none>              99730d8bbd0b        8 days ago          398.3 MB
<none>              <none>              4c829a32d6df        8 days ago          386.7 MB
<none>              <none>              73bf53db741c        8 days ago          386.7 MB
<none>              <none>              76efbda47e08        8 days ago          384.3 MB
ubuntu              vivid               1aaa18adf220        10 days ago         131.3 MB
<none>              <none>              1757d627dc36        10 days ago         131.3 MB
<none>              <none>              9374be5a8df6        10 days ago         131.3 MB
<none>              <none>              435b2cf049ed        10 days ago         131.3 MB
ubuntu              14.04               e9ae3c220b23        10 days ago         187.9 MB
ubuntu              latest              e9ae3c220b23        10 days ago         187.9 MB
<none>              <none>              a6785352b25c        10 days ago         187.9 MB
<none>              <none>              0998bf8fb9e9        10 days ago         187.9 MB
<none>              <none>              0a85502c06c9        10 days ago         187.7 MB
fedora              latest              a887c7ad7f3f        2 weeks ago         204.3 MB
busybox             latest              c51f86c28340        2 weeks ago         1.109 MB
<none>              <none>              039b63dd2cba        2 weeks ago         1.109 MB
<none>              <none>              19eed9c5b1da        4 weeks ago         131.4 MB
ubuntu              15.10               5eb72b199374        4 weeks ago         131.4 MB
ubuntu              wily                5eb72b199374        4 weeks ago         131.4 MB
<none>              <none>              91ed52dbf166        4 weeks ago         131.4 MB
<none>              <none>              edf0bf8b21d5        4 weeks ago         131.4 MB
centos              centos6             1a895dd3954a        5 weeks ago         190.6 MB
<none>              <none>              366219586e86        5 weeks ago         190.6 MB
<none>              <none>              501f51238f9e        5 weeks ago         190.6 MB
<none>              <none>              ebdbe10e9b33        5 weeks ago         190.6 MB
centos              centos7             e9fa5d3a0d0e        5 weeks ago         172.3 MB
centos              latest              e9fa5d3a0d0e        5 weeks ago         172.3 MB
<none>              <none>              e9407f1d4b65        5 weeks ago         172.3 MB
<none>              <none>              c9853740aa05        5 weeks ago         172.3 MB
<none>              <none>              0cd86ce0a197        5 weeks ago         172.3 MB
<none>              <none>              fa5be2806d4c        10 weeks ago        0 B
<none>              <none>              369aca82a5c0        4 months ago        0 B
```


###・--digests
イメージのユニークなIDとなるdigestを表示します。
Registry2.0から付与されるようになりました。

```bash:例.--digests
$ docker images --digests
REPOSITORY          TAG                 DIGEST              IMAGE ID            CREATED             VIRTUAL SIZE
registry            latest              <none>              1cb234ccb22b        8 days ago          422.9 MB
ubuntu              vivid               <none>              1aaa18adf220        10 days ago         131.3 MB
ubuntu              14.04               <none>              e9ae3c220b23        10 days ago         187.9 MB
ubuntu              latest              <none>              e9ae3c220b23        10 days ago         187.9 MB
fedora              latest              <none>              a887c7ad7f3f        2 weeks ago         204.3 MB
busybox             latest              <none>              c51f86c28340        2 weeks ago         1.109 MB
ubuntu              15.10               <none>              5eb72b199374        4 weeks ago         131.4 MB
ubuntu              wily                <none>              5eb72b199374        4 weeks ago         131.4 MB
centos              centos6             <none>              1a895dd3954a        5 weeks ago         190.6 MB
centos              centos7             <none>              e9fa5d3a0d0e        5 weeks ago         172.3 MB
centos              latest              <none>              e9fa5d3a0d0e        5 weeks ago         172.3 MB
```


###・-f, --filter=[]
フィルタリングオプションです。


###・--help
ヘルプオプションです。

```bash:例.--help
$ docker images --help

Usage:	docker images [OPTIONS] [REPOSITORY[:TAG]]

List images

  -a, --all=false      Show all images (default hides intermediate images)
  --digests=false      Show digests
  -f, --filter=[]      Filter output based on conditions provided
  --help=false         Print usage
  --no-trunc=false     Don't truncate output
  -q, --quiet=false    Only show numeric IDs
```


###・--no-trunc

デフォルトだとイメージIDの先頭12桁までリストされますが、このオプションを指定するとフルの長さでイメージIDを表示します。

```bash:例.--no-trunc
$ docker images --no-trunc
REPOSITORY          TAG                 IMAGE ID                                                           CREATED             VIRTUAL SIZE
registry            latest              1cb234ccb22b7897976cb8b95b6a502aacf5b606eef6eb1af000b7194a5293f4   8 days ago          422.9 MB
ubuntu              vivid               1aaa18adf2203dd56f4f10b3d581c3bd7b62f1183fc3d2273b1e1b0a733ff70c   10 days ago         131.3 MB
ubuntu              14.04               e9ae3c220b23b699cb5e6914af806219b028c78d5cf6fed8eeca98ffaa8c9b43   10 days ago         187.9 MB
ubuntu              latest              e9ae3c220b23b699cb5e6914af806219b028c78d5cf6fed8eeca98ffaa8c9b43   10 days ago         187.9 MB
fedora              latest              a887c7ad7f3f226bbe4466f2e71af7a1ff6b97cad4518db6633bad3b08caa483   2 weeks ago         204.3 MB
busybox             latest              c51f86c283408d1749d066333f7acd5d33b053b003a61ff6a7b36819ddcbc7b7   2 weeks ago         1.109 MB
ubuntu              15.10               5eb72b19937466233ad232804bb46053fbd0f0d61c9366d73a36db33f49398d6   4 weeks ago         131.4 MB
ubuntu              wily                5eb72b19937466233ad232804bb46053fbd0f0d61c9366d73a36db33f49398d6   4 weeks ago         131.4 MB
centos              centos6             1a895dd3954aede5ea9e6bc23d23e8b1f6040df94647d83e71f96d60131d3235   5 weeks ago         190.6 MB
centos              centos7             e9fa5d3a0d0e19519e66af2dd8ad6903a7288de0e995b6eafbcb38aebf2b606d   5 weeks ago         172.3 MB
centos              latest              e9fa5d3a0d0e19519e66af2dd8ad6903a7288de0e995b6eafbcb38aebf2b606d   5 weeks ago         172.3 MB
```

###・-q

イメージIDのみを表示します。

```bash:例.-q
$ docker images -q
1cb234ccb22b
1aaa18adf220
e9ae3c220b23
e9ae3c220b23
a887c7ad7f3f
c51f86c28340
5eb72b199374
5eb72b199374
1a895dd3954a
e9fa5d3a0d0e
e9fa5d3a0d0e
```

以上です。