From 1e7d880b561318aa2ad89d7583addad1904e5a36 Mon Sep 17 00:00:00 2001 From: umohnani8 Date: Tue, 12 Dec 2017 13:33:10 -0500 Subject: 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 Closes: #126 Approved by: rhatdan --- docs/kpod-push.1.md | 32 ++++++++++++++++++++++++++++---- 1 file changed, 28 insertions(+), 4 deletions(-) (limited to 'docs') 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) -- cgit v1.2.3-54-g00ecf