Spec-Zone.ru › Ansible 2.6

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

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

  • Обзор
    • Требования
  • Параметры
  • Примечания
  • Примеры
  • Значения возврата
  • Статус
  • Техническое обслуживание
    • Автор

Обзор

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

Требования

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

  • python >= 2.6
  • cs >= 0.6.10

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
api_http_method
    Варианты:
  • get
  • post
Метод HTTP, используемый для запроса конечной точки API.
Если не указано, используется переменная среды CLOUDSTACK_METHOD.
В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания.
Значение по умолчанию — get, если не указано.
api_key
Ключ API API CloudStack.
Если не указано, используется переменная среды CLOUDSTACK_KEY.
В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания.
api_region Значение по умолчанию:
"cloudstack"
Имя раздела ini в файле cloustack.ini.
Если не указано, используется переменная среды CLOUDSTACK_REGION.
api_secret
Секретный ключ API CloudStack.
Если не указано, используется переменная среды CLOUDSTACK_SECRET.
В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания.
api_timeout
Таймаут HTTP в секундах.
Если не указано, используется переменная среды CLOUDSTACK_TIMEOUT.
В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания.
Значение по умолчанию — 10 секунд, если не указано.
api_url
URL API CloudStack, например, 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 Значение по умолчанию:
"нет"
Применяются ли пользовательские значения iops предложения вычислений.
disk_iops_max
Максимальное значение iops предложения вычислений.
disk_iops_min
Минимальное значение iops предложения вычислений.
disk_iops_read_rate
Скорость чтения операций ввода-вывода диска.
disk_iops_write_rate
Скорость записи операций ввода-вывода диска.
display_text
Отображаемый текст предложения услуг.
Если не указано, name будет использоваться как display_text при создании.
domain
Домен, к которому относится предложение услуг.
Общедоступно для всех доменов и поддоменов, если не указано.
host_tags
Теги хоста для этого предложения услуг.

псевдонимы: тег_хоста
hypervisor_snapshot_reserve
Зарезервированное пространство моментального снимка гипервизора в процентах от объема.
Только для управляемого хранилища с использованием Xen или VMware.
is_system
bool
    Варианты:
  • нет ←
  • да
Представляет ли это предложение системной виртуальной машины.
is_volatile
bool
    Варианты:
  • нет ←
  • да
Требуется ли виртуальная машина быть динамической.
При каждом перезапуске виртуальной машины корневой диск отключается, затем уничтожается, и создается новый корневой диск, который затем подключается к виртуальной машине.
limit_cpu_usage
bool
    Варианты:
  • нет
  • да
Ограничить использование ЦП до выделенного предложения услуг.
memory
Общий объем памяти предложения услуг в МБ.
name
обязательно
Название предложения услуг.
network_rate
Допустимая скорость передачи данных в Мбит/с.
Поддерживается только для предложений, отличных от системных, и для системных предложений, имеющих system_vm_type=domainrouter.
offer_ha
bool
    Варианты:
  • нет ←
  • да
Включена ли поддержка HA для предложения услуг.
provisioning_type
    Варианты:
  • тонкий
  • разреженный
  • полный
Тип виртуализации, используемый для создания томов.
service_offering_details
Детали для планировщика, используемые для хранения определенных параметров.
state
    Варианты:
  • настоящее ←
  • отсутствует
Состояние предложения услуг.
storage_tags
Теги хранилища для этого предложения услуг.

псевдонимы: тег_хранилища
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
int
 успех
Количество процессоров в предлагаемой услуге

Пример:
4
cpu_speed
int
 успех
Частота процессоров в МГц в предлагаемой услуге

Пример:
2198
created
string
 успех
Дата создания предложения

Пример:
2017-11-19T10:48:59+0000
disk_bytes_read_rate
int
 успех
Скорость чтения байтов для предлагаемой услуги

Пример:
1000
disk_bytes_write_rate
int
 успех
Скорость записи байтов для предлагаемой услуги

Пример:
1000
disk_iops_max
int
 успех
Максимальное количество операций ввода/вывода для предложения диска

Пример:
1000
disk_iops_min
int
 успех
Минимальное количество операций ввода/вывода для предложения диска

Пример:
500
disk_iops_read_rate
int
 успех
Скорость операций ввода/вывода в секунду для чтения предлагаемой услуги

Пример:
1000
disk_iops_write_rate
int
 успех
Скорость операций ввода/вывода в секунду для записи предлагаемой услуги

Пример:
1000
display_text
string
 успех
Текст для отображения предложения

Пример:
Micro 512mb 1cpu
domain
string
 успех
Домен, к которому относится предложение

Пример:
ROOT
host_tags
list
 успех
Список тегов хоста

Пример:
['eco']
id
string
 успех
UUID предложения услуги

Пример:
a6f7a5fc-43f8-11e5-a151-feff819cdc9f
is_iops_customized
bool
 успех
Использует ли предложение настраиваемые значения IOPS
is_system
bool
 успех
Предназначено ли предложение для системных виртуальных машин
is_volatile
bool
 успех
Является ли предложение временным
limit_cpu_usage
bool
 успех
Ограничивается ли использование процессора предоставленной услугой
memory
int
 успех
Оперативная память предложения системы

Пример:
512
name
string
 успех
Название предложения системы

Пример:
Micro
network_rate
int
 успех
Скорость передачи данных в мегабитах в секунду

Пример:
1000
offer_ha
bool
 успех
Включена ли поддержка HA в предложении
provisioning_type
string
 успех
Тип подготовки, используемый для создания томов

Пример:
thin
service_offering_details
dict
 успех
Дополнительные детали предложения услуги

Пример:
{'vgpuType': 'GRID K180Q','pciDevice':'Группа NVIDIA Corporation GK107GL [GRID K1] видеокарт'}
storage_tags
list
 успех
Список тегов хранения

Пример:
['eco']
storage_type
string
 успех
Тип хранения, используемый для создания томов

Пример:
shared
system_vm_type
string
 успех
Тип системной виртуальной машины в этом предложении

Пример:
consoleproxy


Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, поддерживаемых сообществом 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.6/modules/cs_service_offering_module.html

Spec-Zone.ru

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