cs_cluster — Управляет кластерами хостов на облаках Apache CloudStack.

Новая версия с 2.1.

Описание
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Описание

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

Требования

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

python >= 2.6
cs >= 0.6.10

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_http_method	Варианты: get post	Метод HTTP, используемый для запроса к API-точке. Если не указано, используется значение из переменной среды `CLOUDSTACK_METHOD`. В качестве последнего варианта используется значение из файла конфигурации ini, см. также раздел примечания. Значение по умолчанию — `get`, если не указано.
api_key		Ключ API API CloudStack. Если не указано, используется значение из переменной среды `CLOUDSTACK_KEY`. В качестве последнего варианта используется значение из файла конфигурации ini, см. также раздел примечания.
api_region	По умолчанию: "cloudstack"	Имя раздела в файле конфигурации `cloustack.ini`. Если не указано, используется значение из переменной среды `CLOUDSTACK_REGION`.
api_secret		Секретный ключ API CloudStack. Если не задано, используется значение из переменной среды `CLOUDSTACK_SECRET`. В качестве последнего варианта используется значение из файла конфигурации ini, см. также раздел примечания.
api_timeout		Таймаут HTTP в секундах. Если не указано, используется значение из переменной среды `CLOUDSTACK_TIMEOUT`. В качестве последнего варианта используется значение из файла конфигурации ini, см. также раздел примечания. Значение по умолчанию — 10 секунд, если не указано.
api_url		URL API CloudStack, например, https://cloud.example.com/client/api. Если не указано, используется значение из переменной среды `CLOUDSTACK_ENDPOINT`. В качестве последнего варианта используется значение из файла конфигурации ini, см. также раздел примечания.
cluster_type	Варианты: CloudManaged ExternalManaged	Тип кластера. Требуется, если `state=present`.
guest_vswitch_name		Имя виртуального коммутатора, используемого для трафика гостевых машин в кластере. Это переопределяет настройку тега трафика на уровне зоны.
guest_vswitch_type	Варианты: vmwaresvs vmwaredvs	Тип виртуального коммутатора, используемого для трафика гостевых машин в кластере. Допустимые значения: vmwaresvs (для стандартного виртуального коммутатора VMware) и vmwaredvs (для распределенного виртуального коммутатора VMware).
hypervisor	Варианты: KVM VMware BareMetal XenServer LXC HyperV UCS OVM	Имя гипервизора, который будет использоваться. Требуется, если `state=present`.
name обязательно		имя кластера.
ovm3_cluster		Включена нативная кластеризация OCFS2 Ovm3 для кластера.
ovm3_pool		Включено нативное пулирование Ovm3 для кластера.
ovm3_vip		Используемый VIP Ovm3 для пула (и кластера).
password		Пароль для кластера.
pod		Имя подотдела, к которому принадлежит кластер.
public_vswitch_name		Имя виртуального коммутатора, используемого для публичного трафика в кластере. Это переопределяет настройку тега трафика на уровне зоны.
public_vswitch_type	Варианты: vmwaresvs vmwaredvs	Тип виртуального коммутатора, используемого для публичного трафика в кластере. Допустимые значения: vmwaresvs (для стандартного виртуального коммутатора VMware) и vmwaredvs (для распределенного виртуального коммутатора VMware).
state	Варианты: present ← absent disabled enabled	Состояние кластера.
url		URL для кластера.
username		Имя пользователя для кластера.
vms_ip_address		IP-адрес VSM, связанного с этим кластером.
vms_password		Пароль для VSM, связанного с этим кластером.
vms_username		Имя пользователя для VSM, связанного с этим кластером.
zone		Имя зоны, к которой принадлежит кластер. Если не задано, используется зона по умолчанию.

Примечания

Примечание

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 CloudStack Cloud Guide.
Этот модуль поддерживает режим проверки.

Примеры

# Ensure a cluster is present
- local_action:
    module: cs_cluster
    name: kvm-cluster-01
    zone: ch-zrh-ix-01
    hypervisor: KVM
    cluster_type: CloudManaged

# Ensure a cluster is disabled
- local_action:
    module: cs_cluster
    name: kvm-cluster-01
    zone: ch-zrh-ix-01
    state: disabled

# Ensure a cluster is enabled
- local_action:
    module: cs_cluster
    name: kvm-cluster-01
    zone: ch-zrh-ix-01
    state: enabled

# Ensure a cluster is absent
- local_action:
    module: cs_cluster
    name: kvm-cluster-01
    zone: ch-zrh-ix-01
    state: absent

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

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

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

Статус

Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будет вноситься обратной несовместимости.

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Более подробную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, поддерживаемых сообществом 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.6/modules/cs_cluster_module.html