Spec-Zone.ru › Ansible 2.11

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
строка
    Варианты:
  • get ←
  • post
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
строка
    Варианты:
  • present ←
  • absent
Состояние предложения сервиса.
storage_tags
список / элементы=строка
Теги хранилища для данного предложения сервиса.

псевдонимы: storage_tag
storage_type
строка
    Варианты:
  • локальный
  • совместный
Тип хранилища предложения сервиса.
system_vm_type
строка
    Варианты:
  • domainrouter
  • consoleproxy
  • secondarystoragevm
Тип виртуальной машины системы.
Требуется, если 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API