diff options
| author | umohnani8 <umohnani@redhat.com> | 2017-12-12 13:33:10 -0500 |
|---|---|---|
| committer | Atomic Bot <atomic-devel@projectatomic.io> | 2017-12-14 18:37:17 +0000 |
| commit | 1e7d880b561318aa2ad89d7583addad1904e5a36 (patch) | |
| tree | 7773e3d409c410ae9bb3a210e106dddc28e302b5 /docs | |
| parent | bf0d35904752c2ac5c607c4a82237f074c862744 (diff) | |
| download | podman-1e7d880b561318aa2ad89d7583addad1904e5a36.tar.gz podman-1e7d880b561318aa2ad89d7583addad1904e5a36.tar.bz2 podman-1e7d880b561318aa2ad89d7583addad1904e5a36.zip | |
Add manifest type conversion to kpod push
User can select from 3 manifest types: oci, v2s1, or v2s2
e.g kpod push --format v2s2 alpine dir:my-directory
Added "compress" flag to enable compression when true
Signed-off-by: umohnani8 <umohnani@redhat.com>
Closes: #126
Approved by: rhatdan
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/kpod-push.1.md | 32 |
1 files changed, 28 insertions, 4 deletions
diff --git a/docs/kpod-push.1.md b/docs/kpod-push.1.md index a9d314cbe..211a5f517 100644 --- a/docs/kpod-push.1.md +++ b/docs/kpod-push.1.md @@ -9,8 +9,10 @@ kpod push - Push an image from local storage to elsewhere **kpod** **push** [*options* [...]] **imageID** [**destination**] ## DESCRIPTION -Pushes an image from local storage to a specified destination, decompressing -and recompressing layers as needed. +Pushes an image from local storage to a specified destination. +Push is mainly used to push images to registries, however **kpod push** +can be used to save images to tarballs and directories using the following +transports: **dir:**, **docker-archive:**, **docker-daemon:**, **oci-archive:**, and **ostree:**. ## imageID Image stored in local container/storage @@ -19,6 +21,8 @@ Image stored in local container/storage The DESTINATION is a location to store container images The Image "DESTINATION" uses a "transport":"details" format. + If a transport is not given, kpod push will attempt to push + to a registry. Multiple transports are supported: @@ -55,9 +59,15 @@ Credentials (USERNAME:PASSWORD) to use for authenticating to a registry Pathname of a directory containing TLS certificates and keys -**--disable-compression, -D** +**--compress** -Don't compress copies of filesystem layers which will be pushed +Compress tarball image layers when pushing to a directory using the 'dir' transport. (default is same compression type, compressed or uncompressed, as source) +Note: This flag can only be set when using the **dir** transport + +**--format, -f** + +Manifest Type (oci, v2s1, or v2s2) to use when pushing an image to a directory using the 'dir:' transport (default is manifest type of source) +Note: This flag can only be set when using the **dir** transport **--quiet, -q** @@ -113,5 +123,19 @@ Writing manifest to image destination Storing signatures ``` +This example pushes the rhel7 image to rhel7-dir with the "oci" manifest type +``` +# kpod push --format oci registry.access.redhat.com/rhel7 dir:rhel7-dir +Getting image source signatures +Copying blob sha256:9cadd93b16ff2a0c51ac967ea2abfadfac50cfa3af8b5bf983d89b8f8647f3e4 + 71.41 MB / 71.41 MB [======================================================] 9s +Copying blob sha256:4aa565ad8b7a87248163ce7dba1dd3894821aac97e846b932ff6b8ef9a8a508a + 1.21 KB / 1.21 KB [========================================================] 0s +Copying config sha256:f1b09a81455c351eaa484b61aacd048ab613c08e4c5d1da80c4c46301b03cf3b + 3.01 KB / 3.01 KB [========================================================] 0s +Writing manifest to image destination +Storing signatures +``` + ## SEE ALSO kpod(1), kpod-pull(1), crio(8), crio.conf(5), docker-login(1) |