Spec-Zone.ru › Ansible 2.11

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
строка
    Варианты:
  • fullyAutomated ←
  • manual
  • partiallyAutomated
Устанавливает поведение по умолчанию 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
булево
    Варианты:
  • no
  • yes ←
Определяет, включены ли переопределения поведения DRS для отдельных виртуальных машин.
Если установлено значение True, переопределяются drs_default_vm_behavior.
Используйте drs_enable_vm_behavior_overrides из community.vmware.vmware_cluster_drs вместо этого.
Устаревший параметр, будет удален в версии 2.12.
drs_vmotion_rate
целое число
    Варианты:
  • 1
  • 2
  • 3
  • 4
  • 5
Значение по умолчанию:
3
Порог для сгенерированных ClusterRecommendations.
Используйте drs_vmotion_rate из community.vmware.vmware_cluster_drs вместо этого.
Устаревший параметр, будет удален в версии 2.12.
enable_drs
булево
    Варианты:
  • no ←
  • yes
Если установлено значение True, DRS будет включен при создании кластера.
Используйте enable_drs из community.vmware.vmware_cluster_drs вместо этого.
Устаревший параметр, будет удален в версии 2.12.
enable_ha
булево
    Варианты:
  • no ←
  • yes
Если установлено значение True, HA будет включен при создании кластера.
Используйте enable_ha из community.vmware.vmware_cluster_ha вместо этого.
Устаревший параметр, будет удален в версии 2.12.
enable_vsan
булево
    Варианты:
  • no ←
  • yes
Если установлено значение True, vSAN будет включен при создании кластера.
Используйте enable_vsan из community.vmware.vmware_cluster_vsan вместо этого.
Устаревший параметр, будет удален в версии 2.12.
ha_admission_control_enabled
булево
    Варианты:
  • no
  • yes ←
Определяет, включен ли строгий контроль доступа.
Рекомендуется установить этот параметр в значение 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
строка
    Варианты:
  • enabled ←
  • disabled
Указывает, перезапускает ли HA виртуальные машины после отказа хоста.
Если установлено значение enabled, HA перезапускает виртуальные машины после отказа хоста.
Если установлено значение disabled, HA не перезапускает виртуальные машины после отказа хоста.
Если enable_ha установлено в значение False, это значение игнорируется.
Используйте ha_host_monitoring из community.vmware.vmware_cluster_ha вместо этого.
Устаревший параметр, будет удален в версии 2.12.
ha_restart_priority
строка
    Варианты:
  • disabled
  • high
  • low
  • medium ←
Определяет приоритет, который 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
  • vmMonitoringOnly
  • vmMonitoringDisabled ←
Указывает состояние службы мониторинга состояния виртуальной машины.
Если установлено значение 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
булево
    Варианты:
  • no ←
  • yes
Если установлено значение True, DRS не будет настроен; все явные и значения по умолчанию для конфигураций, связанных с DRS, будут проигнорированы.
ignore_ha
булево
    Варианты:
  • no ←
  • yes
Если установлено значение 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

Spec-Zone.ru

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