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}/containers/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 compression  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 required.  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 destination 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 succeeds.

       --sign-by fingerprint

       Sign the pushed images using the GPG key that matches the specified fingerprint.

       --tls-verify bool-value

       Require  HTTPS  and verification of certificates when talking to container registries (defaults to true).
       TLS verification cannot be used when talking 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-create(1),  buildah-manifest-add(1),
       buildah-manifest-remove(1),  buildah-manifest-annotate(1),  buildah-manifest-inspect(1),  buildah-rmi(1),
       docker-login(1)

buildah                                          September 2019                         buildah-manifest-push(1)