Guest24897
/
DockerCLI
mirror of https://github.com/docker/cli.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docker save: ability to save multiple images 

Now from a single invocation of `docker save`, you can specify multiple
images to include in the output tar, or even just multiple tags of a
particular image/repo.

```
> docker save -o bundle.tar busybox ubuntu:lucid ubuntu:saucy fedora:latest
> tar tf ./bundle.tar | wc -l
42
> tar xOf ./bundle.tar repositories
{"busybox":{"latest":"2d8e5b282c81244037eb15b2068e1c46319c1a42b80493acb128da24b2090739"},"fedora":{"latest":"58394af373423902a1b97f209a31e3777932d9321ef10e64feaaa7b4df609cf9"},"ubuntu":{"lucid":"9cc9ea5ea540116b89e41898dd30858107c1175260fb7ff50322b34704092232","saucy":"9f676bd305a43a931a8d98b13e5840ffbebcd908370765373315926024c7c35e"}}
```

Further, this fixes the bug where the `repositories` file is not created
when saving a specific tag of an image (e.g. ubuntu:latest)

document multi-image save and updated API docs

Docker-DCO-1.1-Signed-off-by: Vincent Batts <vbatts@redhat.com> (github: vbatts)
This commit is contained in:
Vincent Batts 2014-05-01 00:26:24 -04:00 committed by Tibor Vass
parent bbea6aa42d
commit 28b535f825
1 changed files with 11 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
docs/sources/reference/commandline/cli.md
View File

@ -1249,17 +1249,17 @@ Providing a maximum restart limit is only valid for the ** on-failure ** policy.
## save ## save
Usage: docker save [OPTIONS] IMAGE Usage: docker save [OPTIONS] IMAGE [IMAGE...]
Save an image to a tar archive (streamed to STDOUT by default) Save an image(s) to a tar archive (streamed to STDOUT by default)
-o, --output="" Write to an file, instead of STDOUT -o, --output="" Write to an file, instead of STDOUT
Produces a tarred repository to the standard output stream. Contains all Produces a tarred repository to the standard output stream.
parent layers, and all tags + versions, or specified repo:tag. Contains all parent layers, and all tags + versions, or specified repo:tag, for
each argument provided.
It is used to create a backup that can then be used with It is used to create a backup that can then be used with ``docker load``
`docker load`
$ sudo docker save busybox > busybox.tar $ sudo docker save busybox > busybox.tar
$ ls -sh busybox.tar $ ls -sh busybox.tar
@ -1270,6 +1270,11 @@ It is used to create a backup that can then be used with
$ sudo docker save -o fedora-all.tar fedora $ sudo docker save -o fedora-all.tar fedora
$ sudo docker save -o fedora-latest.tar fedora:latest $ sudo docker save -o fedora-latest.tar fedora:latest
It is even useful to cherry-pick particular tags of an image repository
$ sudo docker save -o ubuntu.tar ubuntu:lucid ubuntu:saucy
## search ## search
Search [Docker Hub](https://hub.docker.com) for images Search [Docker Hub](https://hub.docker.com) for images