vmware_cluster – Управление кластерами VMware vSphere
Описание
- Добавляет или удаляет кластеры 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 - добавлен в 2.8 |
| Указывает поведение DRS по умолчанию для виртуальных машин в кластере. Если установлено значение partiallyAutomated, vCenter генерирует рекомендации по миграции виртуальных машин и их размещению на хостах. vCenter автоматически выполняет размещение при включении.Если установлено значение manual, vCenter генерирует рекомендации по миграции виртуальных машин и их размещению на хостах. vCenter не должен автоматически выполнять рекомендации.Если установлено значение fullyAutomated, vCenter должен автоматизировать как миграцию виртуальных машин, так и их размещение на хосте при включении.Используйте drs_default_vm_behavior модуля vmware_cluster_drs вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| drs_enable_vm_behavior_overrides логическое добавлен в 2.8 |
| Определяет, включены ли переопределения поведения DRS для отдельных виртуальных машин. Если установлено значение True, переопределяются drs_default_vm_behavior.Используйте drs_enable_vm_behavior_overrides модуля vmware_cluster_drs вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| drs_vmotion_rate - добавлен в 2.8 |
| Порог для сгенерированных рекомендаций кластера. Используйте drs_vmotion_rate модуля vmware_cluster_drs вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| enable_drs логическое |
| Если установлено значение yes, DRS будет включен при создании кластера.Используйте enable_drs модуля vmware_cluster_drs вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| enable_ha логическое |
| Если установлено значение yes, HA будет включен при создании кластера.Используйте enable_ha модуля vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| enable_vsan логическое |
| Если установлено значение yes, vSAN будет включен при создании кластера.Используйте enable_vsan модуля vmware_cluster_vsan вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_admission_control_enabled логическое добавлен в 2.8 |
| Определяет, включен ли строгий контроль доступа. Рекомендуется установить этот параметр в значение True, см. документацию для получения более подробной информации.Используйте slot_based_admission_control, reservation_based_admission_control или failover_host_admission_control модуля vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_failover_level - добавлен в 2.8 | Значение по умолчанию: 2 | Количество сбоев хостов, которые должны быть терпимы, при этом гарантируется достаточность ресурсов для перезапуска виртуальных машин на доступных хостах. Принимаются только целые значения. Используйте slot_based_admission_control, reservation_based_admission_control или failover_host_admission_control модуля vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_host_monitoring - добавлен в 2.8 |
| Указывает, перезапускает ли HA виртуальные машины после сбоя хоста. Если установлено значение enabled, HA перезапускает виртуальные машины после сбоя хоста.Если установлено значение disabled, HA не перезапускает виртуальные машины после сбоя хоста.Если enable_ha установлено в значение no, это значение игнорируется.Используйте ha_host_monitoring модуля vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_restart_priority - добавлен в 2.8 |
| Определяет приоритет, который HA присваивает виртуальной машине, если достаточной емкости нет для включения всех отказавших виртуальных машин. Это значение имеет смысл только, если ha_vm_monitoring установлено в значение vmAndAppMonitoring или vmMonitoringOnly. Если установлено значение disabled, HA отключено для этой виртуальной машины.Если установлено значение high, виртуальные машины с этим приоритетом имеют больше шансов включиться после сбоя, когда на хостах недостаточно ресурсов для удовлетворения потребностей всех виртуальных машин.Если установлено значение medium, виртуальные машины с этим приоритетом имеют средний шанс включиться после сбоя, когда на хостах недостаточно ресурсов для удовлетворения потребностей всех виртуальных машин.Если установлено значение low, виртуальные машины с этим приоритетом имеют меньший шанс включиться после сбоя, когда на хостах недостаточно ресурсов для удовлетворения потребностей всех виртуальных машин.Используйте ha_restart_priority модуля vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_vm_failure_interval - добавлен в 2.8 | Значение по умолчанию: 30 | Количество секунд, по истечении которых виртуальная машина считается вышедшей из строя, если не получено никакого подтверждения о ее функционировании. Это значение имеет смысл только, если ha_vm_monitoring установлено в значение vmAndAppMonitoring или vmMonitoringOnly. Единица измерения - секунды. Используйте ha_vm_failure_interval модуля vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_vm_max_failure_window - добавлен в 2.8 | Значение по умолчанию: -1 | Количество секунд для окна, в течение которого может произойти до ha_vm_max_failures повторных восстановлений, прежде чем автоматические ответы прекратятся.Это значение имеет смысл только, если ha_vm_monitoring установлено в значение vmAndAppMonitoring или vmMonitoringOnly. Единица измерения - секунды. Значение по умолчанию указывает на отсутствие окна сбоев. Используйте ha_vm_max_failure_window модуля vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_vm_max_failures - добавлен в 2.8 | Значение по умолчанию: 3 | Максимальное количество сбоев и автоматических восстановлений, разрешенных в течение времени, указанного в ha_vm_max_failure_window. Это значение имеет смысл только, если ha_vm_monitoring установлено в значение vmAndAppMonitoring или vmMonitoringOnly. Используйте ha_vm_max_failures модуля vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_vm_min_up_time - добавлен в 2.8 | Значение по умолчанию: 120 | Количество секунд, необходимое для стабилизации подтверждений виртуальной машины после включения виртуальной машины. Это значение имеет смысл только, если ha_vm_monitoring установлено в значение vmAndAppMonitoring или vmMonitoringOnly. Единица измерения - секунды. Используйте ha_vm_min_up_time модуля vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| ha_vm_monitoring - added in 2.8 |
| Указывает состояние службы мониторинга виртуальных машин. Если установлено vmAndAppMonitoring, HA реагирует на сбои в работе как виртуальных машин, так и приложений.Если установлено vmMonitoringDisabled, мониторинг работоспособности виртуальных машин отключен.Если установлено vmMonitoringOnly, HA реагирует только на сбои в работе виртуальных машин.Если enable_ha установлено в no, это значение игнорируется.Используйте ha_vm_monitoring из vmware_cluster_ha вместо этого.Устаревший параметр, будет удален в версии 2.12. |
| hostname string | Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_HOST. Поддержка переменных окружения добавлена в Ansible 2.6. | |
| ignore_drs boolean added in 2.9 |
| Если установлено yes, DRS не будет настроен; все явные и стандартные конфигурации, связанные с DRS, будут проигнорированы. |
| ignore_ha boolean added in 2.9 |
| Если установлено yes, HA не будет настроен; все явные и стандартные конфигурации, связанные с HA, будут проигнорированы. |
| ignore_vsan boolean added in 2.9 |
| Если установлено yes, VSAN не будет настроен; все явные и стандартные конфигурации, связанные с VSAN, будут проигнорированы. |
| password string | Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD. Поддержка переменных окружения добавлена в Ansible 2.6. aliases: pass, pwd | |
| port integer added in 2.5 | Default: 443 | Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PORT. Поддержка переменных окружения добавлена в Ansible 2.6. |
| proxy_host string added in 2.9 | Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PROXY_HOST. Эта функция зависит от версии pyvmomi, большей чем v6.7.1.2018.12 | |
| proxy_port integer added in 2.9 | Порт HTTP-прокси, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PROXY_PORT. | |
| state - |
| Создать present или удалить absent кластер VMware vSphere. |
| username string | Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER. Поддержка переменных окружения добавлена в Ansible 2.6. aliases: admin, user | |
| validate_certs boolean |
| Разрешает подключение, когда сертификаты SSL недействительны. Установите в false, когда сертификаты ненадёжны.Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_VALIDATE_CERTS. Поддержка переменных окружения добавлена в Ansible 2.6. Если установлено yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
| vsan_auto_claim_storage boolean added in 2.8 |
| Определяет, настроен ли сервис VSAN для автоматического требования локального хранилища на узлах, поддерживающих VSAN, в кластере. Используйте vsan_auto_claim_storage из vmware_cluster_vsan вместо этого.Устаревший параметр, будет удален в версии 2.12. |
См. также
См. также
- vmware_cluster_drs – Управление планировщиком ресурсов DRS (DRS) в кластерах VMware vSphere
- Официальная документация по модулю vmware_cluster_drs.
- vmware_cluster_ha – Управление высокой доступностью (HA) в кластерах VMware vSphere
- Официальная документация по модулю vmware_cluster_ha.
- vmware_cluster_vsan – Управление настройками виртуальной сети хранения данных (vSAN) в кластерах VMware vSphere
- Официальная документация по модулю vmware_cluster_vsan.
Примеры
- name: Create Cluster
vmware_cluster:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter_name: datacenter
cluster_name: cluster
enable_ha: yes
enable_drs: yes
enable_vsan: yes
delegate_to: localhost
- name: Create Cluster with additional changes
vmware_cluster:
hostname: "{{ vcenter_server }}"
username: "{{ vcenter_user }}"
password: "{{ vcenter_pass }}"
validate_certs: no
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
vmware_cluster:
hostname: "{{ vcenter_server }}"
username: "{{ vcenter_user }}"
password: "{{ vcenter_pass }}"
datacenter_name: datacenter
cluster_name: cluster
enable_ha: yes
enable_drs: yes
enable_vsan: yes
state: absent
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [preview]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- 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.9/modules/vmware_cluster_module.html