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

Новая в версии 2.2.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
- Поддержка
- Автор

Обзор

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

Параметры

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

Примеры

- name: vni configuration
  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']

Статус

Этот модуль помечен как предварительный, что означает, что его интерфейс не гарантирует обратную совместимость.

Поддержка

Дополнительную информацию о поддержке этого модуля Red Hat см. в этой статье базы знаний Knowledge Base article

Автор

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