community.vmware.vmware_cluster – Управление кластерами VMware vSphere
Примечание
Этот плагин входит в коллекцию community.vmware (версия 1.6.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 строка | Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PASSWORD. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd | |
| port целое число | По умолчанию: 443 | Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PORT. Поддержка переменных среды добавлена в Ansible 2.6. |
| proxy_host строка | Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PROXY_HOST. Эта функция зависит от версии pyvmomi, большей чем v6.7.1.2018.12 | |
| proxy_port целое число | Порт HTTP-прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PROXY_PORT. | |
| state строка |
| Создать present или удалить absent кластер VMware vSphere. |
| username строка | Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/vmware/vmware_cluster_module.html