NAME

Podman-清单-添加-将图像或项目添加到清单列表或图像索引

SYNOPSIS

podman manifest add [options] listnameorindexname [transport]:imagename imageorartifactname [...]

DESCRIPTION

将指定的图像添加到指定的清单列表或图像索引，或者创建项目清单并将其添加到指定的图像索引。

返回值

列表图像的ID。

OPTIONS

--all

如果添加到列表或索引的图像本身是列表或索引，则将所有内容添加到本地列表。默认情况下，仅将此类列表或索引中的一个图像添加到该列表或索引中。组合 --all 不推荐使用下面描述的任何其他选项。

--annotation = annotation=value

在指定图像或构件的条目上设置批注。

--arch = architecture

覆盖列表或索引记录为映像要求的体系结构。如果 imageName 指的是清单列表或图像索引，从其中检索架构信息。否则，将从映像的配置信息中检索它。

--artifact

创建构件清单并将其添加到图像索引。索引名之后的参数将被解释为文件名，而不是图像引用。在大多数情况下， --artifact-type 选项也应指定。

--artifact-config = path

在创建构件清单并将其添加到图像索引时，请使用指定文件的内容作为构件清单中的配置BLOB。在大多数情况下，保留表示空配置的默认值不变是首选选项。

--artifact-config-type = type

在创建构件清单并将其添加到图像索引时，请使用指定的MIME类型作为 mediaType 与项目清单中的配置Blob关联。在大多数情况下，保留表示空配置或标准OCI配置类型的默认值是首选选项。

--artifact-exclude-titles

在创建构件清单并将其添加到图像索引时，不要为添加到构件清单的每个文件设置等于文件基本名称的“org.Opentainers.Image.title”注释。在将对象保存到磁盘时，从注册表检索对象的工具可能会使用这些值来选择文件的名称，因此，除非需要与特定注册表进行互操作，否则不建议使用此选项。

--artifact-layer-type = type

在创建构件清单并将其添加到图像索引时，请使用指定的MIME类型作为 mediaType 与文件内容相关联。如果未指定，则将根据文件名或其内容进行猜测并使用，但如果需要确定性，则应指定该选项。

--artifact-subject = imageName

在创建构件清单并将其添加到图像索引时，将 subject 字段将对象清单标记为以某种方式与指定图像相关联。一个构件清单最多只能与一个主题相关联。

--artifact-type = type

在创建构件清单时，使用指定的MIME类型作为清单的 artifactType 值，而不是信息量较小的默认值。

--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) 文件。

--features = feature

指定列表或索引记录为图像要求的要素列表。此选项很少使用。

--os = OS

覆盖列表或索引记录为映像要求的操作系统。如果 imagename 是指清单列表或映像索引，从其中检索操作系统信息。否则，将从映像的配置信息中检索它。

--os-version = version

指定列表或索引记录为映像要求的操作系统版本。此选项很少使用。

--tls-verify

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

--variant

指定列表或索引为图像记录的变量。此选项通常用于区分共享相同架构值但需要不同版本的指令集的多个条目。

运输

支持多种传输：

docker:// docker-参考 (default) 注册表中实现“Docker注册表HTTP API V2”的图像。默认情况下，使用 $XDG_RUNTIME_DIR/containers/auth.json ，它是使用以下设置的 (podman login) 。如果在那里找不到授权状态， $HOME/.docker/config.json 被选中，它是使用 (docker login) 。

$ podman manifest add mylist:v1.11 docker://quay.io/username/myimage

containers-storage: _OCI-参考_中的图像 oci-reference 存储在本地容器存储中的格式。 oci-reference 必须包含标记。

$ podman manifest add mylist:v1.11 containers-storage:quay.io/username/myimage

dir: _PATH_现有本地目录 path 将清单、层tarball和签名存储为单独的文件。这是一种非标准化格式，主要用于调试或非侵入性容器检查。

$ podman manifest add dir:/tmp/myimage

docker-archive: path [:docker-reference] 图像存储在 docker save 格式化的文件。 docker-reference 仅在创建此类文件时使用，并且不能包含摘要。

$ podman manifest add docker-archive:/tmp/myimage

docker-daemon: _docker-引用_中的图像 docker-reference 存储在停靠器守护程序内部存储器中的格式。这个 docker-reference 也可以是镜像ID(docker-daemon：algo：digest)。

$ sudo podman manifest add docker-daemon:docker.io/library/myimage:33

oci-archive: path : _TAG_A图像 tag 在符合《开放式容器图像布局规范》的目录中 path.

$ podman manifest add oci-archive:/tmp/myimage

EXAMPLE

将指定的默认图像从源清单列表添加到目标清单列表：

podman manifest add mylist:v1.11 docker://fedora
71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965

将源Manfest列表中的所有图像添加到目标清单列表：

podman manifest add --all mylist:v1.11 docker://fedora
71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965

将源清单列表中的所选图像匹配Arch和Variant添加到目标清单列表：

podman manifest add --arch arm64 --variant v8 mylist:v1.11 docker://71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965

另请参阅

[podman(1)] ， [podman-manifest(1)]