Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
buildah-manifest-push(1)     General Commands Manual	buildah-manifest-push(1)

NAME
     buildah-manifest-push - Push a manifest list or image index to a registry.

SYNOPSIS
     buildah manifest push [options...] listNameOrIndexName transport:details

DESCRIPTION
     Pushes a manifest list or image index to a registry.

RETURN VALUE
     The list image's ID and the digest of the image's manifest.

OPTIONS
     --add-compression compression

     Makes sure that requested compression variant for each platform is added to
     the  manifest  list  keeping  original instance intact in the same manifest
     list. Supported values are (gzip, zstd and zstd:chunked)

     Note: This is different than --compression which replaces the instance with
     requested with specified compression  while  --add-compression  makes  sure
     than  each instance has it variant added to manifest list without modifying
     the original instance.

     --all

     Push the images mentioned in the manifest list or image index, in	addition
     to the list or index itself. (Default true)

     --authfile path

     Path  of  the  authentication  file. Default is ${XDG_RUNTIME_DIR}/contain-
     ers/auth.json, which is set using	buildah  login.   If  the  authorization
     state  is	not  found there, $HOME/.docker/config.json is checked, which is
     set using docker login.

     --cert-dir path

     Use certificates at path (*.crt, *.cert, *.key) to connect to the registry.
     The default certificates directory is /etc/containers/certs.d.

     --compression-format format

     Specifies the compression format to use.  Supported values are: gzip,  zstd
     and zstd:chunked.

     --compression-level level

     Specify the compression level used with the compression.

     Specifies	the compression level to use.  The value is specific to the com-
     pression algorithm used, e.g. for zstd the accepted values are in the range
     1-20 (inclusive), while for gzip it is 1-9 (inclusive).

     --creds creds

     The [username[:password]] to use to authenticate with the registry  if  re-
     quired.  If one or both values are not supplied, a command line prompt will
     appear and the value can be entered.  The password is entered without echo.

     --digestfile Digestfile

     After  copying  the  image,  write the digest of the resulting image to the
     file.

     --force-compression

     If set, push uses the specified compression algorithm even if the	destina-
     tion  contains  a differently-compressed variant already.	Defaults to true
     if --compression-format is explicitly specified on the command-line,  false
     otherwise.

     --format, -f

     Manifest  list  type (oci or v2s2) to use when pushing the list (default is
     oci).

     --quiet, -q

     Don't output progress information when pushing lists.

     --remove-signatures

     Don't copy signatures when pushing images.

     --retry attempts

     Number of times to retry in case of failure when performing push of  images
     to registry.

     Defaults to 3.

     --retry-delay duration

     Duration of delay between retry attempts in case of failure when performing
     push of images to registry.

     Defaults to 2s.

     --rm

     Delete  the manifest list or image index from local storage if pushing suc-
     ceeds.

     --sign-by fingerprint

     Sign the pushed images using the GPG key that matches the specified finger-
     print.

     --tls-verify bool-value

     Require HTTPS and verification of certificates when  talking  to  container
     registries  (defaults to true).  TLS verification cannot be used when talk-
     ing to an insecure registry.

EXAMPLE
     buildah manifest push mylist:v1.11 registry.example.org/mylist:v1.11

SEE ALSO
     buildah(1),  buildah-login(1),  buildah-manifest(1),  buildah-manifest-cre-
     ate(1),  buildah-manifest-add(1), buildah-manifest-remove(1), buildah-mani-
     fest-annotate(1), buildah-manifest-inspect(1),  buildah-rmi(1),  docker-lo-
     gin(1)

buildah 			 September 2019 	buildah-manifest-push(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=buildah-manifest-push&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help