Spec-Zone.ru › Ansible

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

Примечание

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

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

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

Для использования в playbook укажите: ngine_io.cloudstack.cs_service_offering.

Новый в ngine_io.cloudstack 0.1.0

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

Описание

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

Требования

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

  • python >= 2.6
  • cs >= 0.9.0

Параметры

Параметр

Комментарии

api_http_method

string

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

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

Варианты:

  • "get" ← (default)
  • "post"

api_key

string / required

API ключ CloudStack API.

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

api_secret

string / required

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

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

api_timeout

integer

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

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

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

api_url

string / required

URL CloudStack API, например 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

aliases: bytes_read_rate

integer

Скорость чтения дисков в байтах.

disk_bytes_write_rate

aliases: 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

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

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

domain

string

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

Public для всех доменов и поддоменов, если не установлено.

host_tags

aliases: host_tag

list / elements=string

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

hypervisor_snapshot_reserve

integer

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

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

is_customized

boolean

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

Варианты:

  • false
  • true

is_iops_customized

aliases: disk_iops_customized

boolean

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

Варианты:

  • false
  • true

is_system

boolean

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

Варианты:

  • false ← (default)
  • true

is_volatile

boolean

Необходимо ли, чтобы виртуальная машина была нестабильной или нет.

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

Варианты:

  • false
  • true

limit_cpu_usage

boolean

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

Варианты:

  • false
  • true

memory

integer

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

name

string / required

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

network_rate

integer

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

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

offer_ha

boolean

Включена ли функция HA для предложения сервиса.

Варианты:

  • false
  • true

provisioning_type

string

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

Варианты:

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

service_offering_details

list / elements=dictionary

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

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

state

string

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

Варианты:

  • "present" ← (default)
  • "absent"

storage_tags

aliases: storage_tag

list / elements=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 ← (default)

Примечания

Примечание

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

Примеры

- name: Create a non-volatile compute service offering with local storage
  ngine_io.cloudstack.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
  ngine_io.cloudstack.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: Create or update a volatile compute service offering with shared storage
  ngine_io.cloudstack.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: Create or update a custom compute service offering
  ngine_io.cloudstack.cs_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.cs_service_offering:
    name: Tiny
    state: absent

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

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

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

Ключ

Описание

cpu_number

integer

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

Возвращается: success

Пример: 4

cpu_speed

integer

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

Возвращается: success

Пример: 2198

created

string

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

Возвращается: success

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

disk_bytes_read_rate

integer

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

Возвращается: success

Пример: 1000

disk_bytes_write_rate

integer

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

Возвращается: success

Пример: 1000

disk_iops_max

integer

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

Возвращается: success

Пример: 1000

disk_iops_min

integer

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

Возвращается: success

Пример: 500

disk_iops_read_rate

integer

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

Возвращается: success

Пример: 1000

disk_iops_write_rate

integer

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

Возвращается: success

Пример: 1000

display_text

string

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

Возвращается: success

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

domain

string

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

Возвращается: success

Пример: "ROOT"

host_tags

list / elements=string

Список тегов хоста

Возвращается: success

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

id

string

UUID предложения сервиса

Возвращается: success

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

is_customized

boolean

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

Возвращается: success

Пример: false

is_iops_customized

boolean

Использует ли предложение настраиваемые операции ввода-вывода или нет

Возвращается: success

Пример: false

is_system

boolean

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

Возвращается: success

Пример: false

is_volatile

boolean

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

Возвращается: success

Пример: 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/ngine_io/cloudstack/cs_service_offering_module.html

Spec-Zone.ru

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