community.general.iso_create – Генерация файла ISO со специфицированными файлами или папками
Примечание
Этот плагин является частью коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в плейбуке укажите: community.general.iso_create.
Новое в версии 0.2.0: коллекции 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/iso_create_module.html
