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

Обзор
Параметры
Примечания
Примеры
Значения возврата
Статус

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
provider словарь			Устарело Начиная с Ansible 2.5 рекомендуется использовать `connection: network_cli`. Этот параметр требуется только при использовании NX-API. Дополнительная информация в руководстве NXOS Platform Options. Объект dict, содержащий данные подключения.
	auth_pass строка добавлено в 2.5.3		Указывает пароль для входа в привилегированный режим на удалённом устройстве. Если authorize равно false, этот параметр игнорируется. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTH_PASS`.
	authorize логическое добавлено в 2.5.3	Варианты: no ← yes	Указывает модулю войти в привилегированный режим на удалённом устройстве перед отправкой команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTHORIZE`.
	host строка / обязательно		Указывает имя хоста DNS или адрес для подключения к удалённому устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
	password строка		Указывает пароль для аутентификации подключения к удалённому устройству. Этот параметр обычно используется для транспортов cli или nxapi. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_PASSWORD`.
	port целое число	Значение по умолчанию: "0 (использовать стандартный порт)"	Указывает порт для подключения к удалённому устройству. Применяется для транспортов cli или nxapi. Если порт не указан в задаче, используется стандартный порт транспорта (cli=22, http=80, https=443).
	ssh_keyfile строка		Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Используется только для транспорта cli. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число	Значение по умолчанию: 10	Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль выдаст ошибку. NX-API может медленно возвращать данные при выполнении длительных команд (sh mac, sh bgp и т. д.).
	transport строка / обязательно	Варианты: cli ← nxapi	Настраивает транспортное соединение для подключения к удалённому устройству. Параметр transport поддерживает подключение к устройству через cli (ssh) или nxapi.
	use_proxy логическое добавлено в 2.5	Варианты: no yes ←	Если `no`, переменные окружения `http_proxy` и `https_proxy` будут проигнорированы.
	use_ssl логическое	Варианты: no ← yes	Настраивает транспорт transport для использования SSL, если установлено значение `yes`, только когда `transport=nxapi`, в противном случае это значение игнорируется.
	username строка		Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_USERNAME`.
	validate_certs логическое	Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых сайтах с самоподписанными сертификатами. Если транспорт не nxapi, это значение игнорируется.
route_distinguisher - / обязательно			Различитель маршрутов VPN (RD). RD объединяется с префиксом IPv4 или IPv6, полученным маршрутизатором PE, для создания уникального глобального адреса.
route_target_both -			Включает/выключает параметры route-target для сообществ import и export 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 – строка в одном из форматов route-distinguisher, ключевое слово ‘auto’ или ключевое слово ‘default’.
Дополнительную информацию по использованию CLI и 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 list	всегда	Команды, отправленные на устройство Пример: ['evpn', 'vni 6000 l2', 'route-target import 5001:10']

Статус

Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
Данный модуль поддерживается командой Ansible Network Team. [сеть]

Поддержка Red Hat

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

Авторы

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