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 reg-
       istry.

SYNOPSIS
       buildah manifest	push  [options...]  listNameOrIndexName	 transport:de-
       tails

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 addi-
       tion 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  reg-
       istry.  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  en-
       tered 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 des-
       tination	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 im-
       ages to registry.

       Defaults	to 3.

       --retry-delay duration

       Duration	of delay between retry attempts	in case	of failure  when  per-
       forming 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 con-
       tainer 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),	 buil-
       dah-manifest-annotate(1),  buildah-manifest-inspect(1), buildah-rmi(1),
       docker-login(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+14.3.quarterly>

home | help