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` 以确保最大的兼容性。如果未指定，则不将 Rock Ridge 扩展添加到 ISO。选择 `"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"`

作者

Diane Wang (@Tomorrow9)