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

Примечание

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

Эта коллекция, возможно, уже установлена, если вы используете пакет 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 список / элементы=словарь	Позволяет добавлять и заменять файлы в ISO-файле. Будет создавать промежуточные папки внутри ISO-файла, если они не существуют. Значение по умолчанию: `[]`
dest_file строка / обязательно	Полный путь к файлу внутри ISO-файла.
src_file путь / обязательно	Путь с именем файла на машине, на которой выполняется модуль.
delete_files список / элементы=строка	Полные пути к файлам внутри ISO-файла, которые нужно удалить. Значение по умолчанию: `[]`
dest_iso путь / обязательно	Путь к настроенному ISO-файлу.
src_iso путь / обязательно	Это путь к исходному ISO-файлу.

Атрибуты

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

Примечания

Примечание

Библиотека pycdlib утверждает, что поддерживает Python 2.7 и 3.4+.
Функция 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 строка	Путь к настроенному ISO-файлу. Возвращается: при успехе Пример: `"/path/to/customized.iso"`
src_iso строка	Путь к исходному ISO-файлу. Возвращается: при успехе Пример: `"/path/to/file.iso"`

Авторы

Yuhua Zou (@ZouYuhua)

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

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