community.vmware.vmware_cluster – Управление кластерами VMware vSphere
Примечание
Этот плагин входит в коллекцию community.vmware (версия 1.7.0).
Для его установки используйте: ansible-galaxy collection install community.vmware.
Для использования в плейбуке укажите: community.vmware.vmware_cluster.
Обзор
- Добавляет или удаляет кластеры VMware vSphere.
- Хотя этот модуль может управлять конфигурациями DRS, HA и VSAN, эта функциональность устарела и будет удалена в версии 2.12.
- Для управления конфигурациями DRS, HA и VSAN используйте новые модули vmware_cluster_drs, vmware_cluster_ha и vmware_cluster_vsan.
- Все значения и имена объектов VMware чувствительны к регистру.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- Проверено на ESXi 5.5 и 6.5.
- Установлен PyVmomi.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cluster_name строка / обязательно | Имя кластера, который будет управляться. | |
| datacenter строка / обязательно | Имя дата-центра. псевдонимы: datacenter_name | |
| drs_default_vm_behavior строка |
| Устанавливает поведение по умолчанию DRS для виртуальных машин в рамках всего кластера. Если установлено значение partiallyAutomated, vCenter генерирует рекомендации по миграции виртуальных машин и размещению на хостах. vCenter автоматически выполняет размещение при включении.Если установлено значение manual, vCenter генерирует рекомендации по миграции виртуальных машин и размещению на хостах. vCenter не должен автоматически выполнять рекомендации.Если установлено значение fullyAutomated, vCenter должен автоматизировать как миграцию виртуальных машин, так и их размещение на хосте при включении.Используйте drs_default_vm_behavior из community.vmware.vmware_cluster_drs вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| drs_enable_vm_behavior_overrides булево |
| Определяет, включены ли переопределения поведения DRS для отдельных виртуальных машин. Если установлено значение True, переопределяются drs_default_vm_behavior.Используйте drs_enable_vm_behavior_overrides из community.vmware.vmware_cluster_drs вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| drs_vmotion_rate целое число |
3 | Порог для сгенерированных ClusterRecommendations. Используйте drs_vmotion_rate из community.vmware.vmware_cluster_drs вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| enable_drs булево |
| Если установлено значение True, DRS будет включен при создании кластера.Используйте enable_drs из community.vmware.vmware_cluster_drs вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| enable_ha булево |
| Если установлено значение True, HA будет включен при создании кластера.Используйте enable_ha из community.vmware.vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| enable_vsan булево |
| Если установлено значение True, vSAN будет включен при создании кластера.Используйте enable_vsan из community.vmware.vmware_cluster_vsan вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_admission_control_enabled булево |
| Определяет, включен ли строгий контроль доступа. Рекомендуется установить этот параметр в значение True, подробнее см. документацию.Используйте slot_based_admission_control, reservation_based_admission_control или failover_host_admission_control из community.vmware.vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_failover_level целое число | Значение по умолчанию: 2 | Количество отказов хостов, которые должны быть терпимы, сохраняя при этом достаточные ресурсы для перезапуска виртуальных машин на доступных хостах. Принимаются только целочисленные значения. Используйте slot_based_admission_control, reservation_based_admission_control или failover_host_admission_control из community.vmware.vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_host_monitoring строка |
| Указывает, перезапускает ли HA виртуальные машины после отказа хоста. Если установлено значение enabled, HA перезапускает виртуальные машины после отказа хоста.Если установлено значение disabled, HA не перезапускает виртуальные машины после отказа хоста.Если enable_ha установлено в значение False, это значение игнорируется.Используйте ha_host_monitoring из community.vmware.vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_restart_priority строка |
| Определяет приоритет, который HA предоставляет виртуальной машине, если нет достаточной емкости для включения всех вышедших из строя виртуальных машин. Это значение имеет смысл только если ha_vm_monitoring установлено в значение vmAndAppMonitoring или vmMonitoringOnly.Если установлено значение disabled, HA отключен для этой виртуальной машины.Если установлено значение high, у виртуальных машин с этим приоритетом больше шансов включиться после сбоя, когда на хостах недостаточно ресурсов для удовлетворения потребностей всех виртуальных машин.Если установлено значение medium, у виртуальных машин с этим приоритетом средние шансы на включение после сбоя, когда на хостах недостаточно ресурсов для удовлетворения потребностей всех виртуальных машин.Если установлено значение low, у виртуальных машин с этим приоритетом меньшие шансы на включение после сбоя, когда на хостах недостаточно ресурсов для удовлетворения потребностей всех виртуальных машин.Используйте ha_restart_priority из community.vmware.vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_vm_failure_interval целое число | Значение по умолчанию: 30 | Количество секунд после которого виртуальная машина считается вышедшей из строя, если не получен сигнал о работе. Это значение имеет смысл только если ha_vm_monitoring установлено в значение vmAndAppMonitoring или vmMonitoringOnly.Единица измерения - секунды. Используйте ha_vm_failure_interval из community.vmware.vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_vm_max_failure_window целое число | Значение по умолчанию: -1 | Количество секунд, в течение которых до ha_vm_max_failures перезапусков может произойти, прежде чем автоматические ответы прекратятся.Это значение имеет смысл только если ha_vm_monitoring установлено в значение vmAndAppMonitoring или vmMonitoringOnly. Единица измерения - секунды. Значение по умолчанию указывает на отсутствие окна сбоев. Используйте ha_vm_max_failure_window из community.vmware.vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_vm_max_failures целое число | Значение по умолчанию: 3 | Максимальное количество отказов и автоматических перезапусков, разрешенных в течение периода, указанного параметром ha_vm_max_failure_window. Это значение имеет смысл только если ha_vm_monitoring установлено в значение vmAndAppMonitoring или vmMonitoringOnly. Используйте ha_vm_max_failures из community.vmware.vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_vm_min_up_time целое число | Значение по умолчанию: 120 | Количество секунд, в течение которых сигналы о работе виртуальной машины должны стабилизироваться после того, как виртуальная машина была включена. Это значение имеет смысл только если ha_vm_monitoring установлено в значение vmAndAppMonitoring или vmMonitoringOnly. Единица измерения - секунды. Используйте ha_vm_min_up_time из community.vmware.vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_vm_monitoring строка |
| Указывает состояние службы мониторинга состояния виртуальной машины. Если установлено значение vmAndAppMonitoring, HA реагирует на сбои как виртуальных машин, так и приложений.Если установлено значение vmMonitoringDisabled, мониторинг состояния виртуальной машины отключен.Если установлено значение vmMonitoringOnly, HA реагирует на сбои виртуальных машин.Если enable_ha установлено в значение False, это значение игнорируется.Используйте ha_vm_monitoring из community.vmware.vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| hostname строка | Имя хоста или IP-адрес сервера vCenter или ESXi. Если значение не указано в задании, будет использовано значение переменной окружения VMWARE_HOST. Поддержка переменных окружения добавлена в Ansible 2.6. | |
| ignore_drs булево |
| Если установлено значение True, DRS не будет настроен; все явные и значения по умолчанию для конфигураций, связанных с DRS, будут проигнорированы. |
| ignore_ha булево |
| Если установлено значение True, HA не будет настроен; все явные и значения по умолчанию для конфигураций, связанных с HA, будут проигнорированы. |
| ignore_vsan boolean |
| Если установлено значение True, VSAN не будет настроен; все явные и по умолчанию настройки, связанные с VSAN, будут проигнорированы. |
| password string | Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PASSWORD. Поддержка переменных среды добавлена в Ansible 2.6. Псевдонимы: pass, pwd | |
| port integer | По умолчанию: 443 | Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PORT. Поддержка переменных среды добавлена в Ansible 2.6. |
| proxy_host string | Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PROXY_HOST. Эта функция зависит от версии pyvmomi, большей v6.7.1.2018.12 | |
| proxy_port integer | Порт HTTP-прокси, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PROXY_PORT. | |
| state string |
| Создать present или удалить absent кластер VMware vSphere. |
| username string | Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_USER. Поддержка переменных среды добавлена в Ansible 2.6. Псевдонимы: admin, user | |
| validate_certs boolean |
| Разрешает подключение, когда сертификаты SSL недействительны. Установите значение false, когда сертификаты не доверяются.Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_VALIDATE_CERTS. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено значение true, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
| vsan_auto_claim_storage boolean |
| Определяет, настроен ли сервис VSAN на автоматическое присвоение локального хранилища на узлах, поддерживающих VSAN, в кластере. Используйте vsan_auto_claim_storage вместо community.vmware.vmware_cluster_vsan.Устаревший параметр, будет удален в версии 2.12. |
См. также
См. также
- community.vmware.vmware_cluster_drs
-
Официальная документация по модулю community.vmware.vmware_cluster_drs.
- community.vmware.vmware_cluster_ha
-
Официальная документация по модулю community.vmware.vmware_cluster_ha.
- community.vmware.vmware_cluster_vsan
-
Официальная документация по модулю community.vmware.vmware_cluster_vsan.
Примеры
- name: Create Cluster
community.vmware.vmware_cluster:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter_name: datacenter
cluster_name: cluster
enable_ha: true
enable_drs: true
enable_vsan: true
delegate_to: localhost
- name: Create Cluster with additional changes
community.vmware.vmware_cluster:
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
datacenter_name: DC0
cluster_name: "{{ cluster_name }}"
enable_ha: True
ha_vm_monitoring: vmMonitoringOnly
enable_drs: True
drs_default_vm_behavior: partiallyAutomated
enable_vsan: True
register: cl_result
delegate_to: localhost
- name: Delete Cluster
community.vmware.vmware_cluster:
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
datacenter_name: datacenter
cluster_name: cluster
enable_ha: true
enable_drs: true
enable_vsan: true
state: absent
delegate_to: localhost
Авторы
- Joseph Callen (@jcpowermac)
- Abhijeet Kasurde (@Akasurde)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/vmware/vmware_cluster_module.html