community.general.iso_create – Генерация ISO-файла со специфическими файлами или папками
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в playbook, укажите: community.general.iso_create.
Новое в версии 0.2.0: of community.general
Описание
- Этот модуль используется для генерации ISO-файла с указанным путем к файлам.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- pycdlib
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| dest_iso путь / обязательный | Абсолютный путь с именем нового сгенерированного ISO-файла на локальной машине. Будет создавать промежуточные папки, если они не существуют. | |
| interchange_level целое число |
1 | Уровень обмена ISO9660 для использования, он определяет правила по именам файлов. Уровни и допустимые значения 1, 2, 3, 4 поддерживаются.Значение по умолчанию - уровень 1, который является наиболее консервативным, уровень 3 рекомендуется.Имена файлов ISO9660 на уровне обмена 1 не могут содержать более 8 символов или 3 символа в расширении. |
| joliet целое число |
| Поддерживаемые уровни и допустимые значения - 1, 2, или 3.Уровень 3 является наиболее распространённым.Если не указано, то поддержка Joliet не добавляется. |
| rock_ridge строка |
| Нужно ли добавить расширения Rock Ridge в этот ISO? Допустимые значения - 1.09, 1.10 или 1.12, что означает добавление указанной версии Rock Ridge в ISO.Если не уверены, установите 1.09 для обеспечения максимальной совместимости.Если не указано, то расширение Rock Ridge в ISO не добавляется. |
| src_files список / элементы=путь / обязательный | Это список абсолютных путей исходных файлов или папок, которые будут содержаться в новом сгенерированном ISO-файле. Возникнет ошибка, если указанный файл или папка в src_files не существует на локальной машине.Примечание: со всеми уровнями ISO9660 от 1 до 3 все имена файлов ограничены заглавными буквами, цифрами и символом подчеркивания (_). Имена файлов ограничены 31 символом, вложенность каталогов ограничена 8 уровнями, а пути - 255 символами. | |
| udf булево |
| Нужно ли добавить поддержку UDF в этот ISO? Если установлено значение True, то используется версия 2.60 спецификации UDF.Если не указано или установлено значение False, то поддержка UDF не добавляется. |
| vol_ident строка | Строка идентификации тома для использования в новом сгенерированном ISO-образе. |
Примеры
- 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. |
| vol_ident строка | при успехе | Настроенная строка идентификации тома. Пример: OEMDRV |
Авторы
- Diane Wang (@Tomorrow9) <dianew@vmware.com>
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/iso_create_module.html
