vmware_cluster – Управление кластерами VMware vSphere
Новая версия с 2.0.
Обзор
- Этот модуль может использоваться для добавления, удаления и обновления кластеров VMware vSphere и их конфигураций.
- Модуль может управлять конфигурациями, связанными с HA, DRS и 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_enable_vm_behavior_overrides boolean добавлен в 2.8 |
| Определяет, включены ли переопределения поведения DRS для отдельных виртуальных машин. Если установлено значение True, переопределения drs_default_vm_behavior. |
| drs_vmotion_rate - добавлен в 2.8 |
| Пороговое значение для сгенерированных рекомендаций кластера. |
| enable_drs boolean |
| Если установлено значение yes, DRS будет включен при создании кластера. |
| enable_ha boolean |
| Если установлено значение yes, HA будет включен при создании кластера. |
| enable_vsan boolean |
| Если установлено значение yes, vSAN будет включен при создании кластера. |
| ha_admission_control_enabled boolean добавлен в 2.8 |
| Определяет, включен ли строгий контроль допуска. Рекомендуется установить это значение в True, см. документацию для получения дополнительной информации. |
| ha_failover_level - добавлен в 2.8 | Значение по умолчанию: 2 | Количество сбоев хоста, которые должны быть терпимы, гарантируя достаточные ресурсы для перезапуска виртуальных машин на доступных хостах. Принимаются только целочисленные значения. |
| ha_host_monitoring - добавлен в 2.8 |
| Указывает, перезапускает ли HA виртуальные машины после сбоя хоста. Если установлено значение enabled, HA перезапускает виртуальные машины после сбоя хоста.Если установлено значение disabled, HA не перезапускает виртуальные машины после сбоя хоста.Если enable_ha установлено в no, это значение игнорируется. |
| ha_restart_priority - добавлен в 2.8 |
| Определяет приоритет, который HA присваивает виртуальной машине, если достаточной емкости нет для включения всех выведенных из строя виртуальных машин. Это значение действительно только если ha_vm_monitoring установлено в vmAndAppMonitoring или vmMonitoringOnly. Если установлено значение disabled, HA отключено для этой виртуальной машины.Если установлено значение high, виртуальная машина с этим приоритетом имеет больше шансов быть включенной после сбоя, когда на хостах недостаточно ресурсов для всех виртуальных машин.Если установлено значение medium, виртуальная машина с этим приоритетом имеет промежуточный шанс включения после сбоя, когда на хостах недостаточно ресурсов для всех виртуальных машин.Если установлено значение low, виртуальная машина с этим приоритетом имеет меньший шанс включения после сбоя, когда на хостах недостаточно ресурсов для всех виртуальных машин. |
| ha_vm_failure_interval - добавлен в 2.8 | Значение по умолчанию: 30 | Количество секунд, через которое виртуальная машина считается неисправной, если не получено сообщение о работе. Это значение действительно только если ha_vm_monitoring установлено в vmAndAppMonitoring или vmMonitoringOnly. Единица измерения - секунды. |
| ha_vm_max_failure_window - добавлен в 2.8 | Значение по умолчанию: -1 | Количество секунд для окна, в течение которого может произойти до ha_vm_max_failures перезапусков перед прекращением автоматических ответов.Это значение действительно только если ha_vm_monitoring установлено в vmAndAppMonitoring или vmMonitoringOnly. Единица измерения - секунды. Значение по умолчанию указывает отсутствие окна сбоев. |
| ha_vm_max_failures - добавлен в 2.8 | Значение по умолчанию: 3 | Максимальное количество сбоев и автоматических перезапусков, разрешенных в течение времени, указанного параметром ha_vm_max_failure_window. Это значение действительно только если ha_vm_monitoring установлено в vmAndAppMonitoring или vmMonitoringOnly. |
| ha_vm_min_up_time - добавлен в 2.8 | Значение по умолчанию: 120 | Количество секунд, через которое стабилизируются сигналы о работе виртуальной машины после включения. Это значение действительно только если ha_vm_monitoring установлено в vmAndAppMonitoring или vmMonitoringOnly. Единица измерения - секунды. |
| ha_vm_monitoring - добавлен в 2.8 |
| Указывает состояние службы мониторинга работоспособности виртуальных машин. Если установлено значение vmAndAppMonitoring, HA реагирует на сбои как виртуальных машин, так и приложений.Если установлено значение vmMonitoringDisabled, мониторинг работоспособности виртуальных машин отключен.Если установлено значение vmMonitoringOnly, HA реагирует на сбои виртуальных машин.Если enable_ha установлено в no, это значение игнорируется. |
| hostname string | Имя хоста или IP-адрес сервера vCenter или ESXi. Если значение не указано в задаче, будет использоваться значение переменной среды VMWARE_HOST. Поддержка переменных среды добавлена в Ansible 2.6. | |
| password string | Пароль сервера vCenter или ESXi. Если значение не указано в задаче, будет использоваться значение переменной среды VMWARE_PASSWORD. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd | |
| port integer добавлен в 2.5 | Значение по умолчанию: 443 | Номер порта сервера vCenter или ESXi. Если значение не указано в задаче, будет использоваться значение переменной среды VMWARE_PORT. Поддержка переменных среды добавлена в Ansible 2.6. |
| состояние - |
| Создать present или удалить absent кластер VMware vSphere. |
| имя_пользователя строка | Имя пользователя vCenter или сервера ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_USER. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user | |
| validate_certs логическое |
| Разрешает подключение, когда сертификаты SSL недействительны. Установите значение false, когда сертификаты ненадёжны.Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_VALIDATE_CERTS. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено значение yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
| vsan_auto_claim_storage логическое добавлено в 2.8 |
| Определяет, настроена ли служба VSAN для автоматического запроса локального хранилища на 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
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.8/modules/vmware_cluster_module.html