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

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.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 path / обязательно	Абсолютный путь с именем файла нового сгенерированного ISO-файла на локальной машине. Будут созданы промежуточные папки, если они не существуют.
interchange_level целое число	Уровень обмена ISO9660, который используется; он определяет правила именования файлов. Поддерживаются уровни и допустимые значения `1`, `2`, `3`, `4`. Значение по умолчанию – уровень `1`, который является наиболее консервативным; рекомендуется уровень `3`. Имена файлов ISO9660 на уровне обмена `1` не могут содержать более 8 символов или 3 символов в расширении. Варианты: `1` ← (по умолчанию) `2` `3` `4`
joliet целое число	Уровни поддержки и допустимые значения: `1`, `2` или `3`. Уровень `3` является наиболее распространенным. Если не указано, то поддержка Joliet не добавляется. Варианты: `1` `2` `3`
rock_ridge строка	Добавлять ли расширения Rock Ridge в этот ISO-образ или нет. Допустимые значения: `1.09`, `1.10` или `1.12`, означает добавление указанной версии Rock Ridge в ISO-образ. Если не уверены, установите `1.09`, чтобы обеспечить максимальную совместимость. Если не указано, то расширение Rock Ridge не добавляется в ISO-образ. Варианты: `"1.09"` `"1.10"` `"1.12"`
src_files список / элементы=path / обязательно	Это список абсолютных путей исходных файлов или папок, которые будут содержаться в новом сгенерированном ISO-файле. Возникнет ошибка, если указанный файл или папка в `src_files` не существует на локальной машине. Примечание: На всех уровнях ISO9660 от 1 до 3 все имена файлов ограничены прописными буквами, цифрами и символом подчеркивания (_). Имена файлов ограничены 31 символом, вложенность каталогов ограничена 8 уровнями, а имена путей ограничены 255 символами.
udf булево	Добавлять ли поддержку UDF в этот ISO-образ. Если установлено `true`, то используется версия 2.60 спецификации UDF. Если не указано или установлено `false`, то поддержка UDF не добавляется. Варианты: `false` ← (по умолчанию) `true`
vol_ident строка	Идентификационная строка тома, используемая в новом сгенерированном образе ISO.

Атрибуты

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

Примеры

- 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)

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

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