cs_service_offering – Управляет предложениями услуг в облаках на основе Apache CloudStack

Новая в версии 2.5.

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

Обзор

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

Требования

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

python >= 2.6
cs >= 0.6.10

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_http_method строка	Варианты: get post	Метод HTTP, используемый для запроса к API-точке. Если не задано, используется переменная окружения `CLOUDSTACK_METHOD`. В качестве последнего варианта используется значение из файла конфигурации ini, см. также примечания. Значение по умолчанию - `get`, если не указано.
api_key строка		Ключ API CloudStack API. Если не задано, используется переменная окружения `CLOUDSTACK_KEY`. В качестве последнего варианта используется значение из файла конфигурации ini, см. также примечания.
api_region строка	Значение по умолчанию: "cloudstack"	Имя раздела ini в файле `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, см. также примечания.
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 булево добавлено в 2.8	Варианты: нет да	Является ли предложение настраиваемым.
is_iops_customized булево	Варианты: нет да	Является ли предложение IOPS пользовательским или нет. псевдонимы: disk_iops_customized
is_system булево	Варианты: нет ← да	Представляет ли это предложение виртуальной машины системы.
is_volatile булево	Варианты: нет да	Требуется ли виртуальной машине быть изменчивой. При каждом перезапуске ВМ корневой диск отсоединяется, затем уничтожается, и создается новый корневой диск, который прикрепляется к ВМ.
limit_cpu_usage булево	Варианты: нет да	Ограничить использование процессора выделенной службой.
memory целое число		Общий объем памяти предложения службы в МБ.
name строка / обязательно		Имя предложения службы.
network_rate целое число		Разрешенная скорость передачи данных в Мбит/с. Поддерживается только для предложений, не являющихся системными, и для системных предложений с system_vm_type=domainrouter.
offer_ha булево	Варианты: нет ← да	Настроена ли отказоустойчивость для предложения службы.
provisioning_type строка	Варианты: thin sparse fat	Тип провизионирования, используемый для создания томов.
service_offering_details список		Подробности для планировщика, используемые для хранения специфических параметров. Список словарей с ключами `key` и `value`.
state строка	Варианты: present ← absent	Состояние предложения службы.
storage_tags список		Теги хранилища для этого предложения службы. псевдонимы: storage_tag
storage_type строка	Варианты: локальный совместный	Тип хранилища для предложения службы.
system_vm_type строка	Варианты: domainrouter consoleproxy secondarystoragevm	Тип виртуальной машины системы. Требуется, если is_system=да.

Примечания

Примечание

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
  cs_service_offering:
    name: Micro
    display_text: Micro 512mb 1cpu
    cpu_number: 1
    cpu_speed: 2198
    memory: 512
    host_tags: eco
    storage_type: local
  delegate_to: localhost

- name: Create a volatile compute service offering with shared storage
  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
  delegate_to: localhost

- name: Create or update a volatile compute service offering with shared storage
  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
  delegate_to: localhost

- name: Create or update a custom compute service offering
  cs_service_offering:
    name: custom
    display_text: custom compute offer
    is_customized: yes
    storage_type: shared
    host_tags: eco
    storage_tags: eco
  delegate_to: localhost

- name: Remove a compute service offering
  cs_service_offering:
    name: Tiny
    state: absent
  delegate_to: localhost

- name: Create or update a system offering for the console proxy
  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
  delegate_to: localhost

- name: Remove a system offering
  cs_service_offering:
    name: System Offering for Console Proxy 2GB
    is_system: yes
    state: absent
  delegate_to: localhost

Значения возврата

Общие значения возврата описаны здесь, ниже перечислены поля, уникальные для данного модуля:

Ключ	Возвращаемое значение	Описание
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 целое число	успех	Максимальное количество операций ввода-вывода на диск в предложении услуг Пример: 1000
disk_iops_min целое число	успех	Минимальное количество операций ввода-вывода на диск в предложении услуг Пример: 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 булево добавлено в 2.8	успех	Является ли предложение настраиваемым
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':'Group of NVIDIA Corporation GK107GL [GRID K1] GPUs'}
storage_tags список	успех	Список тегов хранения Пример: ['eco']
storage_type строка	успех	Тип хранения используемый при создании томов Пример: shared
system_vm_type строка	успех	Тип системной виртуальной машины в этом предложении Пример: consoleproxy

Статус

Данный модуль не гарантирует обратной совместимости интерфейса. [превью]
Данный модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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.9/modules/cs_service_offering_module.html