114 lines
3.7 KiB
Markdown
114 lines
3.7 KiB
Markdown
# buildah-manifest-push "1" "September 2019" "buildah"
|
|
|
|
## 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)
|