ngine_io.cloudstack.cs_iso – Управляет образами ISO на облаках на основе Apache CloudStack.
Примечание
Этот плагин является частью коллекции ngine_io.cloudstack (версия 1.1.0).
Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack.
Чтобы использовать его в книге задач, укажите: ngine_io.cloudstack.cs_iso.
Новое в версии 0.1.0: модуля ngine_io.cloudstack
Обзор
- Регистрация и удаление образов ISO.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| account строка | Аккаунт, к которому относится ISO. | |
| api_http_method строка |
| HTTP-метод, используемый для запроса к API-точке. Если не указано, используется переменная окружения CLOUDSTACK_METHOD.В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания. Значение по умолчанию get, если не указано. |
| api_key строка | API-ключ API CloudStack. Если не указано, используется переменная окружения CLOUDSTACK_KEY.В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания. | |
| api_region строка | По умолчанию: "cloudstack" | Имя раздела ini в файле cloustack.ini.Если не указано, используется переменная окружения CLOUDSTACK_REGION. |
| api_secret строка | Секретный ключ API CloudStack. Если не задано, используется переменная окружения CLOUDSTACK_SECRET.В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания. | |
| api_timeout целое число | Таймаут HTTP в секундах. Если не указано, используется переменная окружения CLOUDSTACK_TIMEOUT.В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания. Значение по умолчанию 10 секунд, если не указано. | |
| api_url строка | URL API CloudStack, например https://cloud.example.com/client/api. Если не указано, используется переменная окружения CLOUDSTACK_ENDPOINT.В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания. | |
| api_verify_ssl_cert строка | Файл сертификата CA. Если не указано, используется переменная окружения CLOUDSTACK_VERIFY.В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания. Значение по умолчанию null если не указано. | |
| bootable булево |
| Зарегистрировать ISO для загрузки. Используется только если параметр state задан. |
| checksum строка | Значение контрольной суммы MD5 этого ISO. Если задано, поиск выполняется по контрольной сумме вместо имени. | |
| cross_zones булево |
| Синхронизировать или удалить ISO в разных зонах. Взаимоисключающее с zone. |
| display_text строка | Текст для отображения ISO. Если не указано, используется name. | |
| domain строка | Домен, к которому относится ISO. | |
| is_dynamically_scalable булево |
| Зарегистрировать ISO с установленным инструментом XS/VMware для поддержки динамического масштабирования ЦП/памяти ВМ. Используется только если параметр state задан. |
| is_featured булево |
| Зарегистрировать ISO для отображения. Используется только если параметр state задан. |
| is_public булево |
| Зарегистрировать ISO для публичного доступа всем пользователям. Используется только если параметр state задан. |
| is_ready булево |
| Этот флаг используется для поиска существующих ISO. Если установлено значение yes, будут отображаться только ISO, готовые к развертыванию (например, успешно загруженные и установленные). Рекомендуется установить значение no. |
| iso_filter строка |
| Имя фильтра, используемого для поиска ISO. |
| name строка / обязательно | Имя ISO. | |
| os_type строка | Имя ОС, наиболее точно представляющее ОС этого ISO. Если ISO загрузочный, этот параметр необходим. Обязательно если параметр state задан. | |
| poll_async булево |
| Ожидать завершения асинхронных задач. |
| project строка | Имя проекта, в котором нужно зарегистрировать ISO. | |
| state строка |
| Состояние ISO. |
| tags список / элементы=словарь | Список тегов. Теги — список словарей с ключами key и value. Для удаления всех тегов установите пустой список, например tags: []. алиасы: тег | |
| url строка | URL, откуда можно загрузить ISO. Обязательно если параметр state задан. | |
| zone строка | Имя зоны, из которой необходимо зарегистрировать или удалить ISO. Если не указано, используется первая найденная зона. |
Примечания
Примечание
- Ansible использует метод конфигурации библиотеки
cs, если учетные данные не предоставлены аргументамиapi_url,api_key,api_secret. Конфигурация считывается из нескольких источников в следующем порядке.CLOUDSTACK_ENDPOINT,CLOUDSTACK_KEY,CLOUDSTACK_SECRETиCLOUDSTACK_METHOD. Переменные окруженияCLOUDSTACK_TIMEOUT. Переменная окруженияCLOUDSTACK_CONFIGуказывает на файл.ini. Файлcloudstack.iniв текущем рабочем каталоге. Файл.cloudstack.iniв домашнем каталоге пользователя. Допускается указание нескольких учетных данных и конечных точек с использованием разделов ini в файлеcloudstack.ini. Используйте аргументapi_regionдля выбора имени раздела, по умолчаниюcloudstack. Дополнительная информация на https://github.com/exoscale/cs. - Подробное руководство по модулям cloudstack можно найти в руководстве по CloudStack Cloud.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Register an ISO if ISO name does not already exist
ngine_io.cloudstack.cs_iso:
name: Debian 7 64-bit
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
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
state: absent
- name: Remove an ISO by checksum
ngine_io.cloudstack.cs_iso:
name: Debian 7 64-bit
checksum: 0b31bccccb048d20b551f70830bb7ad0
state: absent
Значения возврата
Общие значения возврата описаны в этой статье, а следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| account строка | успех | Аккаунт, к которому относится ISO. Пример: примерный аккаунт |
| bootable логическое | успех | Истинно, если ISO загрузочный. Пример: Истина |
| checksum строка | успех | MD5 контрольная сумма ISO. Пример: 0b31bccccb048d20b551f70830bb7ad0 |
| created строка | успех | Дата регистрации. Пример: 2015-03-29T14:57:06+0200 |
| cross_zones логическое | успех | Истина, если ISO управляется во всех зонах, ложь в противном случае. |
| display_text строка | успех | Текст для отображения ISO. Пример: Debian 7.7 64-битный минимальный 2015-03-19 |
| domain строка | успех | Домен, к которому относится ISO. Пример: примерный домен |
| format строка | успех | Формат ISO. Пример: ISO |
| id строка | успех | UUID ISO. Пример: a6f7a5fc-43f8-11e5-a151-feff819cdc9f |
| is_featured логическое | успех | Истина, если ISO выделена. Пример: Истина |
| is_public логическое | успех | Истина, если ISO общедоступна. Пример: Истина |
| is_ready логическое | успех | Истина, если ISO готова к развертыванию. Пример: Истина |
| name строка | успех | Название ISO. Пример: Debian 7 64-битный |
| os_type строка | успех | Тип ОС. Пример: CentOS 6.5 (64-битный) |
| project строка | успех | Проект, к которому относится ISO. Пример: примерный проект |
| status строка | успех | Статус ISO. Пример: Успешно установлено |
| tags словарь | успех | Список тегов ресурсов, связанных с ISO. Пример: [ { "ключ": "foo", "значение": "bar" } ] |
| zone строка | успех | Имя зоны, в которой зарегистрирована ISO. Пример: zuerich |
Авторы
- René Moser (@resmo)
© 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/ngine_io/cloudstack/cs_iso_module.html
