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, см. также примечания.
bytes_read_rate -		Скорость чтения байтов предложения диска.
bytes_write_rate -		Скорость записи байтов предложения диска.
cpu_number -		Количество процессоров предложения службы.
cpu_speed -		Частота процессора предложения службы в МГц.
deployment_planner -		Эвристика планировщика развертывания, используемая для развертывания виртуальной машины данного предложения. Если не задано, используется значение глобальной конфигурации `vm.deployment.planner`.
disk_iops_customized -	Значение по умолчанию: "нет"	Является ли количество операций ввода-вывода диска настраиваемым.
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_system boolean	Варианты: нет ← да	Предложение для системной виртуальной машины или нет.
is_volatile boolean	Варианты: нет ← да	Требуется ли виртуальная машина быть динамической или нет. При каждом перезапуске виртуальной машины корневой диск отсоединяется, затем уничтожается, и создаётся новый корневой диск, который подключается к виртуальной машине.
limit_cpu_usage boolean	Варианты: нет да	Ограничить использование процессора на заданном предложении службы.
memory -		Общий объем памяти предложения службы в МБ.
name - / обязательно		Название предложения службы.
network_rate -		Допустимая скорость передачи данных в Мбит/с. Поддерживается только для предложений служб, не являющихся системными, и для системных предложений, имеющих `system_vm_type=domainrouter`.
offer_ha boolean	Варианты: нет ← да	Включена ли функция HA для предложения службы.
provisioning_type -	Варианты: thin sparse fat	Тип подготовки, используемый для создания томов.
service_offering_details -		Подробности для планировщика, используемые для хранения конкретных параметров.
state -	Варианты: наличие ← отсутствие	Состояние предложения службы.
storage_tags -		Теги хранилища для данного предложения службы. псевдонимы: storage_tag
storage_type -	Варианты: локальный совместный	Тип хранилища предложения службы.
system_vm_type -	Варианты: domainrouter consoleproxy secondarystoragevm	Тип системной виртуальной машины. Обязательно, если `is_system=true`.

Примечания

Примечание

Ansible использует метод конфигурации библиотеки cs если данные учетных данных не предоставлены аргументами api_url, api_key, api_secret. Конфигурация считывается из нескольких мест, в следующем порядке. CLOUDSTACK_ENDPOINT, CLOUDSTACK_KEY, CLOUDSTACK_SECRET и CLOUDSTACK_METHOD переменные окружения. CLOUDSTACK_TIMEOUT переменная окружения, указывающая на файл CLOUDSTACK_CONFIG. Файл 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
  local_action:
    module: 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
  local_action:
    module: cs_service_offering
    name: Tiny
    display_text: Tiny 1gb 1cpu
    cpu_number: 1
    cpu_speed: 2198
    memory: 1024
    storage_type: shared
    is_volatile: true
    host_tags: eco
    storage_tags: eco

- name: Create or update a volatile compute service offering with shared storage
  local_action:
    module: 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: Remove a compute service offering
  local_action:
    module: cs_service_offering
    name: Tiny
    state: absent

- name: Create or update a system offering for the console proxy
  local_action:
    module: 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
  local_action:
    module: 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 целое число	успех	Максимальное количество операций ввода-вывода в секунду для предложения диска Пример: 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_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. [community]

Авторы

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