Модуль ngine_io.cloudstack.iso — управление ISO-образами в облаках на базе Apache CloudStack.
Примечание
Этот модуль входит в коллекцию ngine_io.cloudstack (версия 3.0.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install ngine_io.cloudstack. Для использования этого модуля необходимы дополнительные компоненты. Подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: ngine_io.cloudstack.iso.
Добавлено в ngine_io.cloudstack 0.1.0
Краткое описание
- Регистрация и удаление ISO-образов.
Псевдонимы: cs_iso
Требования
Следующие требования необходимы на хосте, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
Параметр | Комментарии |
|---|---|
account string | Учетная запись, с которой связан ISO-образ. |
api_http_method string | Метод HTTP, используемый для запроса к конечной точке API. Если параметр не задан, используется переменная окружения Варианты:
|
api_key string / обязательный | Ключ API CloudStack. Если параметр не задан, используется переменная окружения |
api_secret string / обязательный | Секретный ключ API CloudStack. Если параметр не задан, используется переменная окружения |
api_timeout integer | Тайм-аут HTTP в секундах. Если параметр не задан, используется переменная окружения По умолчанию: |
api_url string / обязательный | URL API CloudStack, например https://cloud.example.com/client/api. Если параметр не задан, используется переменная окружения |
api_verify_ssl_cert string | Проверять файл сертификата центра сертификации. Если параметр не задан, используется переменная окружения |
bootable boolean | Зарегистрировать ISO-образ как загрузочный. Используется только, если state имеет значение present. Варианты:
|
checksum string | Контрольная сумма MD5 этого ISO-образа. Если задана, поиск выполняется по контрольной сумме, а не по имени. |
cross_zones boolean | Следует ли синхронизировать ISO-образ между зонами или удалять его из всех зон. Не может использоваться одновременно с zone. Варианты:
|
display_text string | Отображаемый текст ISO-образа. Если не указан, будет использоваться name. |
domain string | Домен, с которым связан ISO-образ. |
is_dynamically_scalable boolean | Зарегистрировать ISO-образ с установленными инструментами XS/VMware для поддержки динамического масштабирования ЦП/памяти виртуальной машины. Используется только, если state имеет значение present. Варианты:
|
is_featured boolean | Зарегистрировать ISO-образ как рекомендуемый. Используется только, если state имеет значение present. Варианты:
|
is_public boolean | Зарегистрировать ISO-образ как общедоступный для всех пользователей. Используется только, если state имеет значение present. Варианты:
|
is_ready boolean | Этот флаг используется при поиске существующих ISO-образов. Если задано значение Варианты:
|
iso_filter string | Имя фильтра для поиска ISO-образа. Варианты:
|
name string / обязательный | Имя ISO-образа. |
os_type string | Имя ОС, наиболее точно соответствующей ОС этого ISO-образа. Если ISO-образ является загрузочным, этот параметр необходимо указать. Обязателен, если state имеет значение present. |
poll_async boolean | Ожидать завершения асинхронных заданий, опрашивая их состояние. Варианты:
|
project string | Имя проекта, в котором будет зарегистрирован ISO-образ. |
state string | Состояние ISO-образа. Варианты:
|
tags псевдонимы: tag list / элементы=dictionary | Список тегов. Теги представляют собой список словарей с ключами key и value. Чтобы удалить все теги, задайте пустой список, например tags: []. |
url string | URL, по которому можно скачать ISO-образ. Обязателен, если state имеет значение present. |
validate_certs boolean добавлено в ngine_io.cloudstack 2.4.0 | Если задано значение Если параметр не задан, используется переменная окружения Используйте этот параметр только на сайтах под вашим управлением, использующих самоподписанные сертификаты. Варианты:
|
zone string | Имя зоны, в которой необходимо зарегистрировать или удалить ISO-образ. Обязателен, если cross_zones имеет значение |
Примечания
Примечание
- Подробное руководство по модулям CloudStack см. в руководстве по облаку CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Register an ISO if ISO name does not already exist
ngine_io.cloudstack.iso:
name: Debian 7 64-bit
zone: zone01
url: http://mirror.switch.ch/ftp/mirror/debian-cd/current/amd64/iso-cd/debian-7.7.0-amd64-netinst.iso
os_type: Debian GNU/Linux 7(64-bit)
- name: Register an ISO with given name if ISO md5 checksum does not already exist
ngine_io.cloudstack.iso:
name: Debian 7 64-bit
zone: zone01
url: http://mirror.switch.ch/ftp/mirror/debian-cd/current/amd64/iso-cd/debian-7.7.0-amd64-netinst.iso
os_type: Debian GNU/Linux 7(64-bit)
checksum: 0b31bccccb048d20b551f70830bb7ad0
- name: Remove an ISO by name
ngine_io.cloudstack.iso:
name: Debian 7 64-bit
zone: zone01
state: absent
- name: Remove an ISO by checksum
ngine_io.cloudstack.iso:
name: Debian 7 64-bit
zone: zone01
checksum: 0b31bccccb048d20b551f70830bb7ad0
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
account string | Учетная запись, с которой связан ISO-образ. Возвращается: при успехе Пример: |
bootable boolean | True, если ISO-образ является загрузочным. Возвращается: при успехе Пример: |
checksum string | Контрольная сумма MD5 ISO-образа. Возвращается: при успехе Пример: |
created string | Дата регистрации. Возвращается: при успехе Пример: |
cross_zones boolean | true, если ISO-образ управляется во всех зонах; в противном случае false. Возвращается: при успехе Пример: |
display_text string | Отображаемый текст ISO-образа. Возвращается: при успехе Пример: |
domain string | Домен, с которым связан ISO-образ. Возвращается: при успехе Пример: |
format string | Формат ISO-образа. Возвращается: при успехе Пример: |
id string | UUID ISO-образа. Возвращается: при успехе Пример: |
is_featured boolean | True, если ISO-образ отмечен как рекомендуемый. Возвращается: при успехе Пример: |
is_public boolean | True, если ISO-образ является общедоступным. Возвращается: при успехе Пример: |
is_ready boolean | True, если ISO-образ готов к развертыванию. Возвращается: при успехе Пример: |
name string | Имя ISO-образа. Возвращается: при успехе Пример: |
os_type string | Тип ОС. Возвращается: при успехе Пример: |
project string | Проект, с которым связан ISO-образ. Возвращается: при успехе Пример: |
status string | Состояние ISO-образа. Возвращается: при успехе Пример: |
tags dictionary | Список тегов ресурса, связанных с ISO-образом. Возвращается: при успехе Пример: |
zone string | Имя зоны, в которой зарегистрирован ISO-образ. Возвращается: при успехе Пример: |
Ссылки на коллекцию
© 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/ngine_io/cloudstack/iso_module.html