Модуль community.general.iso_customize — добавление, удаление и изменение файлов в ISO-файле

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.general.iso_customize.

Добавлено в community.general 5.8.0

Краткое описание
Требования
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль используется для добавления, удаления и изменения файлов в ISO-файле.
Существующий файл в ISO перезаписывается, если задан параметр add_files.

Требования

На узле, выполняющем этот модуль, необходимы следующие компоненты.

pycdlib

Параметры

Параметр	Комментарии
add_files list / elements=dictionary	Позволяет добавлять и заменять файлы в ISO-файле. Если промежуточные папки в ISO-файле отсутствуют, они создаются. По умолчанию: `[]`
dest_file string / обязательный	Абсолютный путь к файлу внутри ISO-файла.
src_file path / обязательный	Путь и имя файла на машине, где выполняется модуль.
delete_files list / elements=string	Абсолютные пути к файлам внутри ISO-файла, которые следует удалить. По умолчанию: `[]`
dest_iso path / обязательный	Путь к настроенному ISO-файлу.
src_iso path / обязательный	Путь к исходному ISO-файлу.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз статуса изменений, не изменяя целевой узел.
diff_mode	Поддержка: нет	В режиме diff возвращает сведения об изменениях (или возможных изменениях в `check_mode`).

Примечания

Примечание

Функция add_file в pycdlib предназначена для перезаписи существующего файла в ISO с типом ISO9660 / Rock Ridge 1.12 / Joliet / UDF. Однако она не перезаписывает существующий файл в ISO с Rock Ridge 1.09 / 1.10. Поэтому мы используем обходное решение: «удалить существующий файл, а затем добавить файл в ISO с Rock Ridge».

Примеры

- 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 string	Путь к настроенному ISO-файлу. Возвращается: при успехе Пример: `"/path/to/customized.iso"`
src_iso string	Путь к исходному ISO-файлу. Возвращается: при успехе Пример: `"/path/to/file.iso"`

Авторы

Yuhua Zou (@ZouYuhua)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/iso_customize_module.html