ngine_io.cloudstack.cs_service_offering – Управляет предложениями сервисов в облаках на базе Apache CloudStack.

Примечание

Этот плагин является частью коллекции ngine_io.cloudstack (версия 1.1.0).

Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack.

Для использования в playbook, укажите: ngine_io.cloudstack.cs_service_offering.

Добавлено в версии 0.1.0: модуля ngine_io.cloudstack

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Создаёт и удаляет предложения сервисов для виртуальных машин гостя и системы.
Обновляет display_text существующего предложения сервиса.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_http_method строка	Варианты: get post	HTTP-метод, используемый для запроса к API-точке. Если не указано, используется переменная окружения `CLOUDSTACK_METHOD`. В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания. Значение по умолчанию `get` если не указано.
api_key строка		Ключ API CloudStack API. Если не указано, используется переменная окружения `CLOUDSTACK_KEY`. В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания.
api_region строка	Значение по умолчанию: "cloudstack"	Имя раздела в файле конфигурации `cloustack.ini`. Если не указано, используется переменная окружения `CLOUDSTACK_REGION`.
api_secret строка		Секретный ключ CloudStack API. Если не задано, используется переменная окружения `CLOUDSTACK_SECRET`. В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания.
api_timeout целое число		Таймаут HTTP в секундах. Если не указано, используется переменная окружения `CLOUDSTACK_TIMEOUT`. В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания. Значение по умолчанию 10 секунд, если не указано.
api_url строка		URL CloudStack API, например, https://cloud.example.com/client/api. Если не указано, используется переменная окружения `CLOUDSTACK_ENDPOINT`. В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания.
api_verify_ssl_cert строка		Файл сертификата CA. Если не указано, используется переменная окружения `CLOUDSTACK_VERIFY`. В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания. Значение по умолчанию `null` если не указано.
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 целое число		Максимальное количество операций ввода-вывода в секунду предложения вычисления.
disk_iops_min целое число		Минимальное количество операций ввода-вывода в секунду предложения вычисления.
disk_iops_read_rate целое число		Скорость чтения операций ввода-вывода в секунду предложения диска.
disk_iops_write_rate целое число		Скорость записи операций ввода-вывода в секунду предложения диска.
display_text строка		Текст для отображения предложения сервиса. Если не задано, name будет использоваться как display_text при создании.
domain строка		Домен, к которому относится предложение сервиса. Общедоступный для всех доменов и поддоменов, если не указано.
host_tags список / элементы=строка		Теги хоста для этого предложения сервиса. псевдонимы: host_tag
hypervisor_snapshot_reserve целое число		Зарезервированное пространство для моментальных снимков гипервизора в процентах от объема. Только для управляемого хранилища с использованием Xen или VMware.
is_customized логическое значение	Варианты: no yes	Указывается, является ли предложение настраиваемым.
is_iops_customized логическое значение	Варианты: no yes	Указывает, является ли количество операций ввода-вывода в секунду предложения вычисления пользовательским. псевдонимы: disk_iops_customized
is_system логическое значение	Варианты: нет ← да	Указывает, является ли это предложением сервиса для виртуальной машины системы.
is_volatile логическое значение	Варианты: no yes	Указывает, требуется ли виртуальной машине быть летучей. При каждом перезапуске виртуальной машины корневой диск отсоединяется, затем уничтожается, а новый корневой диск создается и подключается к виртуальной машине.
limit_cpu_usage логическое значение	Варианты: no yes	Ограничить использование процессора заданным предложением сервиса.
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 строка	Варианты: domainrouter consoleproxy secondarystoragevm	Тип виртуальной машины системы. Требуется, если is_system=yes.

Примечания

Примечание

Ansible использует метод конфигурации библиотеки cs, если учетные данные не предоставлены аргументами api_url, api_key, api_secret. Конфигурация считывается из нескольких мест в следующем порядке. CLOUDSTACK_ENDPOINT, CLOUDSTACK_KEY, CLOUDSTACK_SECRET и CLOUDSTACK_METHOD переменные окружения. CLOUDSTACK_TIMEOUT переменная окружения, указывающая на файл .ini. Файл cloudstack.ini в текущей рабочей директории. Файл .cloudstack.ini в домашней директории пользователя. Дополнительно можно указать несколько учетных данных и конечных точек, используя разделы ini в файле cloudstack.ini. Используйте аргумент api_region для выбора имени раздела, по умолчанию используется раздел cloudstack. Подробную информацию см. на странице https://github.com/exoscale/cs.
Подробное руководство по модулям 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 целое число	успех	Скорость чтения IOPS в секунду для предложения услуг Пример: 1000
disk_iops_write_rate целое число	успех	Скорость записи IOPS в секунду для предложения услуг Пример: 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–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_service_offering_module.html