vmware_vmkernel - Управление интерфейсом VMware VMkernel, также известным как виртуальные сетевые карты (NIC) системы хоста.

Новая версия 2.0.

Обзор
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Состояние
- Автор

Обзор

Этот модуль можно использовать для управления интерфейсом VMWare VMKernel (также известным как виртуальные сетевые карты) системы хоста.
Этот модуль предполагает, что хост уже настроен с группой портов и коммутатором vSwitch.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
enable_ft	Варианты: no yes	Включить интерфейс VMKernel для трафика Fault Tolerance.
enable_mgmt	Варианты: no yes	Включить интерфейс VMKernel для управляющего трафика.
enable_vmotion	Варианты: no yes	Включить интерфейс VMKernel для трафика vMotion.
enable_vsan	Варианты: no yes	Включить интерфейс VMKernel для трафика VSAN.
esxi_hostname обязательно (добавлено в 2.5)		Имя хоста ESXi, для которого будет управляться VMKernel. Начиная с версии 2.5, этот параметр является обязательным.
hostname		Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в версии 2.6.
ip_address		IP-адрес для интерфейса VMKernel. Используйте параметр `network` с `ip_address` вместо него. Устаревший параметр, будет удален в версии 2.9.
mtu	Значение по умолчанию: 1500	MTU для интерфейса VMKernel. Значение по умолчанию 1500 действует начиная с версии 2.5.
network (добавлено в 2.5)		Словарь с деталями сети. Требуется следующий параметр: - `type` (строка): Тип присвоения IP (либо `dhcp` или `static`). Следующие параметры требуются в случае, если `type` задано как `static`: - `ip_address` (строка): Статический IP-адрес (подразумевает `type: static`). - `netmask` (строка): Статическая маска сети, необходимая для `ip`.
password		Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в версии 2.6. псевдонимы: pass, pwd
port (добавлено в 2.5)	Значение по умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PORT`. Поддержка переменных окружения добавлена в версии 2.6.
portgroup_name обязательно		Имя группы портов для интерфейса VMKernel.
state (добавлено в 2.5)	Варианты: present ← absent	Если установлено `present`, VMKernel создается с заданными параметрами. Если установлено `absent`, VMKernel удаляется из заданной конфигурации. Если установлено `present` и VMKernel существует, то конфигурации VMKernel обновляются.
subnet_mask		Маска подсети для интерфейса VMKernel. Используйте параметр `network` с `subnet_mask` вместо него. Устаревший параметр, будет удален в версии 2.9.
username		Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_USER`. Поддержка переменных окружения добавлена в версии 2.6. псевдонимы: user, admin
validate_certs	Варианты: no yes Значение по умолчанию: True	Позволяет подключиться, когда сертификаты SSL недействительны. Установите в `false`, когда сертификаты не доверяются. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_VALIDATE_CERTS`. Поддержка переменных окружения добавлена в версии 2.6.
vlan_id (добавлено в 2.0)		Идентификатор VLAN для интерфейса VMKernel. Обязательный параметр только если `state` установлено в `present`. Необязательный параметр начиная с версии 2.5.
vswitch_name		Имя коммутатора vSwitch, где необходимо добавить интерфейс VMKernel. Обязательный параметр только если `state` установлено в `present`. Необязательный параметр начиная с версии 2.5.

Примечания

Примечание

Тестировано на vSphere 5.5, 6.5

Примеры

-  name: Add Management vmkernel port using static network type
   vmware_vmkernel:
      hostname: 192.168.127.9
      username: admin
      password: supersecret123
      vswitch_name: vSwitch0
      portgroup_name: PG_0001
      vlan_id: vlan_id
      network:
        type: 'static'
        ip_address: 192.168.127.10
        subnet_mask: 255.255.255.0
      state: present
      enable_mgmt: True

-  name: Add Management vmkernel port using DHCP network type
   vmware_vmkernel:
      hostname: 192.168.127.9
      username: admin
      password: supersecret123
      vswitch_name: vSwitch0
      portgroup_name: PG_0002
      vlan_id: vlan_id
      state: present
      network:
        type: 'dhcp'
      enable_mgmt: True

-  name: Delete VMkernel port using DHCP network type
   vmware_vmkernel:
      hostname: 192.168.127.9
      username: admin
      password: supersecret123
      vswitch_name: vSwitch0
      portgroup_name: PG_0002
      vlan_id: vlan_id
      state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
result словарь	всегда	метаданные о имени VMKernel Пример: {'results': 'vmk1'}

Состояние

Этот модуль помечен как экспериментальный, что означает, что его интерфейс не гарантируется обратной совместимостью.

Автор

Joseph Callen (@jcpowermac)
Russell Teague (@mtnbikenc)
Abhijeet Kasurde (@akasurde) <akasurde@redhat.com>

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ для его улучшения.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/vmware_vmkernel_module.html