Spec-Zone.ru › Ansible 2.8

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. Переменная окружения 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
  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':'Группа NVIDIA Corporation GK107GL [GRID K1] графических процессоров'}
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.8/modules/cs_service_offering_module.html

Spec-Zone.ru

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