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

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

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

Обзор

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

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
enable_ft boolean	Варианты: no yes	Включить интерфейс VMKernel для трафика Fault Tolerance.
enable_mgmt boolean	Варианты: no yes	Включить интерфейс VMKernel для управляющего трафика.
enable_vmotion boolean	Варианты: no yes	Включить интерфейс VMKernel для трафика vMotion.
enable_vsan boolean	Варианты: 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`). - `subnet_mask` (строка): Статическая маска подсети, необходимая для `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. псевдонимы: admin, user
validate_certs boolean	Варианты: no yes ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите в значение `false`, когда сертификаты не доверяются. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_VALIDATE_CERTS`. Поддержка переменных окружения добавлена в версии 2.6. Если установлено в значение `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
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: '{{ esxi_hostname }}'
      username: '{{ esxi_username }}'
      password: '{{ esxi_password }}'
      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
   delegate_to: localhost

-  name: Add Management vmkernel port using DHCP network type
   vmware_vmkernel:
      hostname: '{{ esxi_hostname }}'
      username: '{{ esxi_username }}'
      password: '{{ esxi_password }}'
      vswitch_name: vSwitch0
      portgroup_name: PG_0002
      vlan_id: '{{ vlan_id }}'
      state: present
      network:
        type: 'dhcp'
      enable_mgmt: True
   delegate_to: localhost

-  name: Delete VMkernel port using DHCP network type
   vmware_vmkernel:
      hostname: '{{ esxi_hostname }}'
      username: '{{ esxi_username }}'
      password: '{{ esxi_password }}'
      vswitch_name: vSwitch0
      portgroup_name: PG_0002
      vlan_id: '{{ vlan_id }}'
      state: absent
   delegate_to: localhost

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

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

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

Статус

Этот модуль не гарантирует обратной совместимости. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.7/modules/vmware_vmkernel_module.html