Модуль community.general.iso_create — создание ISO-файла с указанными файлами или папками

Примечание

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

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

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

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

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

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

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

Этот модуль используется для создания ISO-файла с указанными путями к файлам.

Требования

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

pycdlib

Параметры

Параметр	Комментарии
dest_iso path / обязательный	Абсолютный путь с именем файла для нового ISO-файла на локальном компьютере. Создаёт промежуточные папки, если они не существуют.
interchange_level integer	Уровень обмена ISO9660, который определяет правила именования файлов. Поддерживаются уровни и допустимые значения `1`, `2`, `3`, `4`. По умолчанию используется уровень `1` — самый консервативный; рекомендуется уровень `3`. Имена файлов ISO9660 на уровне обмена `1` не могут содержать более 8 символов, а расширения — более 3 символов. Допустимые значения: `1` ← (по умолчанию) `2` `3` `4`
joliet integer	Поддерживаемые уровни и допустимые значения: `1`, `2` или `3`. Уровень `3` — наиболее распространённый. Если параметр не указан, поддержка Joliet не добавляется. Допустимые значения: `1` `2` `3`
rock_ridge string	Определяет, будут ли в ISO-файле использоваться расширения Rock Ridge. Допустимые значения: `1.09`, `1.10` или `1.12` — они добавляют в ISO указанные расширения Rock Ridge. Если вы не уверены, задайте `1.09`, чтобы обеспечить максимальную совместимость. Если параметр не указан, расширение Rock Ridge в ISO не добавляется. Допустимые значения: `"1.09"` `"1.10"` `"1.12"`
src_files list / elements=path / обязательный	Список абсолютных путей к исходным файлам или папкам, которые будут включены в новый ISO-файл. Модуль завершится с ошибкой, если указанный файл или папка в `src_files` не существует на локальном компьютере. Примечание: на всех уровнях ISO9660 от 1 до 3 имена файлов могут содержать только заглавные буквы, цифры и символы подчёркивания (_). Длина имён файлов ограничена 31 символом, вложенность каталогов — 8 уровнями, а длина путей — 255 символами.
udf boolean	Определяет, следует ли добавлять в ISO поддержку UDF. Если задано значение `true`, используется версия 2.60 спецификации UDF. Если параметр не указан или задано значение `false`, поддержка UDF не добавляется. Допустимые значения: `false` ← (по умолчанию) `true`
vol_ident string	Строка идентификатора тома для создаваемого ISO-образа.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: нет	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в `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 string	Путь к созданному ISO-файлу. Возвращается: при успешном выполнении Пример: `"/path/to/test.iso"`
interchange_level integer	Настроенный уровень обмена. Возвращается: при успешном выполнении Пример: `3`
joliet integer	Настроенный уровень поддержки Joliet. Возвращается: при успешном выполнении Пример: `3`
rock_ridge string	Настроенная версия Rock Ridge. Возвращается: при успешном выполнении Пример: `"1.09"`
source_file list / elements=path	Настроенный список исходных файлов или каталогов. Возвращается: при успешном выполнении Пример: `["/path/to/file.txt", "/path/to/folder"]`
udf boolean	Настроенная поддержка UDF. Возвращается: при успешном выполнении Пример: `false`
vol_ident string	Настроенная строка идентификатора тома. Возвращается: при успешном выполнении Пример: `"OEMDRV"`

Авторы

Diane Wang (@Tomorrow9)

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

© 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_create_module.html