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

boolean

当使用 ‘dir’ 传输推送到目录时，压缩 tarball 镜像层。（默认与源的压缩类型相同，压缩或未压缩）

选项

  • false

  • true

dest

别名: path

string / 必选

写入镜像的目标文件。

executable

string

如果 podman 可执行文件不在运行 podman 的机器上的 $PATH 中，则指定其路径

默认值: "podman"

force

boolean

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

选项

  • false

  • true ← (默认)

format

string

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

选项

  • "docker-archive"

  • "oci-archive"

  • "oci-dir"

  • "docker-dir"

image

list / elements=string / 必选

要保存的镜像。

multi_image_archive

boolean

允许创建包含多个镜像的存档。其他名称将被解释为镜像而不是标签。仅支持 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)