Spec-Zone.ru › Ansible 2.10

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
строка
    Варианты:
  • 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
строка
Пароль сервера 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

Spec-Zone.ru

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