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

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

Обзор
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
Значения возврата
Примечания
- Статус

Обзор

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

Требования (к хосту, на котором выполняется модуль)

python >= 2.6
cs >= 0.6.10

Параметры

параметр	обязательно	по умолчанию	значения	комментарии
api_http_method	нет	get	get post	Используемый HTTP-метод.
api_key	нет			Ключ API CloudStack API.
api_region	нет	cloudstack		Имя раздела ini в файле `cloustack.ini`.
api_secret	нет			Секретный ключ CloudStack API.
api_timeout	нет	10		Таймаут HTTP.
api_url	нет			URL CloudStack API, например, https://cloud.example.com/client/api.
cluster_type	нет		CloudManaged ExternalManaged	Тип кластера. Требуется, если `state=present`
guest_vswitch_name	нет			Имя виртуального шлюза, используемого для трафика гостей в кластере. Это переопределяет настройку метки трафика на уровне зоны.
guest_vswitch_type	нет		vmwaresvs vmwaredvs	Тип виртуального шлюза, используемого для трафика гостей в кластере. Допустимые значения: vmwaresvs (для стандартного vSwitch VMware) и vmwaredvs (для распределенного vSwitch VMware).
hypervisor	нет	none	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 (для стандартного vSwitch VMware) и vmwaredvs (для распределенного vSwitch VMware).
state	нет	present	present absent disabled enabled	Состояние кластера.
url	нет			URL кластера
username	нет			Имя пользователя кластера.
vms_ip_address	нет			IP-адрес VSM, связанного с этим кластером.
vms_password	нет			Пароль для VSM, связанного с этим кластером.
vms_username	нет			Имя пользователя для VSM, связанного с этим кластером.
zone	нет			Имя зоны, к которой принадлежит кластер. Если не указано, используется зона по умолчанию.

Примеры

# 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	Состояние кластера.	успешно	строка	Включено
cluster_type	Тип кластера.	успешно	строка	ExternalManaged
cpu_overcommit_ratio	Коэффициент перераспределения ЦП кластера.	успешно	строка	1.0
hypervisor	Гипервизор кластера	успешно	строка	VMware
id	UUID кластера.	успешно	строка	04589590-ac63-4ffc-93f5-b698b8ac38b6
managed_state	Управляется ли этот кластер CloudStack.	успешно	строка	Управляется
memory_overcommit_ratio	Коэффициент перераспределения памяти кластера.	успешно	строка	1.0
name	Имя кластера.	успешно	строка	cluster01
ovm3_vip	Ovm3 VIP для использования в пуллировании и/или кластеризации	успешно	строка	10.10.10.101
pod	Имя подсети, в которой находится кластер.	успешно	строка	pod01
zone	Имя зоны, в которой находится кластер.	успешно	строка	ch-gva-2

Примечания

Примечание

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 можно найти на http://docs.ansible.com/ansible/guide_cloudstack.html
Этот модуль поддерживает режим проверки.

Статус

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

Для получения помощи в разработке модулей, если вы так решите, прочитайте Информацию сообщества и вклад, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/cs_cluster_module.html