Модуль community.vmware.vmware_dvs_host — Добавление или удаление хоста из распределённого виртуального коммутатора

Примечание

Этот модуль входит в коллекцию community.vmware (версия 4.7.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.vmware.

Для использования в плейбуке укажите: community.vmware.vmware_dvs_host.

Обзор
Параметры
Примечания
Примеры

Обзор

Управление хост-системой из распределённого виртуального коммутатора.

Параметры

Параметр	Комментарии
esxi_hostname строка / обязательный	Имя хоста ESXi.
hostname строка	Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST`.
lag_uplinks список / элементы=словарь	VMnic хостов ESXi для использования с определёнными LAG. Если не задано, текущие LAG-соединения будут сохранены. Если задано, LAG-соединения будут установлены точно в этот список. Поэтому вы всегда должны определить полную конфигурацию LAG-соединения; в противном случае вы можете потерять LAG-соединения. Для удаления всех LAG-соединений используйте пустой список `[]`.
lag строка / обязательный	Имя LAG.
vmnics список / элементы=строка	VMnic хостов ESXi для использования с LAG. По умолчанию: `[]`
password псевдонимы: pass, pwd строка	Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD`.
port целое число	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT`. По умолчанию: `443`
proxy_host строка	Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_HOST`.
proxy_port целое число	Порт HTTP-прокси, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_PORT`.
state строка	Указывает, должен ли хост быть подключён к vSwitch или нет. Варианты: `"present"` ← (по умолчанию) `"absent"`
switch_name строка / обязательный	Имя распределённого vSwitch.
username псевдонимы: admin, user строка	Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`.
validate_certs булево	Разрешает подключение, когда SSL-сертификаты недействительны. Установите в `false`, когда сертификаты не надёжны. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
vendor_specific_config список / элементы=словарь	Список словарей ключ-значение для конфигурации поставщика.
key строка / обязательный	Ключ параметра.
value строка / обязательный	Значение параметра.
vmnics список / элементы=строка	VMnic хостов ESXi для использования с распределённым vSwitch. Если не задано, текущие соединения (не LAG) будут сохранены. Для удаления всех соединений (не LAG) используйте пустой список `[]`.

Примечания

Примечание

Все модули требуют доступа для записи в API и поэтому не поддерживаются в бесплатной лицензии ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.

END_OF_DOCUMENT_MARKER

Примеры

- name: Add Host to dVS
  community.vmware.vmware_dvs_host:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    switch_name: dvSwitch
    vmnics:
        - vmnic0
        - vmnic1
    state: present
  delegate_to: localhost

- name: Add vmnics to LAGs
  community.vmware.vmware_dvs_host:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    switch_name: dvSwitch
    lag_uplinks:
        - lag: lag1
          vmnics:
              - vmnic0
              - vmnic1
        - lag: lag2
          vmnics:
              - vmnic2
              - vmnic3
    state: present
  delegate_to: localhost

- name: Add Host to dVS/enable learnswitch (https://labs.vmware.com/flings/learnswitch)
  community.vmware.vmware_dvs_host:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    switch_name: dvSwitch
    vendor_specific_config:
        - key: com.vmware.netoverlay.layer1
          value: learnswitch
    vmnics:
        - vmnic0
        - vmnic1
    state: present
  delegate_to: localhost

Авторы

Joseph Callen (@jcpowermac)
Abhijeet Kasurde (@Akasurde)
Joseph Andreatta (@vmwjoseph)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/vmware/vmware_dvs_host_module.html