警告：实验命令

This command is considered experimental and still in development. Inputs, options, and outputs are all subject to change.

NAME

podman-artifact-pull -从注册表中提取一个artifact并将其存储在本地

SYNOPSIS

podman artifact pull [options] source

DESCRIPTION

podman工件拉取将工件从注册表复制到本地机器上。

SOURCE

Source是获取伪影图像的位置。

# Pull from a registry
$ podman artifact pull quay.io/foobar/artifact:special

OPTIONS

--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)计算机)

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

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

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

--decryption-key = [Key[：密码短语]]

这个 [key[:passphrase] ]用于图像解密。密钥可以指向密钥和/或证书。尝试使用所有密钥进行解密。如果密钥受密码短语保护，则需要在参数中传递该密钥，否则将被省略。

--help ， -h

打印用法说明。

--quiet ， -q

在拉取图像时抑制输出信息

--retry = attempts

失败时在注册表和本地存储之间重试拉取或推送映像的次数。缺省值为 3 。

--retry-delay = duration

如果失败，在注册表和本地存储之间拉取或推送图像时，重试尝试之间的延迟持续时间。默认情况下，开始时间为两秒，然后以指数方式后退。设置此值时使用延迟，并且不会发生指数回退。

--tls-verify

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

FILES

EXAMPLES

从注册表中提取工件

podman artifact pull quay.io/baude/artifact:josey
Getting image source signatures
Copying blob e741c35a27bb done   |
Copying config 44136fa355 done   |
Writing manifest to image destination

另请参阅

podman(1) , podman-artifact(1) , podman-login(1) , containers-certs.d(5)

故障排除

看到 [podman-troubleshooting(7)] （https：//github.com/containers/podman/blob/main/outloting.MD）获取常见问题的解决方案。

HISTORY

2025年1月，最初由Brent Baude编写bbaude@redhat.com