vmware_vmkernel - Управление интерфейсом VMware VMkernel, также известным как виртуальные сетевые карты системы хоста.
Новая в версии 2.0.
Описание
- Этот модуль можно использовать для управления интерфейсом VMware VMKernel (также известным как виртуальные сетевые карты) системы хоста.
- Этот модуль предполагает, что хост уже настроен с группой портов и коммутатором vSwitch.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| enable_ft bool |
| Включить интерфейс VMKernel для трафика отказоустойчивости. |
| enable_mgmt bool |
| Включить интерфейс VMKernel для управляющего трафика. |
| enable_vmotion bool |
| Включить интерфейс VMKernel для трафика vMotion. |
| enable_vsan bool |
| Включить интерфейс VMKernel для трафика VSAN. |
| esxi_hostname обязательно (добавлен в 2.5) | Имя хоста ESXi, к которому нужно управлять VMKernel. Начиная с версии 2.5, этот параметр является обязательным. | |
| hostname str | Имя хоста или 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 str | Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задании, используется значение переменной окружения VMWARE_PASSWORD.Поддержка переменных окружения добавлена в версии 2.6. псевдонимы: pass, pwd | |
| port int (добавлен в 2.5) | Значение по умолчанию: 443 | Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задании, используется значение переменной окружения VMWARE_PORT.Поддержка переменных окружения добавлена в версии 2.6. |
| portgroup_name обязательно | Имя группы портов для интерфейса VMKernel. | |
| state (добавлен в 2.5) |
| Если установлено в значение present, VMKernel создаётся с заданными параметрами.Если установлено в значение absent, VMKernel удаляется из заданных настроек.Если установлено в значение present и VMKernel существует, то конфигурации VMKernel обновляются. |
| subnet_mask | Маска подсети для интерфейса VMKernel. Используйте параметр network с subnet_mask вместо него.Устаревший параметр, будет удален в версии 2.9. | |
| username str | Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задании, используется значение переменной окружения VMWARE_USER.Поддержка переменных окружения добавлена в версии 2.6. псевдонимы: admin, user | |
| validate_certs bool |
| Разрешает подключение, когда сертификаты 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: 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 dict | всегда | метаданные об имени VMKernel Пример: {'results': 'vmk1'} |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- 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.6/modules/vmware_vmkernel_module.html
