ngine_io.cloudstack.cs_iso модуль — Управление образами ISO в облаках на основе Apache CloudStack.
Примечание
Этот модуль входит в коллекцию ngine_io.cloudstack (версия 2.5.0).
Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install ngine_io.cloudstack. Для использования этого модуля требуются дополнительные условия, см. Требования для получения подробностей.
Чтобы использовать его в книге сценариев, укажите: ngine_io.cloudstack.cs_iso.
Добавлена в ngine_io.cloudstack 0.1.0
Описание
- Регистрация и удаление образов ISO.
Требования
Ниже перечислены требования, которые должны быть выполнены на хосте, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
Параметр | Комментарии |
|---|---|
account string | Учётная запись, к которой относится ISO. |
api_http_method string | HTTP-метод, используемый для запроса к конечному API-адресу. Если не указан, используется переменная окружения Варианты:
|
api_key string / required | API-ключ CloudStack API. Если не указан, используется переменная окружения |
api_secret string / required | Секретный ключ CloudStack API. Если не установлен, используется переменная окружения |
api_timeout integer | Таймаут HTTP в секундах. Если не указан, используется переменная окружения По умолчанию: |
api_url string / required | URL CloudStack API, например, https://cloud.example.com/client/api. Если не указан, используется переменная окружения |
api_verify_ssl_cert string | Проверка файла сертификата центра сертификации. Если не указан, используется переменная окружения |
bootable boolean | Зарегистрировать ISO как загрузочный. Используется только если state присутствует. Варианты:
|
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 присутствует. Варианты:
|
is_featured boolean | Зарегистрировать ISO как рекомендуемый. Используется только если state присутствует. Варианты:
|
is_public boolean | Зарегистрировать ISO как общедоступный для всех пользователей. Используется только если state присутствует. Варианты:
|
is_ready boolean | Этот флаг используется для поиска существующих ISO. Если установлен в Варианты:
|
iso_filter string | Имя фильтра, используемого для поиска ISO. Варианты:
|
name string / required | Имя ISO. |
os_type string | Имя ОС, которая наилучшим образом представляет ОС этого ISO. Если ISO загрузочный, этот параметр необходимо передать. Обязательно, если state присутствует. |
poll_async boolean | Опрашивать асинхронные задания, пока задание не завершится. Варианты:
|
project string | Имя проекта, в котором должен быть зарегистрирован ISO. |
state string | Состояние ISO. Выбираемые значения:
|
tags псевдонимы: tag список / элементы=словарь | Список тегов. Теги представляют собой список словарей с ключами key и value. Чтобы удалить все теги, установите пустой список, например, tags: []. |
url строка | URL, откуда можно загрузить ISO. Требуется, если state задан. |
validate_certs булево добавлено в ngine_io.cloudstack 2.4.0 | Если Если не указано, используется переменная среды Это следует использовать только на сайтах, контролируемых лично, с самоподписанными сертификатами. Выбираемые значения:
|
zone строка | Имя зоны, из которой вы хотите зарегистрировать или удалить ISO. Требуется, когда cross_zones |
Примечания
Примечание
- Подробное руководство по модулям cloudstack можно найти в Руководстве по облачным технологиям CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Register an ISO if ISO name does not already exist
ngine_io.cloudstack.cs_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.cs_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.cs_iso:
name: Debian 7 64-bit
zone: zone01
state: absent
- name: Remove an ISO by checksum
ngine_io.cloudstack.cs_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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/ngine_io/cloudstack/cs_iso_module.html