名称

podman-artifact-extract - 将 OCI 工件提取到本地路径

简介

podman artifact extract 工件 目标

描述

将 OCI 工件的 blob 提取到本地文件或目录。

如果目标路径是文件或不存在，则工件必须仅包含一个 blob（层），或者如果它有多个 blob（层），则必须使用 --digest 或 --title 选项来仅选择单个 blob。如果文件已存在，它将被覆盖。

如果目标是目录（它必须存在），则所有 blob 都将复制到目标目录。目标文件名使用 org.opencontainers.image.title 注释中的值。如果缺少该注释，则目标文件名将是 blob 的摘要（名称中的 : 将替换为 -）。如果目标文件在目录中已存在，它将被覆盖。

选项

--digest=摘要

从工件中提取 blob 时，仅使用指定摘要的那个。如果目标是目录，即使 blob 上存在标题注释，摘要也始终用作文件名。与 --title 冲突。

--help

打印使用说明。

--title=标题

从工件中提取 blob 时，仅使用指定标题的那个。它查找 org.opencontainers.image.title 注释并将其与给定标题进行比较。与 --digest 冲突。

示例

提取包含单个 blob 的工件

$ podman artifact extract quay.io/artifact/foobar1:test /tmp/myfile

提取包含多个 blob 的工件

$ podman artifact extract quay.io/artifact/foobar2:test /tmp/mydir
$ ls /tmp/mydir
CONTRIBUTING.md  README.md

从包含多个 blob 的工件中仅提取单个 blob

$ podman artifact extract --title README.md quay.io/artifact/foobar2:test /tmp/mydir
$ ls /tmp/mydir
README.md

或者使用摘要而不是标题

$ podman artifact extract --digest sha256:c0594e012b17fd9e6548355ceb571a79613f7bb988d7d883f112513601ac6e9a quay.io/artifact/foobar2:test /tmp/mydir
$ ls /tmp/mydir
README.md

另请参阅

podman(1), podman-artifact(1)

历史

2025 年 2 月，最初由 Paul Holzinger pholzing@redhat.com 编译