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.

       --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)