Spec-Zone.ru › Ansible 2.5

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 По умолчанию:
no
Является ли количество операций ввода/вывода диска настраиваемым или нет.
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
    Варианты:
  • yes
  • no ←
По умолчанию:
no
Представляет ли это предложение системы виртуальной машины или нет.
is_volatile
    Варианты:
  • yes
  • no ←
По умолчанию:
no
Требуется ли для виртуальной машины использование недолговременной памяти или нет.
При каждом перезапуске виртуальной машины корневой диск отсоединяется, затем уничтожается, и создается новый корневой диск, который подключается к виртуальной машине.
limit_cpu_usage
    Варианты:
  • yes
  • no
Ограничить использование ЦП выделенным предложением услуги.
memory
Общий объем памяти предложения услуги в МБ.
name
требуется
Имя предложения услуги.
network_rate
Скорость передачи данных в Мбит/с, разрешенная для передачи данных.
Поддерживается только для предложений услуг, не являющихся системными, и системных предложений услуг с system_vm_type=domainrouter.
offer_ha
    Варианты:
  • yes
  • no ←
По умолчанию:
no
Включена ли функция HA для предложения услуги.
provisioning_type
    Варианты:
  • thin
  • sparse
  • fat
Тип резервирования, используемый для создания томов.
service_offering_details
Детали для планировщика, используемые для хранения конкретных параметров.
state
    Варианты:
  • present ←
  • absent
Состояние предложения услуги.
storage_tags
Теги хранилища для этого предложения услуги.

Псевдонимы: storage_tag
storage_type
    Варианты:
  • local
  • shared
Тип хранилища предложения услуги.
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 переменная окружения, указывающая на файл .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
  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
 успех
Максимальное значение IOPS для предложения диска

Пример:
1000
disk_iops_min
int
 успех
Минимальное значение IOPS для предложения диска

Пример:
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] GPU'}
storage_tags
list
 успех
Список тегов хранения

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

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

Пример:
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.5/modules/cs_service_offering_module.html

Spec-Zone.ru

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