nxos_bgp_af - Управляет конфигурацией семейств адресов BGP.

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

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

Описание

Управляет конфигурациями семейств адресов BGP на коммутаторах NX-OS.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
additional_paths_install bool		Варианты: no yes	Устанавливает резервный путь в таблицу переадресации и обеспечивает независимую от префикса конвергенцию (PIC) в случае отказа канала PE-CE.
additional_paths_receive bool		Варианты: no yes	Включает возможность приема дополнительных путей для всех соседей в рамках данной адресной семьи, для которых эта возможность не отключена.
additional_paths_selection			Настраивает возможность выбора дополнительных путей для префикса. Допустимые значения — строка, определяющая имя карты маршрутизации.
additional_paths_send bool		Варианты: no yes	Включает возможность отправки дополнительных путей для всех соседей в рамках данной адресной семьи, для которых эта возможность не отключена.
advertise_l2vpn_evpn bool		Варианты: no yes	Рекламировать маршруты evpn.
afi обязательно		Варианты: ipv4 ipv6 vpnv4 vpnv6 l2vpn	Идентификатор адресной семьи.
asn обязательно			Номер автономной системы BGP. Допустимые значения — строка, целое число в ASPLAIN или ASDOT формате.
client_to_client bool		Варианты: no yes	Настроить отражение маршрутов клиент-клиент.
dampen_igp_metric			Указать значение гашения для изменений метрики IGP в секундах. Допустимые значения — целое число и ключевое слово 'default'.
dampening_half_time			Указать время полураспада для гашения перепадов маршрута в минутах. Допустимые значения — целое число и ключевое слово 'default'.
dampening_max_suppress_time			Указать максимальное время подавления для стабильного маршрута при гашении перепадов маршрута. Допустимые значения — целое число и ключевое слово 'default'.
dampening_reuse_time			Указать время повторного использования маршрута для гашения перепадов маршрута. Допустимые значения — целое число и ключевое слово 'default'.
dampening_routemap			Указать карту маршрутизации для гашения перепадов маршрута. Допустимые значения — строка, определяющая имя карты маршрутизации.
dampening_state bool		Варианты: no yes	Включить/выключить гашение перепадов маршрута.
dampening_suppress_time			Указать время подавления маршрута для гашения перепадов маршрута. Допустимые значения — целое число и ключевое слово 'default'.
default_information_originate bool		Варианты: no yes	Происхождение информации по умолчанию.
default_metric			Устанавливает значения метрик по умолчанию для маршрутов, перераспределяемых в BGP. Допустимые значения — целое число или ключевое слово 'default'.
distance_ebgp			Устанавливает административную дистанцию для маршрутов eBGP. Допустимые значения — целое число или ключевое слово 'default'.
distance_ibgp			Устанавливает административную дистанцию для маршрутов iBGP. Допустимые значения — целое число или ключевое слово 'default'.
distance_local			Устанавливает административную дистанцию для локальных маршрутов BGP. Допустимые значения — целое число или ключевое слово 'default'.
inject_map			Массив имен карт маршрутизации, которые определяют префиксы для вставки. Каждый элемент массива должен содержать имя карты вставки, имя карты существования и, необязательно, ключевое слово copy-attributes, указывающее, что атрибуты должны быть скопированы из агрегата. Например, [['lax_inject_map', 'lax_exist_map'], ['nyc_inject_map', 'nyc_exist_map', 'copy-attributes'], ['fsd_inject_map', 'fsd_exist_map']].
maximum_paths			Настраивает максимальное количество путей с одинаковой стоимостью для расщепления нагрузки. Допустимое значение — целое число в диапазоне от 1 до 64.
maximum_paths_ibgp			Настраивает максимальное количество путей ibgp с одинаковой стоимостью для расщепления нагрузки. Допустимое значение — целое число в диапазоне от 1 до 64.
networks			Маршруты для настройки. Допустимое значение — список префиксов сетевых адресов для рекламы. Список должен быть в формате массива. Каждый элемент массива должен содержать адрес префикса и необязательную карту маршрутизации. Например, [['10.0.0.0/16', 'routemap_LA'], ['192.168.1.1', 'Chicago'], ['192.168.2.0/24'], ['192.168.3.0/24', 'routemap_NYC']].
next_hop_route_map			Настроить карту маршрутизации для допустимых следующих узлов. Допустимые значения — строка, определяющая имя карты маршрутизации.
provider			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Этот параметр необходим только при использовании NX-API. Дополнительную информацию можно найти в руководстве NXOS Platform Options. Объект типа dict, содержащий данные соединения.
	host обязательно		Указывает имя или адрес DNS хоста для подключения к удаленному устройству по указанному транспорту. Значение host используется в качестве адреса назначения для транспорта.
	port	По умолчанию: "0 (использовать общий порт)"	Указывает порт, который следует использовать при построении соединения с удаленным устройством. Это значение применимо как к cli, так и к nxapi. Значение порта будет по умолчанию соответствовать общему порту транспорта, если в задаче не указано иное. (cli=22, http=80, https=443).
	username		Настраивает имя пользователя для аутентификации соединения с удаленным устройством. Это значение используется для аутентификации входа по командной строке или аутентификации nxapi, в зависимости от используемого транспорта. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_USERNAME`.
	password		Указывает пароль для аутентификации соединения с удаленным устройством. Это общий параметр, используемый для транспортов cli или nxapi. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_PASSWORD`.
	authorize bool (добавлено в 2.5.3)	Варианты: no ← yes	Указывает модулю войти в привилегированный режим на удаленном устройстве перед отправкой каких-либо команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_AUTHORIZE`.
	auth_pass (добавлено в 2.5.3)	По умолчанию: "none"	Указывает пароль, если необходимо войти в привилегированный режим на удаленном устройстве. Если authorize ложно, этот аргумент ничего не делает. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	timeout (добавлено в 2.3)	По умолчанию: 10	Устанавливает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут превышен до завершения операции, модуль выдаст ошибку. NX-API может работать медленно при выполнении длительных команд (sh mac, sh bgp и т. д.).
	ssh_keyfile		Указывает SSH-ключ для аутентификации соединения с удаленным устройством. Этот аргумент используется только для транспорта cli. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	transport обязательно	По умолчанию: "cli"	Настраивает транспортное соединение для подключения к удаленному устройству. Параметр transport поддерживает подключение к устройству по командной строке (ssh) или nxapi.
	use_ssl bool	Варианты: no ← yes	Настраивает транспорт transport для использования SSL, если значение true, только когда `transport=nxapi`, в противном случае это значение игнорируется.
	validate_certs bool	Варианты: no yes	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах с самоподписанными сертификатами. Если параметр transport не является nxapi, это значение игнорируется.

END_OF_DOCUMENT_MARKER

	use_proxy bool (added in 2.5)	Choices: no yes ←	If `no`, the environment variables `http_proxy` and `https_proxy` will be ignored.
redistribute			A list of redistribute directives. Multiple redistribute entries are allowed. The list must be in the form of a nested array. the first entry of each array defines the source-protocol to redistribute from; the second entry defines a route-map name. A route-map is highly advised but may be optional on some platforms, in which case it may be omitted from the array list. For example [['direct', 'rm_direct'], ['lisp', 'rm_lisp']].
safi required		Choices: unicast multicast evpn	Sub Address Family Identifier.
state		Choices: present ← absent	Определяет, должно ли конфигурация присутствовать на устройстве или нет.
suppress_inactive bool		Choices: no yes	Рекламирует только активные маршруты для peer.
table_map			Применяет table-map для фильтрации маршрутов, загружаемых в URIB. Допустимые значения — строка.
table_map_filter bool		Choices: no yes	Фильтрует маршруты, отклоненные маршрутизацией, и не загружает их в RIB.
vrf required			Имя VRF. Имя 'default' — допустимое VRF, представляющее глобальный bgp.

Примечания

Примечание

Тестировалось на NXOSv 7.3.(0)D1(1) на VIRL
state=absent удаляет всю конфигурацию ASN BGP
По умолчанию, где поддерживается, восстанавливает значения параметров по умолчанию.
Для получения информации об использовании CLI и NX-API см. руководство NXOS Platform Options
Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами см. руководство Ansible Network Guide
Для получения дополнительной информации об использовании Ansible для управления устройствами Cisco см. страницу интеграции Cisco Cisco integration page.

Примеры

# configure a simple address-family
- nxos_bgp_af:
    asn: 65535
    vrf: TESTING
    afi: ipv4
    safi: unicast
    advertise_l2vpn_evpn: true
    state: present

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

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

Ключ	Возвращаемое значение	Описание
commands list	всегда	Команды, отправленные устройству Пример: ['router bgp 65535', 'vrf TESTING', 'address-family ipv4 unicast', 'advertise l2vpn evpn']

Статус

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

Техническое обслуживание

Этот модуль помечен как сетевой, что означает, что он поддерживается командой Ansible Network. См. Обслуживание и поддержка модулей для получения дополнительной информации.

Список других модулей, поддерживаемых командой Ansible Network Team, см. здесь.

Поддержка

Дополнительную информацию о поддержке этого модуля 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.6/modules/nxos_bgp_af_module.html