community.general.iso_create 模块 – 使用指定文件或文件夹生成 ISO 文件

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

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

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

要在 playbook 中使用它，请指定：community.general.iso_create。

community.general 0.2.0 中的新增功能

概要

  • 此模块用于使用指定文件路径生成 ISO 文件。

需求

执行此模块的主机需要以下需求。

  • pycdlib

参数

参数

注释

dest_iso

路径 / 必需

本地计算机上新生成的 ISO 文件的绝对路径和文件名。

当中间文件夹不存在时，将创建它们。

interchange_level

整数

要使用的 ISO9660 交换级别，它决定了文件名的规则。

支持的级别和有效值：1、2、3、4。

默认值为级别 1，这是最保守的级别，推荐使用级别 3。

在交换级别 1 下，ISO9660 文件名不能超过 8 个字符，扩展名不能超过 3 个字符。

选项

  • 1 ← (默认)

  • 2

  • 3

  • 4

joliet

整数

支持的级别和有效值是 1、2 或 3。

级别 3 是迄今为止最常见的级别。

如果未指定，则不添加 Joliet 支持。

选项

  • 1

  • 2

  • 3

rock_ridge

字符串

是否使此 ISO 具有 Rock Ridge 扩展。

有效值为 1.09、1.10 或 1.12，表示将指定的 Rock Ridge 版本添加到 ISO。

如果不确定，请设置为 1.09 以确保最大兼容性。

如果未指定，则不向 ISO 添加 Rock Ridge 扩展。

选项

  • "1.09"

  • "1.10"

  • "1.12"

src_files

列表 / 元素=路径 / 必需

这是一个源文件或文件夹的绝对路径列表，这些文件或文件夹将包含在新生成的 ISO 文件中。

如果 src_files 中指定的文件或文件夹在本地计算机上不存在，则将失败。

注意：对于 1 到 3 的所有 ISO9660 级别，所有文件名都限制为大写字母、数字和下划线 (_) 。文件名限制为 31 个字符，目录嵌套限制为 8 个级别，路径名限制为 255 个字符。

udf

布尔值

是否向此 ISO 添加 UDF 支持。

如果设置为 true，则使用 UDF 规范的 2.60 版。

如果未指定或设置为 false，则不添加 UDF 支持。

选项

  • false ← (默认)

  • true

vol_ident

字符串

在新生成的ISO镜像中使用的卷标识字符串。

属性

属性

支持

描述

check_mode

支持：完全支持

可以在check_mode下运行，并在不修改目标的情况下返回更改状态预测。

diff_mode

支持：不支持

在差异模式下，将返回有关已更改内容（或可能需要在check_mode下更改的内容）的详细信息。

示例

- name: Create an ISO file
  community.general.iso_create:
    src_files:
      - /root/testfile.yml
      - /root/testfolder
    dest_iso: /tmp/test.iso
    interchange_level: 3

- name: Create an ISO file with Rock Ridge extension
  community.general.iso_create:
    src_files:
      - /root/testfile.yml
      - /root/testfolder
    dest_iso: /tmp/test.iso
    rock_ridge: 1.09

- name: Create an ISO file with Joliet support
  community.general.iso_create:
    src_files:
      - ./windows_config/Autounattend.xml
    dest_iso: ./test.iso
    interchange_level: 3
    joliet: 3
    vol_ident: WIN_AUTOINSTALL

返回值

常见的返回值已在此处记录，以下是此模块独有的字段

键

描述

created_iso

字符串

生成的ISO文件路径。

返回：成功时

示例："/path/to/test.iso"

interchange_level

整数

配置的交换级别。

返回：成功时

示例：3

joliet

整数

配置的Joliet支持级别。

返回：成功时

示例：3

rock_ridge

字符串

配置的Rock Ridge版本。

返回：成功时

示例："1.09"

source_file

列表 / 元素=路径

配置的源文件或目录列表。

返回：成功时

示例：["/path/to/file.txt", "/path/to/folder"]

udf

布尔值

配置的UDF支持。

返回：成功时

示例：false

vol_ident

字符串

配置的卷标识字符串。

返回：成功时

示例："OEMDRV"

作者

  • 王黛安 (@Tomorrow9)