ngine_io.cloudstack.cs_service_offering – Управляет предложениями сервиса в облаках на основе Apache CloudStack.
Примечание
Этот плагин является частью коллекции ngine_io.cloudstack (версия 2.0.0).
Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack.
Для использования в playbook укажите: ngine_io.cloudstack.cs_service_offering.
Новое в версии 0.1.0: плагина ngine_io.cloudstack
Обзор
- Создание и удаление предложений сервиса для виртуальных машин гостя и системы.
- Обновление отображаемого текста существующего предложения сервиса.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_http_method строка |
| HTTP-метод, используемый для запроса к API-точке входа. Если не указан, рассматривается переменная среды CLOUDSTACK_METHOD. |
| api_key строка / обязательно | API-ключ CloudStack API. Если не указан, рассматривается переменная среды CLOUDSTACK_KEY. | |
| api_secret строка / обязательно | Секретный ключ CloudStack API. Если не задан, рассматривается переменная среды CLOUDSTACK_SECRET. | |
| api_timeout целое число | По умолчанию: 10 | Тайм-аут HTTP в секундах. Если не задан, рассматривается переменная среды CLOUDSTACK_TIMEOUT. |
| api_url строка / обязательно | URL CloudStack API, например https://cloud.example.com/client/api. Если не задан, рассматривается переменная среды CLOUDSTACK_ENDPOINT. | |
| api_verify_ssl_cert строка | Проверка сертификата CA. Если не задан, рассматривается переменная среды CLOUDSTACK_VERIFY. | |
| cpu_number целое число | Количество процессоров в предложении сервиса. | |
| cpu_speed целое число | Частота процессора предложения сервиса в МГц. | |
| deployment_planner строка | Эвристика планировщика развертывания, используемая для развертывания виртуальной машины данного предложения. Если не задано, используется значение глобальной конфигурации vm.deployment.planner. | |
| disk_bytes_read_rate целое число | Скорость чтения байтов диска. псевдонимы: bytes_read_rate | |
| disk_bytes_write_rate целое число | Скорость записи байтов диска. псевдонимы: bytes_write_rate | |
| disk_iops_max целое число | Максимальное значение iops вычислительного предложения. | |
| disk_iops_min целое число | Минимальное значение iops вычислительного предложения. | |
| disk_iops_read_rate целое число | Скорость чтения операций ввода-вывода диска. | |
| disk_iops_write_rate целое число | Скорость записи операций ввода-вывода диска. | |
| display_text строка | Отображаемый текст предложения сервиса. Если не задан, в качестве display_text при создании будет использоваться name. | |
| domain строка | Домен, к которому относится предложение сервиса. Общедоступно для всех доменов и поддоменов, если не указано. | |
| host_tags список / элементы=строка | Теги хоста для данного предложения сервиса. псевдонимы: host_tag | |
| hypervisor_snapshot_reserve целое число | Зарезервированное пространство для моментального снимка гипервизора в процентах от объема. Только для управляемого хранилища с Xen или VMware. | |
| is_customized булево |
| Является ли предложение настраиваемым. |
| is_iops_customized булево |
| Являются ли iops вычислительного предложения настраиваемыми. псевдонимы: disk_iops_customized |
| is_system булево |
| Представляет ли это предложение сервиса для виртуальной машины системы. |
| is_volatile булево |
| Нужно ли, чтобы виртуальная машина была нестабильной. При каждом перезапуске виртуальной машины корневой диск отсоединяется, затем уничтожается, и создается новый корневой диск, который прикрепляется к виртуальной машине. |
| limit_cpu_usage булево |
| Ограничить использование ЦП выделенным предложением сервиса. |
| memory целое число | Общий объем памяти предложения сервиса в МБ. | |
| name строка / обязательно | Имя предложения сервиса. | |
| network_rate целое число | Скорость передачи данных в Мбит/с, разрешенная. Поддерживается только для предложений сервиса, не являющихся системой, и для предложений сервиса системы с system_vm_type=domainrouter. | |
| offer_ha булево |
| Установлен ли HA для предложения сервиса. |
| provisioning_type строка |
| Тип провизионирования, используемый для создания томов. |
| service_offering_details список / элементы=словарь | Детали для планировщика, используемые для хранения специфических параметров. Список словарей с ключами key и value. | |
| state строка |
| Состояние предложения сервиса. |
| storage_tags список / элементы=строка | Теги хранилища для данного предложения сервиса. псевдонимы: storage_tag | |
| storage_type строка |
| Тип хранилища предложения сервиса. |
| system_vm_type строка |
| Тип виртуальной машины системы. Требуется, если is_system=да. |
Примечания
Примечание
- Подробное руководство по модулям cloudstack можно найти в Руководстве по облаку CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Create a non-volatile compute service offering with local storage
ngine_io.cloudstack.cs_service_offering:
name: Micro
display_text: Micro 512mb 1cpu
cpu_number: 1
cpu_speed: 2198
memory: 512
host_tags: eco
storage_type: local
- name: Create a volatile compute service offering with shared storage
ngine_io.cloudstack.cs_service_offering:
name: Tiny
display_text: Tiny 1gb 1cpu
cpu_number: 1
cpu_speed: 2198
memory: 1024
storage_type: shared
is_volatile: yes
host_tags: eco
storage_tags: eco
- name: Create or update a volatile compute service offering with shared storage
ngine_io.cloudstack.cs_service_offering:
name: Tiny
display_text: Tiny 1gb 1cpu
cpu_number: 1
cpu_speed: 2198
memory: 1024
storage_type: shared
is_volatile: yes
host_tags: eco
storage_tags: eco
- name: Create or update a custom compute service offering
ngine_io.cloudstack.cs_service_offering:
name: custom
display_text: custom compute offer
is_customized: yes
storage_type: shared
host_tags: eco
storage_tags: eco
- name: Remove a compute service offering
ngine_io.cloudstack.cs_service_offering:
name: Tiny
state: absent
- name: Create or update a system offering for the console proxy
ngine_io.cloudstack.cs_service_offering:
name: System Offering for Console Proxy 2GB
display_text: System Offering for Console Proxy 2GB RAM
is_system: yes
system_vm_type: consoleproxy
cpu_number: 1
cpu_speed: 2198
memory: 2048
storage_type: shared
storage_tags: perf
- name: Remove a system offering
ngine_io.cloudstack.cs_service_offering:
name: System Offering for Console Proxy 2GB
is_system: yes
state: absent
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| cpu_number целое число | успех | Количество процессоров в предложении услуг Пример: 4 |
| cpu_speed целое число | успех | Скорость процессоров в МГц в предложении услуг Пример: 2198 |
| created строка | успех | Дата создания предложения Пример: 2017-11-19T10:48:59+0000 |
| disk_bytes_read_rate целое число | успех | Скорость чтения байтов предложения услуг Пример: 1000 |
| disk_bytes_write_rate целое число | успех | Скорость записи байтов предложения услуг Пример: 1000 |
| disk_iops_max целое число | успех | Максимальное значение iops предложения по диску Пример: 1000 |
| disk_iops_min целое число | успех | Минимальное значение iops предложения по диску Пример: 500 |
| disk_iops_read_rate целое число | успех | Скорость ввода-вывода в секунду (чтение) предложения услуг Пример: 1000 |
| disk_iops_write_rate целое число | успех | Скорость ввода-вывода в секунду (запись) предложения услуг Пример: 1000 |
| display_text строка | успех | Текст для отображения предложения Пример: Micro 512mb 1cpu |
| domain строка | успех | Домен, к которому относится предложение Пример: ROOT |
| host_tags список / элементы=строка | успех | Список тегов хоста Пример: ['eco'] |
| id строка | успех | UUID предложения услуг Пример: a6f7a5fc-43f8-11e5-a151-feff819cdc9f |
| is_customized булево | успех | Можно ли настроить предложение? |
| is_iops_customized булево | успех | Использует ли предложение настраиваемые IOPS? |
| is_system булево | успех | Предложение предназначено для системных виртуальных машин? |
| is_volatile булево | успех | Предложение является летучим? |
| limit_cpu_usage булево | успех | Ограничивается ли использование ЦП выделенным предложением услуг? |
| memory целое число | успех | Объем памяти предложения системы Пример: 512 |
| name строка | успех | Название предложения системы Пример: Micro |
| network_rate целое число | успех | Скорость передачи данных в мегабитах в секунду Пример: 1000 |
| offer_ha булево | успех | Поддерживается ли HA в предложении? |
| provisioning_type строка | успех | Тип выделения, используемый для создания томов Пример: thin |
| service_offering_details словарь | успех | Дополнительные детали предложения услуг Пример: {'vgpuType': 'GRID K180Q','pciDevice':'Группа NVIDIA Corporation GK107GL [GRID K1] графических процессоров'} |
| storage_tags список / элементы=строка | успех | Список тегов хранения Пример: ['eco'] |
| storage_type строка | успех | Тип хранилища, используемый для создания томов Пример: shared |
| system_vm_type строка | успех | Тип виртуальной машины системы Пример: consoleproxy |
Авторы
- René Moser (@resmo)
© 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/ngine_io/cloudstack/cs_service_offering_module.html