Модуль ngine_io.cloudstack.cluster – управление кластерами узлов в облаках на базе 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.cluster.

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

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

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

Создание, обновление и удаление кластеров.

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

Требования

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

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`.
cluster_type string	Тип кластера. Обязательный параметр, если state=present Варианты: `"CloudManaged"` `"ExternalManaged"`
guest_vswitch_name string	Имя виртуального коммутатора, используемого в кластере для гостевого трафика. Переопределяет настройку метки трафика на уровне зоны.
guest_vswitch_type string	Тип виртуального коммутатора, используемого в кластере для гостевого трафика. Допустимые значения: vmwaresvs (стандартный vSwitch VMware) и vmwaredvs (распределённый vSwitch VMware) Варианты: `"vmwaresvs"` `"vmwaredvs"`
hypervisor string	Имя используемого гипервизора. Обязательный параметр, если state=present. Возможные значения: `KVM`, `VMware`, `BareMetal`, `XenServer`, `LXC`, `HyperV`, `UCS`, `OVM`, `Simulator`.
name string / обязательный	Имя кластера.
ovm3_cluster string	Включить встроенную кластеризацию OCFS2 в OVM3 для кластера.
ovm3_pool string	Включить встроенное объединение в пул в OVM3 для кластера.
ovm3_vip string	VIP-адрес OVM3, используемый для пула (и кластера).
password string	Пароль для кластера.
pod string	Имя пода, к которому относится кластер.
public_vswitch_name string	Имя виртуального коммутатора, используемого в кластере для публичного трафика. Переопределяет настройку метки трафика на уровне зоны.
public_vswitch_type string	Тип виртуального коммутатора, используемого в кластере для публичного трафика. Допустимые значения: vmwaresvs (стандартный vSwitch VMware) и vmwaredvs (распределённый vSwitch VMware) Варианты: `"vmwaresvs"` `"vmwaredvs"`
state string	Состояние кластера. Варианты: `"present"` ← (по умолчанию) `"absent"` `"disabled"` `"enabled"`
url string	URL кластера
username string	Имя пользователя для кластера.
validate_certs boolean добавлено в ngine_io.cloudstack 2.4.0	Если `false`, сертификаты SSL не проверяются. Если параметр не задан, используется переменная среды `CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY`. Используйте этот параметр только на сайтах под вашим контролем, где применяются самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vms_ip_address string	IP-адрес VSM, связанного с этим кластером.
vms_password string	Пароль для VSM, связанного с этим кластером.
vms_username string	Имя пользователя для VSM, связанного с этим кластером.
zone string / обязательный	Имя зоны, к которой относится кластер.

Примечания

Примечание

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

Примеры

- name: Ensure a cluster is present
  ngine_io.cloudstack.cluster:
    name: kvm-cluster-01
    zone: ch-zrh-ix-01
    hypervisor: KVM
    cluster_type: CloudManaged

- name: Ensure a cluster is disabled
  ngine_io.cloudstack.cluster:
    name: kvm-cluster-01
    zone: ch-zrh-ix-01
    state: disabled

- name: Ensure a cluster is enabled
  ngine_io.cloudstack.cluster:
    name: kvm-cluster-01
    zone: ch-zrh-ix-01
    state: enabled

- name: Ensure a cluster is absent
  ngine_io.cloudstack.cluster:
    name: kvm-cluster-01
    zone: ch-zrh-ix-01
    state: absent

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

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

Ключ	Описание
allocation_state string	Состояние кластера. Возвращается: при успехе Пример: `"Enabled"`
cluster_type string	Тип кластера. Возвращается: при успехе Пример: `"ExternalManaged"`
cpu_overcommit_ratio string	Коэффициент переподписки ЦП кластера. Возвращается: при успехе Пример: `"1.0"`
hypervisor string	Гипервизор кластера Возвращается: при успехе Пример: `"VMware"`
id string	UUID кластера. Возвращается: при успехе Пример: `"04589590-ac63-4ffc-93f5-b698b8ac38b6"`
managed_state string	Управляется ли этот кластер CloudStack. Возвращается: при успехе Пример: `"Managed"`
memory_overcommit_ratio string	Коэффициент переподписки памяти кластера. Возвращается: при успехе Пример: `"1.0"`
name string	Имя кластера. Возвращается: при успехе Пример: `"cluster01"`
ovm3_vip string	VIP-адрес OVM3, используемый для объединения в пул и/или кластеризации Возвращается: при успехе Пример: `"10.10.10.101"`
pod string	Имя пода, в котором находится кластер. Возвращается: при успехе Пример: `"pod01"`
zone string	Имя зоны, в которой находится кластер. Возвращается: при успехе Пример: `"ch-gva-2"`

Авторы

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/cluster_module.html