Spec-Zone.ru › Ansible 2.9

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
    Варианты:
  • fullyAutomated ←
  • manual
  • partiallyAutomated
Указывает поведение 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
    Варианты:
  • no
  • yes ←
Определяет, включены ли переопределения поведения DRS для отдельных виртуальных машин.
Если установлено значение True, переопределяются drs_default_vm_behavior.
Используйте drs_enable_vm_behavior_overrides модуля vmware_cluster_drs вместо этого.
Устаревший параметр, будет удален в версии 2.12.
drs_vmotion_rate
-
добавлен в 2.8
    Варианты:
  • 1
  • 2
  • 3 ←
  • 4
  • 5
Порог для сгенерированных рекомендаций кластера.
Используйте drs_vmotion_rate модуля vmware_cluster_drs вместо этого.
Устаревший параметр, будет удален в версии 2.12.
enable_drs
логическое
    Варианты:
  • no ←
  • yes
Если установлено значение yes, DRS будет включен при создании кластера.
Используйте enable_drs модуля vmware_cluster_drs вместо этого.
Устаревший параметр, будет удален в версии 2.12.
enable_ha
логическое
    Варианты:
  • no ←
  • yes
Если установлено значение yes, HA будет включен при создании кластера.
Используйте enable_ha модуля vmware_cluster_ha вместо этого.
Устаревший параметр, будет удален в версии 2.12.
enable_vsan
логическое
    Варианты:
  • no ←
  • yes
Если установлено значение yes, vSAN будет включен при создании кластера.
Используйте enable_vsan модуля vmware_cluster_vsan вместо этого.
Устаревший параметр, будет удален в версии 2.12.
ha_admission_control_enabled
логическое
добавлен в 2.8
    Варианты:
  • no
  • yes ←
Определяет, включен ли строгий контроль доступа.
Рекомендуется установить этот параметр в значение 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
    Варианты:
  • enabled ←
  • disabled
Указывает, перезапускает ли HA виртуальные машины после сбоя хоста.
Если установлено значение enabled, HA перезапускает виртуальные машины после сбоя хоста.
Если установлено значение disabled, HA не перезапускает виртуальные машины после сбоя хоста.
Если enable_ha установлено в значение no, это значение игнорируется.
Используйте ha_host_monitoring модуля vmware_cluster_ha вместо этого.
Устаревший параметр, будет удален в версии 2.12.
ha_restart_priority
-
добавлен в 2.8
    Варианты:
  • disabled
  • high
  • low
  • medium ←
Определяет приоритет, который 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
    Choices:
  • vmAndAppMonitoring
  • vmMonitoringOnly
  • vmMonitoringDisabled ←
Указывает состояние службы мониторинга виртуальных машин.
Если установлено 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
    Choices:
  • no ←
  • yes
Если установлено yes, DRS не будет настроен; все явные и стандартные конфигурации, связанные с DRS, будут проигнорированы.
ignore_ha
boolean
added in 2.9
    Choices:
  • no ←
  • yes
Если установлено yes, HA не будет настроен; все явные и стандартные конфигурации, связанные с HA, будут проигнорированы.
ignore_vsan
boolean
added in 2.9
    Choices:
  • no ←
  • yes
Если установлено 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
-
    Choices:
  • absent
  • present ←
Создать present или удалить absent кластер VMware vSphere.
username
string
Имя пользователя сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER.
Поддержка переменных окружения добавлена в Ansible 2.6.

aliases: admin, user
validate_certs
boolean
    Choices:
  • no
  • yes ←
Разрешает подключение, когда сертификаты SSL недействительны. Установите в false, когда сертификаты ненадёжны.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_VALIDATE_CERTS.
Поддержка переменных окружения добавлена в Ansible 2.6.
Если установлено yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
vsan_auto_claim_storage
boolean
added in 2.8
    Choices:
  • no ←
  • yes
Определяет, настроен ли сервис 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API