Spec-Zone.ru › Ansible

ngine_io.cloudstack.service_offering module — Управление сервисными предложениями в облаках на базе Apache CloudStack.

Примечание

Этот модуль входит в коллекцию ngine_io.cloudstack (версия 3.0.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install ngine_io.cloudstack. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: ngine_io.cloudstack.service_offering.

Добавлено в ngine_io.cloudstack 0.1.0

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

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

Псевдонимы: cs_service_offering

Требования

На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.

  • python >= 2.6
  • cs >= 0.9.0

Параметры

Параметр

Описание

api_http_method

string

Метод HTTP, используемый для запроса к конечной точке API.

Если параметр не задан, используется переменная окружения CLOUDSTACK_METHOD.

Допустимые значения:

  • "get" ← (по умолчанию)
  • "post"

api_key

string / обязательный

Ключ API CloudStack.

Если параметр не задан, используется переменная окружения CLOUDSTACK_KEY.

api_secret

string / обязательный

Секретный ключ API CloudStack.

Если параметр не задан, используется переменная окружения CLOUDSTACK_SECRET.

api_timeout

integer

Тайм-аут HTTP в секундах.

Если параметр не задан, используется переменная окружения CLOUDSTACK_TIMEOUT.

По умолчанию: 10

api_url

string / обязательный

URL API CloudStack, например https://cloud.example.com/client/api.

Если параметр не задан, используется переменная окружения CLOUDSTACK_ENDPOINT.

api_verify_ssl_cert

string

Проверять файл сертификата центра сертификации.

Если параметр не задан, используется переменная окружения CLOUDSTACK_VERIFY.

cpu_number

integer

Количество процессоров в сервисном предложении.

cpu_speed

integer

Тактовая частота процессора в сервисном предложении, в МГц.

deployment_planner

string

Эвристический алгоритм планировщика развертывания, используемый для развертывания ВМ с этим предложением.

Если параметр не задан, используется значение глобальной конфигурации vm.deployment.planner.

disk_bytes_read_rate

псевдонимы: bytes_read_rate

integer

Скорость чтения данных с диска в байтах для дискового предложения.

disk_bytes_write_rate

псевдонимы: bytes_write_rate

integer

Скорость записи данных на диск в байтах для дискового предложения.

disk_iops_max

integer

Максимальное количество IOPS для вычислительного предложения.

disk_iops_min

integer

Минимальное количество IOPS для вычислительного предложения.

disk_iops_read_rate

integer

Скорость запросов ввода-вывода на чтение для дискового предложения.

disk_iops_write_rate

integer

Скорость запросов ввода-вывода на запись для дискового предложения.

display_text

string

Отображаемый текст сервисного предложения.

Если параметр не задан, при создании в качестве display_text будет использовано значение name.

domain

string

Домен, к которому относится сервисное предложение.

Если параметр не задан, предложение является общедоступным для всех доменов и поддоменов.

host_tags

псевдонимы: host_tag

list / элементы типа string

Теги узлов для этого сервисного предложения.

hypervisor_snapshot_reserve

integer

Резерв места для снимков гипервизора в процентах от объёма.

Только для управляемого хранилища с Xen или VMware.

is_customized

boolean

Можно ли настраивать это предложение.

Допустимые значения:

  • false
  • true

is_iops_customized

псевдонимы: disk_iops_customized

boolean

Можно ли настраивать IOPS вычислительного предложения.

Допустимые значения:

  • false
  • true

is_system

boolean

Является ли это предложением для системной ВМ.

Допустимые значения:

  • false ← (по умолчанию)
  • true

is_volatile

boolean

Должна ли виртуальная машина быть временной.

При каждой перезагрузке ВМ корневой диск отсоединяется и удаляется, после чего создаётся новый корневой диск и подключается к ВМ.

Допустимые значения:

  • false
  • true

limit_cpu_usage

boolean

Ограничить использование ЦП значением, заданным в сервисном предложении.

Допустимые значения:

  • false
  • true

memory

integer

Общий объём памяти в сервисном предложении, в МБ.

name

string / обязательный

Название сервисного предложения.

network_rate

integer

Допустимая скорость передачи данных в Мбит/с.

Поддерживается только для несистемных предложений и системных предложений с параметром system_vm_type=domainrouter.

offer_ha

boolean

Включена ли высокая доступность (HA) для сервисного предложения.

Допустимые значения:

  • false
  • true

provisioning_type

string

Тип выделения ресурсов, используемый при создании томов.

Допустимые значения:

  • "thin"
  • "sparse"
  • "fat"

service_offering_details

list / элементы типа dictionary

Параметры планировщика для хранения специфичных значений.

Список словарей с ключами key и value.

state

string

Состояние сервисного предложения.

Допустимые значения:

  • "present" ← (по умолчанию)
  • "absent"

storage_tags

псевдонимы: storage_tag

list / элементы типа string

Теги хранилища для этого сервисного предложения.

storage_type

string

Тип хранилища для сервисного предложения.

Допустимые значения:

  • "local"
  • "shared"

system_vm_type

string

Тип системной ВМ.

Обязательный параметр, если is_system=yes.

Допустимые значения:

  • "domainrouter"
  • "consoleproxy"
  • "secondarystoragevm"

validate_certs

boolean

добавлено в ngine_io.cloudstack 2.4.0

Если false, SSL-сертификаты не будут проверяться.

Если параметр не задан, используется переменная окружения CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY.

Этот параметр следует использовать только на контролируемых вами сайтах с самоподписанными сертификатами.

Допустимые значения:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Подробное руководство по модулям CloudStack см. в руководстве по облаку CloudStack.
  • Этот модуль поддерживает режим проверки.

Примеры

- name: Create a non-volatile compute service offering with local storage
  ngine_io.cloudstack.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
  ngine_io.cloudstack.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: Create or update a volatile compute service offering with shared storage
  ngine_io.cloudstack.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: Create or update a custom compute service offering
  ngine_io.cloudstack.service_offering:
    name: custom
    display_text: custom compute offer
    is_customized: yes
    storage_type: shared
    host_tags: eco
    storage_tags: eco

- name: Remove a compute service offering
  ngine_io.cloudstack.service_offering:
    name: Tiny
    state: absent

- name: Create or update a system offering for the console proxy
  ngine_io.cloudstack.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
  ngine_io.cloudstack.service_offering:
    name: System Offering for Console Proxy 2GB
    is_system: yes
    state: absent

Возвращаемые значения

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

Ключ

Описание

cpu_number

integer

Количество процессоров в предложении услуги

Возвращается: успешно

Пример: 4

cpu_speed

integer

Частота процессоров в предложении услуги, МГц

Возвращается: успешно

Пример: 2198

created

string

Дата создания предложения

Возвращается: успешно

Пример: "2017-11-19T10:48:59+0000"

disk_bytes_read_rate

integer

Скорость чтения байтов для предложения услуги

Возвращается: успешно

Пример: 1000

disk_bytes_write_rate

integer

Скорость записи байтов для предложения услуги

Возвращается: успешно

Пример: 1000

disk_iops_max

integer

Максимальное количество операций ввода-вывода в секунду для предложения диска

Возвращается: успешно

Пример: 1000

disk_iops_min

integer

Минимальное количество операций ввода-вывода в секунду для предложения диска

Возвращается: успешно

Пример: 500

disk_iops_read_rate

integer

Скорость чтения в запросах ввода-вывода в секунду для предложения услуги

Возвращается: успешно

Пример: 1000

disk_iops_write_rate

integer

Скорость записи в запросах ввода-вывода в секунду для предложения услуги

Возвращается: успешно

Пример: 1000

display_text

string

Отображаемый текст предложения

Возвращается: успешно

Пример: "Micro 512mb 1cpu"

domain

string

Домен, к которому относится предложение

Возвращается: успешно

Пример: "ROOT"

host_tags

list / elements=string

Список тегов узла

Возвращается: успешно

Пример: ["eco"]

id

string

UUID предложения услуги

Возвращается: успешно

Пример: "a6f7a5fc-43f8-11e5-a151-feff819cdc9f"

is_customized

boolean

Можно ли настроить предложение

Возвращается: успешно

Пример: false

is_iops_customized

boolean

Используются ли в предложении пользовательские значения IOPS

Возвращается: успешно

Пример: false

is_system

boolean

Предназначено ли предложение для системных виртуальных машин

Возвращается: успешно

Пример: false

is_volatile

boolean

Является ли предложение временным

Возвращается: успешно

Пример: false

limit_cpu_usage

boolean

Ограничено ли использование ЦП выделенными ресурсами предложения услуги

Возвращается: успешно

Пример: false

memory

integer

Объем памяти в системном предложении

Возвращается: успешно

Пример: 512

name

string

Название системного предложения

Возвращается: успешно

Пример: "Micro"

network_rate

integer

Допустимая скорость передачи данных в мегабитах в секунду

Возвращается: успешно

Пример: 1000

offer_ha

boolean

Включена ли в предложении поддержка высокой доступности (HA)

Возвращается: успешно

Пример: false

provisioning_type

string

Тип выделения ресурсов, используемый для создания томов

Возвращается: успешно

Пример: "thin"

service_offering_details

dictionary

Дополнительные сведения о предложении услуги

Возвращается: успешно

Пример: {"pciDevice": "Group of NVIDIA Corporation GK107GL [GRID K1] GPUs", "vgpuType": "GRID K180Q"}

storage_tags

list / elements=string

Список тегов хранилища

Возвращается: успешно

Пример: ["eco"]

storage_type

string

Тип хранилища, используемый для создания томов

Возвращается: успешно

Пример: "shared"

system_vm_type

string

Тип системной виртуальной машины для этого предложения

Возвращается: успешно

Пример: "consoleproxy"

Авторы

  • René Moser (@resmo)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ngine_io/cloudstack/service_offering_module.html

Spec-Zone.ru

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