NAME

Podman-MANIFEST-PUSH-将清单列表或图像索引推送到注册表

SYNOPSIS

podman manifest push [options] listnameorindexname [destination]

DESCRIPTION

将清单列表或图像索引推送到注册表。

返回值

列表图像的ID和图像清单的摘要。

OPTIONS

--add-compression = compression

确保将为每个平台请求的压缩变体添加到清单列表中,使同一清单列表中的原始实例保持不变。支持的值包括 (gzipzstdzstd:chunked )。下面的标志可以多次使用。

请注意 --compression-format 控制清单列表中每个实例的压缩格式。 --add-compression 将为列表中具有指定压缩的每个实例添加另一个变量。 --compression-format GZIP --add-compression Zstd将推送一个清单列表,其中每个实例都用gzip压缩,每个实例的另一个变体用zstd压缩。

--all

推送清单列表或图像索引中提到的图像,以及列表或索引本身。(默认为True)

--authfile = path

身份验证文件的路径。缺省值为 ${XDG_RUNTIME_DIR}/containers/auth.json 在Linux上,以及 $HOME/.config/containers/auth.json 在Windows/MacOS上。该文件由创建 podman login 。如果在那里找不到授权状态, $HOME/.docker/config.json 被选中,它是使用 docker login

注意:还可以通过设置 REGISTRY_AUTH_FILE 环境变量这可以通过以下方式完成 export REGISTRY_AUTH_FILE=path

--cert-dir = path

在以下位置使用证书 path (\ *.crt, * .cert,\ *.key) to connect to the registry. (Default: /etc/containers/certs.d) For details, see * containers-certs.d(5) *。(此选项不适用于远程Podman客户端,包括Mac和Windows(不包括WSL2)计算机)

--compression-format = gzip | zstd | zstd:chunked

指定要使用的压缩格式。支持的值包括: gzipzstdzstd:chunked 。缺省值为 gzip 除非在tainers.conf文件中被覆盖。

--compression-level = level

指定要使用的压缩级别。该值特定于使用的压缩算法,例如,对于zstd,接受的值介于1-20(含)范围内,缺省值为3;而对于gZip,其值为1-9(含),缺省值为5。

--creds = [[用户名[:密码]]]

这个 [username[:password] ]如有需要,可用于向登记处进行认证。如果未提供其中一个或两个值,则会出现命令行提示符并可以输入值。输入密码时没有回显。

请注意,指定的凭据仅用于针对目标注册表进行身份验证。它们不用于镜像或在重写注册表时(请参见 containers-registries.conf(5) );要针对那些考虑使用 containers-auth.json(5) 文件。

--digestfile = 摘要文件

复制图像后,将生成图像的摘要写入文件。

--force-compression

如果设置,则推送使用指定的压缩算法,即使目标已包含不同压缩的变量。默认为 true 如果 --compression-format 在命令行上显式指定, false 否则的话。

--format-f = 格式化

推送列表时使用的清单列表类型(OCI或v2s2)(默认为OCI)。

--quiet-q

编写清单时,禁止显示进度输出

--remove-signatures

推送图片时请勿复制签名。

--rm

如果推送成功,则从本地存储中删除清单列表或图片索引。

--sign-by = 指纹

使用指定的密钥,对推送的图片进行简单签名。(此选项不适用于远程Podman客户端,包括Mac和Windows(不包括WSL2)计算机)

--sign-by-sigstore = param-file

根据容器的sigstore签名参数文件中指定的其他选项添加sigstore签名 param-file 。有关文件格式的详细信息,请参阅tainers-sigstore-sign-pars.yaml(5)。

--sign-by-sigstore-private-key = path

使用指定路径下的私钥,使用sigstore签名对推送的图片进行签名。(此选项不适用于远程Podman客户端,包括Mac和Windows(不包括WSL2)计算机)

--sign-passphrase-file = path

如果对图像进行签名(使用 --sign-by--sign-by-sigstore-private-key ),则从指定路径中读取要使用的密码短语。

--tls-verify

联系注册处时要求HTTPS并验证证书(默认: true )。如果显式设置为 true ,使用TLS验证。如果设置为 false ,不使用TLS验证。如果未指定,则使用TLS验证,除非目标注册表在 containers-registries.conf(5)

DESTINATION

Destination是容器镜像推送到的位置。它支持所有来自 containers-transports(5) 。如果未指定传输,则 docker (即,容器注册)传输被使用。对于远程客户端,包括Mac和Windows(不包括WSL2)计算机, docker 是唯一受支持的传输方式。

EXAMPLE

将清单列表推送到容器注册表:

podman manifest push mylist:v1.11 docker://registry.example.org/mylist:v1.11

另请参阅

podman(1)podman-manifest(1)containers-transports(5)