Browse code
Correct old virtual size
In new content addressable model, image no longer
have virtual size column, it is now 'size'. So we
need to update related docs about them.
Signed-off-by: Kai Qiang Wu(Kennan) <wkqwu@cn.ibm.com>
Kai Qiang Wu(Kennan) authored on 2016/02/02 14:57:59Showing 9 changed files
- docs/reference/commandline/commit.md
- docs/reference/commandline/images.md
- docs/reference/commandline/load.md
- docs/reference/commandline/rmi.md
- docs/userguide/containers/dockerimages.md
- docs/userguide/storagedriver/imagesandcontainers.md
- man/docker-images.1.md
- man/docker-load.1.md
- man/docker-pull.1.md
| ... | ... |
@@ -46,7 +46,7 @@ created. Supported `Dockerfile` instructions: |
| 46 | 46 |
$ docker commit c3f279d17e0a svendowideit/testimage:version3 |
| 47 | 47 |
f5283438590d |
| 48 | 48 |
$ docker images |
| 49 |
- REPOSITORY TAG ID CREATED VIRTUAL SIZE |
|
| 49 |
+ REPOSITORY TAG ID CREATED SIZE |
|
| 50 | 50 |
svendowideit/testimage version3 f5283438590d 16 seconds ago 335.7 MB |
| 51 | 51 |
|
| 52 | 52 |
## Commit a container with new configurations |
| ... | ... |
@@ -22,25 +22,25 @@ parent = "smn_cli" |
| 22 | 22 |
-q, --quiet Only show numeric IDs |
| 23 | 23 |
|
| 24 | 24 |
The default `docker images` will show all top level |
| 25 |
-images, their repository and tags, and their virtual size. |
|
| 25 |
+images, their repository and tags, and their size. |
|
| 26 | 26 |
|
| 27 | 27 |
Docker images have intermediate layers that increase reusability, |
| 28 | 28 |
decrease disk usage, and speed up `docker build` by |
| 29 | 29 |
allowing each step to be cached. These intermediate layers are not shown |
| 30 | 30 |
by default. |
| 31 | 31 |
|
| 32 |
-The `VIRTUAL SIZE` is the cumulative space taken up by the image and all |
|
| 32 |
+The `SIZE` is the cumulative space taken up by the image and all |
|
| 33 | 33 |
its parent images. This is also the disk space used by the contents of the |
| 34 | 34 |
Tar file created when you `docker save` an image. |
| 35 | 35 |
|
| 36 | 36 |
An image will be listed more than once if it has multiple repository names |
| 37 | 37 |
or tags. This single image (identifiable by its matching `IMAGE ID`) |
| 38 |
-uses up the `VIRTUAL SIZE` listed only once. |
|
| 38 |
+uses up the `SIZE` listed only once. |
|
| 39 | 39 |
|
| 40 | 40 |
### Listing the most recently created images |
| 41 | 41 |
|
| 42 | 42 |
$ docker images |
| 43 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 43 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 44 | 44 |
<none> <none> 77af4d6b9913 19 hours ago 1.089 GB |
| 45 | 45 |
committ latest b6fa739cedf5 19 hours ago 1.089 GB |
| 46 | 46 |
<none> <none> 78a85c484f71 19 hours ago 1.089 GB |
| ... | ... |
@@ -61,7 +61,7 @@ given repository. |
| 61 | 61 |
For example, to list all images in the "java" repository, run this command : |
| 62 | 62 |
|
| 63 | 63 |
$ docker images java |
| 64 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 64 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 65 | 65 |
java 8 308e519aac60 6 days ago 824.5 MB |
| 66 | 66 |
java 7 493d82594c15 3 months ago 656.3 MB |
| 67 | 67 |
java latest 2711b1d6f3aa 5 months ago 603.9 MB |
| ... | ... |
@@ -74,18 +74,18 @@ repository and tag are listed. To find all local images in the "java" |
| 74 | 74 |
repository with tag "8" you can use: |
| 75 | 75 |
|
| 76 | 76 |
$ docker images java:8 |
| 77 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 77 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 78 | 78 |
java 8 308e519aac60 6 days ago 824.5 MB |
| 79 | 79 |
|
| 80 | 80 |
If nothing matches `REPOSITORY[:TAG]`, the list is empty. |
| 81 | 81 |
|
| 82 | 82 |
$ docker images java:0 |
| 83 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 83 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 84 | 84 |
|
| 85 | 85 |
## Listing the full length image IDs |
| 86 | 86 |
|
| 87 | 87 |
$ docker images --no-trunc |
| 88 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 88 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 89 | 89 |
<none> <none> 77af4d6b9913e693e8d0b4b294fa62ade6054e6b2f1ffb617ac955dd63fb0182 19 hours ago 1.089 GB |
| 90 | 90 |
committest latest b6fa739cedf5ea12a620a439402b6004d057da800f91c7524b5086a5e4749c9f 19 hours ago 1.089 GB |
| 91 | 91 |
<none> <none> 78a85c484f71509adeaace20e72e941f6bdd2b25b4c75da8693efd9f61a37921 19 hours ago 1.089 GB |
| ... | ... |
@@ -104,7 +104,7 @@ unchanged, the digest value is predictable. To list image digest values, use |
| 104 | 104 |
the `--digests` flag: |
| 105 | 105 |
|
| 106 | 106 |
$ docker images --digests |
| 107 |
- REPOSITORY TAG DIGEST IMAGE ID CREATED VIRTUAL SIZE |
|
| 107 |
+ REPOSITORY TAG DIGEST IMAGE ID CREATED SIZE |
|
| 108 | 108 |
localhost:5000/test/busybox <none> sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf 4986bf8c1536 9 weeks ago 2.43 MB |
| 109 | 109 |
|
| 110 | 110 |
When pushing or pulling to a 2.0 registry, the `push` or `pull` command |
| ... | ... |
@@ -126,7 +126,7 @@ The currently supported filters are: |
| 126 | 126 |
|
| 127 | 127 |
$ docker images --filter "dangling=true" |
| 128 | 128 |
|
| 129 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 129 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 130 | 130 |
<none> <none> 8abc22fbb042 4 weeks ago 0 B |
| 131 | 131 |
<none> <none> 48e5f45168b9 4 weeks ago 2.489 MB |
| 132 | 132 |
<none> <none> bf747efa0e2f 4 weeks ago 0 B |
| ... | ... |
@@ -163,20 +163,20 @@ The following filter matches images with the `com.example.version` label regardl |
| 163 | 163 |
|
| 164 | 164 |
$ docker images --filter "label=com.example.version" |
| 165 | 165 |
|
| 166 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 166 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 167 | 167 |
match-me-1 latest eeae25ada2aa About a minute ago 188.3 MB |
| 168 | 168 |
match-me-2 latest eeae25ada2aa About a minute ago 188.3 MB |
| 169 | 169 |
|
| 170 | 170 |
The following filter matches images with the `com.example.version` label with the `1.0` value. |
| 171 | 171 |
|
| 172 | 172 |
$ docker images --filter "label=com.example.version=1.0" |
| 173 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 173 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 174 | 174 |
match-me latest eeae25ada2aa About a minute ago 188.3 MB |
| 175 | 175 |
|
| 176 | 176 |
In this example, with the `0.1` value, it returns an empty set because no matches were found. |
| 177 | 177 |
|
| 178 | 178 |
$ docker images --filter "label=com.example.version=0.1" |
| 179 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 179 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 180 | 180 |
|
| 181 | 181 |
## Formatting |
| 182 | 182 |
|
| ... | ... |
@@ -21,14 +21,14 @@ Loads a tarred repository from a file or the standard input stream. |
| 21 | 21 |
Restores both images and tags. |
| 22 | 22 |
|
| 23 | 23 |
$ docker images |
| 24 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 24 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 25 | 25 |
$ docker load < busybox.tar.gz |
| 26 | 26 |
$ docker images |
| 27 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 27 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 28 | 28 |
busybox latest 769b9341d937 7 weeks ago 2.489 MB |
| 29 | 29 |
$ docker load --input fedora.tar |
| 30 | 30 |
$ docker images |
| 31 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 31 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 32 | 32 |
busybox latest 769b9341d937 7 weeks ago 2.489 MB |
| 33 | 33 |
fedora rawhide 0d20aec6529d 7 weeks ago 387 MB |
| 34 | 34 |
fedora 20 58394af37342 7 weeks ago 385.5 MB |
| ... | ... |
@@ -63,7 +63,7 @@ command untags and removes all images that match the specified ID. |
| 63 | 63 |
An image pulled by digest has no tag associated with it: |
| 64 | 64 |
|
| 65 | 65 |
$ docker images --digests |
| 66 |
- REPOSITORY TAG DIGEST IMAGE ID CREATED VIRTUAL SIZE |
|
| 66 |
+ REPOSITORY TAG DIGEST IMAGE ID CREATED SIZE |
|
| 67 | 67 |
localhost:5000/test/busybox <none> sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf 4986bf8c1536 9 weeks ago 2.43 MB |
| 68 | 68 |
|
| 69 | 69 |
To remove an image using its digest: |
| ... | ... |
@@ -34,7 +34,7 @@ Let's start with listing the images you have locally on our host. You can |
| 34 | 34 |
do this using the `docker images` command like so: |
| 35 | 35 |
|
| 36 | 36 |
$ docker images |
| 37 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 37 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 38 | 38 |
ubuntu 14.04 1d073211c498 3 days ago 187.9 MB |
| 39 | 39 |
busybox latest 2c5ac3f849df 5 days ago 1.113 MB |
| 40 | 40 |
training/webapp latest 54bb4e8718e8 5 months ago 348.7 MB |
| ... | ... |
@@ -214,7 +214,7 @@ You can then look at our new `ouruser/sinatra` image using the `docker images` |
| 214 | 214 |
command. |
| 215 | 215 |
|
| 216 | 216 |
$ docker images |
| 217 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 217 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 218 | 218 |
training/sinatra latest 5bc342fa0b91 10 hours ago 446.7 MB |
| 219 | 219 |
ouruser/sinatra v2 3c59e02ddd1a 10 hours ago 446.7 MB |
| 220 | 220 |
ouruser/sinatra latest 5db5f8471261 10 hours ago 446.7 MB |
| ... | ... |
@@ -492,7 +492,7 @@ user name, the repository name and the new tag. |
| 492 | 492 |
Now, see your new tag using the `docker images` command. |
| 493 | 493 |
|
| 494 | 494 |
$ docker images ouruser/sinatra |
| 495 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 495 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 496 | 496 |
ouruser/sinatra latest 5db5f8471261 11 hours ago 446.7 MB |
| 497 | 497 |
ouruser/sinatra devel 5db5f8471261 11 hours ago 446.7 MB |
| 498 | 498 |
ouruser/sinatra v2 5db5f8471261 11 hours ago 446.7 MB |
| ... | ... |
@@ -505,7 +505,7 @@ unchanged, the digest value is predictable. To list image digest values, use |
| 505 | 505 |
the `--digests` flag: |
| 506 | 506 |
|
| 507 | 507 |
$ docker images --digests | head |
| 508 |
- REPOSITORY TAG DIGEST IMAGE ID CREATED VIRTUAL SIZE |
|
| 508 |
+ REPOSITORY TAG DIGEST IMAGE ID CREATED SIZE |
|
| 509 | 509 |
ouruser/sinatra latest sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf 5db5f8471261 11 hours ago 446.7 MB |
| 510 | 510 |
|
| 511 | 511 |
When pushing or pulling to a 2.0 registry, the `push` or `pull` command |
| ... | ... |
@@ -101,7 +101,7 @@ single 8GB general purpose SSD EBS volume. The Docker data directory |
| 101 | 101 |
(`/var/lib/docker`) was consuming 2GB of space. |
| 102 | 102 |
|
| 103 | 103 |
$ docker images |
| 104 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 104 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 105 | 105 |
jenkins latest 285c9f0f9d3d 17 hours ago 708.5 MB |
| 106 | 106 |
mysql latest d39c3fa09ced 8 days ago 360.3 MB |
| 107 | 107 |
mongo latest a74137af4532 13 days ago 317.4 MB |
| ... | ... |
@@ -312,7 +312,7 @@ command. |
| 312 | 312 |
5. Run the `docker images` command to verify the new `changed-ubuntu` image is |
| 313 | 313 |
6. in the Docker host's local storage area. |
| 314 | 314 |
|
| 315 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 315 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 316 | 316 |
changed-ubuntu latest 03b964f68d06 33 seconds ago 131.4 MB |
| 317 | 317 |
ubuntu 15.04 013f3d01d247 6 weeks ago 131.3 MB |
| 318 | 318 |
|
| ... | ... |
@@ -70,7 +70,7 @@ To list the images in a local repository (not the registry) run: |
| 70 | 70 |
|
| 71 | 71 |
The list will contain the image repository name, a tag for the image, and an |
| 72 | 72 |
image ID, when it was created and its virtual size. Columns: REPOSITORY, TAG, |
| 73 |
-IMAGE ID, CREATED, and VIRTUAL SIZE. |
|
| 73 |
+IMAGE ID, CREATED, and SIZE. |
|
| 74 | 74 |
|
| 75 | 75 |
The `docker images` command takes an optional `[REPOSITORY[:TAG]]` argument |
| 76 | 76 |
that restricts the list to images that match the argument. If you specify |
| ... | ... |
@@ -25,11 +25,11 @@ Restores both images and tags. |
| 25 | 25 |
# EXAMPLES |
| 26 | 26 |
|
| 27 | 27 |
$ docker images |
| 28 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 28 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 29 | 29 |
busybox latest 769b9341d937 7 weeks ago 2.489 MB |
| 30 | 30 |
$ docker load --input fedora.tar |
| 31 | 31 |
$ docker images |
| 32 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 32 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 33 | 33 |
busybox latest 769b9341d937 7 weeks ago 2.489 MB |
| 34 | 34 |
fedora rawhide 0d20aec6529d 7 weeks ago 387 MB |
| 35 | 35 |
fedora 20 58394af37342 7 weeks ago 385.5 MB |
| ... | ... |
@@ -43,7 +43,7 @@ Note that if the image is previously downloaded then the status would be |
| 43 | 43 |
Status: Downloaded newer image for fedora |
| 44 | 44 |
|
| 45 | 45 |
$ docker images |
| 46 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 46 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 47 | 47 |
fedora rawhide ad57ef8d78d7 5 days ago 359.3 MB |
| 48 | 48 |
fedora 20 105182bb5e8b 5 days ago 372.7 MB |
| 49 | 49 |
fedora heisenbug 105182bb5e8b 5 days ago 372.7 MB |
| ... | ... |
@@ -60,7 +60,7 @@ Note that if the image is previously downloaded then the status would be |
| 60 | 60 |
Status: Downloaded newer image for debian:latest |
| 61 | 61 |
|
| 62 | 62 |
$ docker images |
| 63 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 63 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 64 | 64 |
debian latest 4a5e6db8c069 5 days ago 125.1 MB |
| 65 | 65 |
|
| 66 | 66 |
|
| ... | ... |
@@ -77,7 +77,7 @@ Note that if the image is previously downloaded then the status would be |
| 77 | 77 |
Status: Downloaded newer image for registry.hub.docker.com/fedora:20 |
| 78 | 78 |
|
| 79 | 79 |
$ docker images |
| 80 |
- REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE |
|
| 80 |
+ REPOSITORY TAG IMAGE ID CREATED SIZE |
|
| 81 | 81 |
fedora 20 3f2fed40e4b0 4 days ago 372.7 MB |
| 82 | 82 |
|
| 83 | 83 |
|