vmware_vmkernel – Управляет адаптером VMware VMkernel хоста ESXi
Новая версия 2.0.
Описание
- Этот модуль может использоваться для управления адаптерами VMKernel / сетевыми интерфейсами VMKernel хоста ESXi.
- Модуль предполагает, что хост уже настроен с группой портов в случае стандартного переключателя vSphere (vSS).
- Модуль предполагает, что хост уже настроен с распределенной группой портов в случае распределенного переключателя vSphere (vDS).
- Модуль автоматически мигрирует адаптер VMKernel с vSS на vDS или наоборот, если он присутствует.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| device - добавлено в 2.8 | Поиск адаптера VMkernel по имени устройства. Параметр необходим только в случае, если type установлено в dhcp. | |
| dvswitch_name строка добавлено в 2.8 | Имя vSphere Distributed Switch (vDS), в котором следует добавить интерфейс VMKernel. Обязательный параметр только если state установлено в present.Необязательный параметр начиная с версии 2.8. псевдонимы: dvswitch | |
| enable_ft логическое |
| Включить трафик Fault Tolerance на адаптере VMKernel. Этот параметр разрешен только при использовании стандартной стековой TCP/IP. |
| enable_mgmt логическое |
| Включить трафик Management на адаптере VMKernel. Этот параметр разрешен только при использовании стандартной стековой TCP/IP. |
| enable_provisioning логическое добавлено в 2.8 |
| Включить трафик Provisioning на адаптере VMKernel. Этот параметр разрешен только при использовании стандартной стековой TCP/IP. |
| enable_replication логическое добавлено в 2.8 |
| Включить трафик vSphere Replication на адаптере VMKernel. Этот параметр разрешен только при использовании стандартной стековой TCP/IP. |
| enable_replication_nfc логическое добавлено в 2.8 |
| Включить трафик vSphere Replication NFC на адаптере VMKernel. Этот параметр разрешен только при использовании стандартной стековой TCP/IP. |
| enable_vmotion логическое |
| Включить трафик vMotion на адаптере VMKernel. Этот параметр разрешен только при использовании стандартной стековой TCP/IP. Нельзя включить vMotion на дополнительном адаптере, если уже настроен адаптер с конфигурацией vMotion TCP/IP. |
| enable_vsan логическое |
| Включить трафик VSAN на адаптере VMKernel. Этот параметр разрешен только при использовании стандартной стековой TCP/IP. |
| esxi_hostname - / обязательно добавлено в 2.5 | Имя хоста ESXi, на котором будет управляться VMKernel. Начиная с версии 2.5, этот параметр обязателен. | |
| hostname строка | Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды VMWARE_HOST.Поддержка переменных среды добавлена в Ansible 2.6. | |
| ip_address - | IP-адрес для интерфейса VMKernel. Используйте параметр network с ip_address вместо него.Устаревший параметр, будет удален в версии 2.9. | |
| mtu - | Значение по умолчанию: 1500 | MTU для интерфейса VMKernel. Значение по умолчанию 1500 действует начиная с версии 2.5. |
| network словарь добавлено в 2.5 | Значение по умолчанию: {"tcpip_stack": "default", "type": "static"} | Словарь с деталями сети. Требуется следующий параметр: - type (строка): Тип назначения IP (либо dhcp или static).Следующие параметры необходимы, если type установлено в static:- ip_address (строка): Статический IP-адрес (подразумевает type: static).- subnet_mask (строка): Статическая маска сети, необходимая для ip_address.Следующий параметр необязателен, если type установлено в static:- default_gateway (строка): Шлюз по умолчанию (переопределить шлюз по умолчанию для этого адаптера).Следующий параметр необязателен: - tcpip_stack (строка): Стек TCP/IP для интерфейса VMKernel. Может быть default, provisioning, vmotion или vxlan. (по умолчанию: default) |
| password строка | Пароль от сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды VMWARE_PASSWORD.Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd | |
| port целое число добавлено в 2.5 | Значение по умолчанию: 443 | Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды VMWARE_PORT.Поддержка переменных среды добавлена в Ansible 2.6. |
| portgroup_name - / обязательно | Имя группы портов для интерфейса VMKernel. псевдонимы: portgroup | |
| state - добавлено в 2.5 |
| Если установлено в present, адаптер VMKernel будет создан со заданными спецификациями.Если установлено в absent, адаптер VMKernel будет удален.Если установлено в present и адаптер VMKernel существует, конфигурации будут обновлены. |
| subnet_mask - | Маска подсети для интерфейса VMKernel. Используйте параметр network с subnet_mask вместо него.Устаревший параметр, будет удален в версии 2.9. | |
| username строка | Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды VMWARE_USER.Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user | |
| validate_certs логическое |
| Разрешает подключение, когда сертификаты SSL не валидны. Установите в false когда сертификаты не доверяются.Если значение не указано в задаче, используется значение переменной среды VMWARE_VALIDATE_CERTS.Поддержка переменных среды добавлена в Ansible 2.6. Если установлено в yes, убедитесь, что Python >= 2.7.9 установлен на данном компьютере. |
| vswitch_name строка | Имя vSwitch, в котором следует добавить интерфейс VMKernel. Обязательный параметр только если state установлено в present.Необязательный параметр начиная с версии 2.5. псевдонимы: vswitch |
Примечания
Примечание
- Параметр
deviceнеобходимо использовать с DHCP, иначе невозможно проверить, присутствует ли устройство VMkernel. - Можно перейти от DHCP к статическому, и от vSS к vDS, или наоборот, в один шаг, без создания нового устройства, при условии, что указан
device. - Адаптер VMKernel можно создать только на vDS, если авторизованы на vCenter, но не если авторизованы на ESXi.
- Проверено на 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 }}'
esxi_hostname: '{{ esxi_hostname }}'
vswitch_name: vSwitch0
portgroup_name: PG_0001
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 }}'
esxi_hostname: '{{ esxi_hostname }}'
vswitch_name: vSwitch0
portgroup_name: PG_0002
state: present
network:
type: 'dhcp'
enable_mgmt: True
delegate_to: localhost
- name: Change IP allocation from static to dhcp
vmware_vmkernel:
hostname: '{{ esxi_hostname }}'
username: '{{ esxi_username }}'
password: '{{ esxi_password }}'
esxi_hostname: '{{ esxi_hostname }}'
vswitch_name: vSwitch0
portgroup_name: PG_0002
state: present
device: vmk1
network:
type: 'dhcp'
enable_mgmt: True
delegate_to: localhost
- name: Delete VMkernel port
vmware_vmkernel:
hostname: '{{ esxi_hostname }}'
username: '{{ esxi_username }}'
password: '{{ esxi_password }}'
esxi_hostname: '{{ esxi_hostname }}'
vswitch_name: vSwitch0
portgroup_name: PG_0002
state: absent
delegate_to: localhost
- name: Add Management vmkernel port to Distributed Switch
vmware_vmkernel:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
dvswitch_name: dvSwitch1
portgroup_name: dvPG_0001
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 vMotion vmkernel port with vMotion TCP/IP stack
vmware_vmkernel:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
dvswitch_name: dvSwitch1
portgroup_name: dvPG_0001
network:
type: 'static'
ip_address: 192.168.127.10
subnet_mask: 255.255.255.0
tcpip_stack: vmotion
state: present
delegate_to: localhost
Значения возврата
Общие значения возвращаемых данных описаны здесь, ниже приведены поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| result словарь | всегда | метаданные о имени VMKernel Пример: {'changed': False, 'msg': 'VMkernel Adapter уже правильно настроен', 'device': 'vmk1', 'ipv4': 'статический', 'ipv4_gw': 'Без перезаписи', 'ipv4_ip': '192.168.1.15', 'ipv4_sm': '255.255.255.0', 'mtu': 9000, 'services': 'vMotion', 'switch': 'vDS'} |
Статус
- Данный модуль не гарантирует обратную совместимость. [превью]
- Этот модуль поддерживается сообществом Ansible. поддерживается сообществом Ansible. [сообщество]
Авторы
- Joseph Callen (@jcpowermac)
- Russell Teague (@mtnbikenc)
- Abhijeet Kasurde (@Akasurde)
- Christian Kotte (@ckotte)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/vmware_vmkernel_module.html