containers.podman.podman_save 模块 – 将 Podman 镜像保存到 tar 文件

注意

此模块是 containers.podman 集合 (版本 1.16.2) 的一部分。

如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install containers.podman。您需要满足其他要求才能使用此模块，有关详细信息，请参阅 要求。

要在 playbook 中使用它，请指定： containers.podman.podman_save。

概要

  • podman save 将镜像保存到本地机器上的 docker-archive、oci-archive、oci-dir（包含 oci 清单类型的目录）或 docker-dir（包含 v2s2 清单类型的目录），默认值为 docker-archive。

要求

以下是执行此模块的主机所需的条件。

  • 主机上安装了 Podman

参数

参数

注释

compress

布尔值

使用“dir”传输将镜像层压缩到目录时压缩 tarball 镜像层。（默认为与源相同的压缩类型，压缩或未压缩）

选项

  • false

  • true

dest

别名：path

字符串 / 必填

写入镜像的目标文件。

executable

字符串

podman 可执行文件的路径（如果它不在运行 podman 的机器上的 $PATH 中）

默认值： "podman"

force

布尔值

即使文件存在，也强制保存到文件。

选项

  • false

  • true ← (默认)

format

字符串

将镜像保存为 docker-archive、oci-archive（参见 containers-transports(5)）、oci-dir（oci 传输）或 docker-dir（具有 v2s2 清单类型的 dir 传输）。

选项

  • "docker-archive"

  • "oci-archive"

  • "oci-dir"

  • "docker-dir"

image

列表 / 元素=字符串 / 必填

要保存的镜像。

multi_image_archive

布尔值

允许创建包含多个镜像的存档。其他名称将被解释为镜像而不是标签。仅支持 docker-archive。

选项

  • false

  • true

示例

# What modules does for example
- containers.podman.podman_save:
    image: nginx
    dest: /tmp/file123.tar
- containers.podman.podman_save:
    image:
      - nginx
      - fedora
    dest: /tmp/file456.tar
    multi_image_archive: true

作者

  • Sagi Shnaidman (@sshnaidm)