community.vmware.vmware_vspan_session – Создание или удаление сессии зеркалирования портов.
Примечание
Этот плагин входит в коллекцию community.vmware (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install community.vmware.
Для использования в плейбуке укажите: community.vmware.vmware_vspan_session.
Обзор
- Этот модуль можно использовать для создания, удаления или изменения различных сессий зеркалирования портов.
Требования
Ниже перечислены требования, которые должны быть выполнены на хосте, выполняющем этот модуль.
- python > = 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| description строка | Описание сессии. | ||
| destination_port строка | Порт назначения, получивший зеркальные пакеты. Также любой порт, указанный в этом свойстве, не может совпадать с портом источника в любой сессии распределенного зеркалирования портов. | ||
| destination_vm словарь | С помощью этого параметра можно добавить сетевую карту виртуальной машины в сессию зеркалирования портов. | ||
| name строка | Имя виртуальной машины. | ||
| nic_label строка | Имя сетевой карты для использования. | ||
| enabled булево |
| Включена ли сессия. | |
| encapsulation_vlan_id целое число | Идентификатор VLAN для инкапсуляции зеркального трафика. | ||
| hostname строка | Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_HOST.Поддержка переменных окружения добавлена в Ansible 2.6. | ||
| mirrored_packet_length целое число | Целое число, описывающее, сколько байт каждого кадра нужно зеркалить. Если не задано, будет зеркален весь кадр. Указание меньшего значения полезно, когда потребитель будет анализировать только заголовки. Значение не может быть меньше 60. | ||
| name строка / обязательно | Имя сессии. | ||
| normal_traffic_allowed булево |
| Разрешено ли отправление и получение «обычного» трафика портами назначения. Установка в значение false сделает порты зеркалирования используемыми только для зеркалирования, а не в качестве обычных портов доступа. | |
| password строка | Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD.Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd | ||
| port целое число | По умолчанию: 443 | Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PORT.Поддержка переменных окружения добавлена в Ansible 2.6. | |
| proxy_host строка | Адрес прокси-сервера, который будет получать все запросы HTTPS и пересылать их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PROXY_HOST.Эта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12 | ||
| proxy_port целое число | Порт HTTP-прокси, который будет получать все запросы HTTPS и пересылать их. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PROXY_PORT. | ||
| sampling_rate целое число | Частота выборки сессии. Если значение равно n, один из каждых n пакетов будет зеркален. Допустимые значения от 1 до 65535. | ||
| session_type строка |
| Выбор типа зеркалирования. В сессии encapsulatedRemoteMirrorSource, распределенные порты могут использоваться в качестве источников, а IP-адреса — в качестве пунктов назначения.В сессии remoteMirrorDest, идентификаторы VLAN могут использоваться в качестве источников, а распределенные порты — в качестве пунктов назначения.В сессии remoteMirrorSource, распределенные порты могут использоваться в качестве источников, а имена портов uplink — в качестве пунктов назначения.В сессии dvPortMirror, распределенные порты могут использоваться как в качестве источников, так и в качестве пунктов назначения. | |
| source_port_received строка | Порт источника, для которого принимаемые пакеты зеркалируются. | ||
| source_port_transmitted строка | Порт источника, для которого передаваемые пакеты зеркалируются. | ||
| source_vm_received словарь | С помощью этого параметра можно добавить сетевую карту виртуальной машины в сессию зеркалирования портов. | ||
| name строка | Имя виртуальной машины. | ||
| nic_label строка | Имя сетевой карты для использования. | ||
| source_vm_transmitted словарь | С помощью этого параметра можно добавить сетевую карту виртуальной машины в сессию зеркалирования портов. | ||
| name строка | Имя виртуальной машины. | ||
| nic_label строка | Имя сетевой карты для использования. | ||
| state строка / обязательно |
| Создать или удалить сессию. | |
| strip_original_vlan булево |
| Удалить оригинальный тег VLAN. Если false, оригинальный тег VLAN будет сохранен в зеркальном трафике. Если encapsulationVlanId установлено, а это свойство — false, кадры будут двойным образом помечены оригинальным идентификатором VLAN как внутренним тегом. | |
| switch строка / обязательно | Имя распределенного коммутатора vSwitch, на котором добавить или удалить сессию зеркалирования. псевдонимы: switch_name | ||
| username строка | Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER.Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user | ||
| validate_certs булево |
| Разрешает подключение, когда сертификаты SSL недействительны. Установите в false при недоверии к сертификатам.Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_VALIDATE_CERTS.Поддержка переменных окружения добавлена в Ansible 2.6. Если установлено в true, убедитесь, что на данном компьютере установлен Python >= 2.7.9. | |
Примечания
Примечание
- Тестировано на vSphere 6.7
Примеры
- name: Create distributed mirroring session.
community.vmware.vmware_vspan_session:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
switch_name: dvSwitch
state: present
name: Basic Session
enabled: True
description: "Example description"
source_port_transmitted: 817
source_port_received: 817
destination_port: 815
delegate_to: localhost
- name: Create remote destination mirroring session.
community.vmware.vmware_vspan_session:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
switch_name: dvSwitch
state: present
name: Remote Session
enabled: True
description: "Example description"
source_port_received: 105
destination_port: 815
session_type: "remoteMirrorDest"
delegate_to: localhost
- name: Create remote destination mirroring session.
community.vmware.vmware_vspan_session:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
switch_name: dvSwitch
state: absent
name: Remote Session
delegate_to: localhost
Авторы
- Peter Gyorgy (@gyorgypeter)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/vmware/vmware_vspan_session_module.html
