cisco.nxos.nxos_evpn_vni – Управляет идентификатором сети Cisco EVPN VXLAN (VNI).

Примечание

Этот плагин входит в состав коллекции cisco.nxos (версия 1.3.1).

Для его установки используйте: ansible-galaxy collection install cisco.nxos.

Чтобы использовать его в книге задач, укажите: cisco.nxos.nxos_evpn_vni.

Новое в версии 1.0.0: из cisco.nxos

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

Обзор

Управляет конфигурацией идентификатора сети VXLAN (VNI) Cisco Ethernet Virtual Private Network (EVPN) на устройстве Nexus.

Примечание

У этого модуля есть соответствующий плагин действий.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
provider словарь			Устаревший Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Начиная с Ansible 2.6, для NX-API рекомендуется использовать `connection: httpapi`. Этот параметр будет удален в релизе после 2022-06-01. Дополнительную информацию можно найти в руководстве NXOS Platform Options. Объект словаря, содержащий сведения о соединении.
	auth_pass строка		Указывает пароль для входа в привилегированный режим на удаленном устройстве, если это необходимо. Если authorize имеет значение false, то этот аргумент ничего не делает. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTH_PASS`.
	authorize булево	Варианты: нет ← да	Инструктирует модуль войти в привилегированный режим на удаленном устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTHORIZE`.
	host строка		Указывает имя хоста DNS или адрес для подключения к удаленному устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
	password строка		Указывает пароль для аутентификации подключения к удаленному устройству. Это общий аргумент, используемый для транспортов cli или nxapi. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_PASSWORD`.
	port целое число		Указывает порт для подключения к удаленному устройству. Это значение применяется к транспорту cli или nxapi. Если значение порта не указано в задаче, по умолчанию используется соответствующий общий порт транспорта (cli=22, http=80, https=443).
	ssh_keyfile строка		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число		Указывает тайм-аут в секундах для связи с сетевым устройством при подключении или отправке команд. Если тайм-аут истекает до завершения операции, модуль выдаст ошибку. NX-API может медленно возвращать результаты при выполнении длительных команд (sh mac, sh bgp и т. д.).
	transport строка	Варианты: cli ← nxapi	Настраивает транспортное подключение для соединения с удаленным устройством. Аргумент transport поддерживает подключение к устройству через cli (ssh) или nxapi.
	use_proxy булево	Варианты: нет да ←	Если `no`, переменные окружения `http_proxy` и `https_proxy` будут проигнорированы.
	use_ssl булево	Варианты: нет ← да	Настраивает transport для использования SSL, если значение равно `yes`, только когда `transport=nxapi`, в противном случае это значение игнорируется.
	username строка		Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_USERNAME`.
	validate_certs булево	Варианты: нет ← да	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на управляемых вами сайтах с самозаверяющими сертификатами. Если аргумент transport не является nxapi, это значение игнорируется.
route_distinguisher строка			Разделитель маршрутов VPN (RD). RD объединяется с префиксом IPv4 или IPv6, полученным маршрутизатором PE, для создания уникального адреса во всем мире.
route_target_both список / элементы=строка			Включает/выключает параметры route-target для импорта и экспорта сообществ с использованием одного свойства.
route_target_export список / элементы=строка			Устанавливает расширенные сообщества route-target 'export'.
route_target_import список / элементы=строка			Устанавливает расширенные сообщества route-target 'import'.
state строка		Варианты: present ← absent	Определяет, должно ли быть конфигурационное свойство присутствующим на устройстве.
vni строка / требуется			Идентификатор сети EVPN VXLAN.

Примечания

Примечание

Тестировалось на NXOSv 7.3.(0)D1(1) на VIRL
По умолчанию, где это поддерживается, восстанавливает значения параметров по умолчанию.
Переопределение RD не разрешено. Сначала необходимо установить значения по умолчанию, а затем перенастроить.
Значения route_target_both, route_target_import и route_target_export valid представляют собой список расширенных сообществ (например, [‘1.2.3.4:5’, ‘33:55’]) или ключевые слова ‘auto’ или ‘default’.
Свойство route_target_both не рекомендуется из-за несогласованного поведения свойства на разных платформах Nexus и версиях изображений. По этой причине рекомендуется использовать явные свойства route_target_export и route_target_import вместо route_target_both.
Допустимые значения RD — это строка в одном из форматов разделителей маршрутов, ключевое слово ‘auto’ или ключевое слово ‘default’.
Дополнительную информацию о использовании CLI и NX-API см. в руководстве NXOS Platform Options
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide
Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на странице интеграции Cisco Cisco integration page.

Примеры

- name: vni configuration
  cisco.nxos.nxos_evpn_vni:
    vni: 6000
    route_distinguisher: 60:10
    route_target_import:
    - 5000:10
    - 4100:100
    route_target_export: auto
    route_target_both: default

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

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

Ключ	Возвращаемое значение	Описание
commands список / элементы=строка	всегда	Команды, отправленные на устройство Пример: ['evpn', 'vni 6000 l2', 'route-target import 5001:10']

Авторы

Gabriele Gerbino (@GGabriele)

© 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/cisco/nxos/nxos_evpn_vni_module.html