更改文件

注意

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

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

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

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

community.general 5.8.0 中的新增功能

概要 

此模块用于在 ISO 文件中添加/删除/更改文件。
如果文件存在，则 ISO 中的文件将被选项 add_files 覆盖。

要求 

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

pycdlib

参数 

参数	注释
add_files 列表 / 元素=字典	允许在 ISO 文件中添加和替换文件。当 ISO 文件中不存在中间文件夹时，将创建它们。默认值： `[]`
dest_file 字符串 / 必需	ISO 文件中文件的绝对路径。
src_file 路径 / 必需	在执行模块的计算机上的带有文件名的路径。
delete_files 列表 / 元素=字符串	应该删除的 ISO 文件中文件的绝对路径。默认值： `[]`
dest_iso 路径 / 必需	自定义 ISO 文件的路径。
src_iso 路径 / 必需	这是源 ISO 文件的路径。

属性 

属性	支持	描述
check_mode	支持：完整	可以在 `check_mode` 中运行并返回更改的状态预测，而无需修改目标。
diff_mode	支持：无	当处于 diff 模式时，将返回有关已更改内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

注意 

注意

pycdlib 库声明它支持 Python 2.7 和 3.4+。
pycdlib 中的函数 add_file 将覆盖 ISO 中类型为 ISO9660 / Rock Ridge 1.12 / Joliet / UDF 的现有文件。但是它不会覆盖 ISO 中类型为 Rock Ridge 1.09 / 1.10 的现有文件。因此，我们采取变通方法“删除现有文件，然后为带有 Rock Ridge 的 ISO 添加文件”。

示例 

- name: "Customize ISO file"
  community.general.iso_customize:
    src_iso: "/path/to/ubuntu-22.04-desktop-amd64.iso"
    dest_iso: "/path/to/ubuntu-22.04-desktop-amd64-customized.iso"
    delete_files:
      - "/boot.catalog"
    add_files:
      - src_file: "/path/to/grub.cfg"
        dest_file: "/boot/grub/grub.cfg"
      - src_file: "/path/to/ubuntu.seed"
        dest_file: "/preseed/ubuntu.seed"
  register: customize_iso_result

返回值 

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

键	描述
dest_iso 字符串	自定义 ISO 文件的路径。返回：成功时示例： `"/path/to/customized.iso"`
src_iso 字符串	源 ISO 文件的路径。返回：成功时示例： `"/path/to/file.iso"`

作者

Yuhua Zou (@ZouYuhua)