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

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

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

Краткое описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
asn обязательно			Номер автономной системы BGP. Допустимые значения: Строка, Целое число в обозначениях ASPLAIN или ASDOT.
bestpath_always_compare_med		Варианты: true false Значение по умолчанию: Нет	Включить/выключить сравнение MED на путях из разных автономных систем.
bestpath_aspath_multipath_relax		Варианты: true false Значение по умолчанию: Нет	Включить/выключить распределение нагрузки между поставщиками с различными (но одинаковой длины) AS-путями.
bestpath_compare_neighborid		Варианты: true false	Включить/выключить neighborid. Используйте, когда доступно больше путей, чем задано в конфигурации.
bestpath_compare_routerid		Варианты: true false Значение по умолчанию: Нет	Включить/выключить сравнение идентификаторов маршрутизаторов для идентичных путей eBGP.
bestpath_cost_community_ignore		Варианты: true false Значение по умолчанию: Нет	Включить/выключить игнорирование сообщества стоимости для расчёта лучшего пути BGP.
bestpath_med_confed		Варианты: true false Значение по умолчанию: Нет	Включить/выключить применение bestpath для сравнения MED только между путями, исходящими из одной конфедерации.
bestpath_med_missing_as_worst		Варианты: true false Значение по умолчанию: Нет	Включить/выключить присваивание значения бесконечности маршрутам, не содержащим атрибут MED, что делает их наименее предпочтительными.
bestpath_med_non_deterministic		Варианты: true false Значение по умолчанию: Нет	Включить/выключить детерминированный выбор лучшего пути MED среди путей из той же автономной системы.
cluster_id		Значение по умолчанию: Нет	Идентификатор кластера рефлектора маршрутов.
confederation_id		Значение по умолчанию: Нет	Конфедерация домена маршрутизации AS.
confederation_peers		Значение по умолчанию: Нет	Параметры конфедерации AS.
disable_policy_batching		Варианты: true false Значение по умолчанию: Нет	Включить/выключить пакетную оценку объявления префиксов всем peer'ам.
disable_policy_batching_ipv4_prefix_list		Значение по умолчанию: Нет	Включить/выключить пакетную оценку объявлений префиксов всем peer'ам с списком префиксов.
disable_policy_batching_ipv6_prefix_list			Включить/выключить пакетную оценку объявлений префиксов всем peer'ам с списком префиксов.
enforce_first_as		Варианты: true false Значение по умолчанию: Нет	Включить/выключить принуждение к тому, чтобы автономная система соседа была первым номером AS, указанным в атрибуте AS-path для eBGP. В NX-OS эта опция поддерживается только в глобальном контексте BGP.
event_history_cli		Варианты: size_small size_medium size_large size_disable default Значение по умолчанию: Нет	Включить/выключить буфер истории событий CLI.
event_history_detail		Варианты: size_small size_medium size_large size_disable default Значение по умолчанию: Нет	Включить/выключить буфер подробной истории событий.
event_history_events		Варианты: size_small size_medium size_large size_disable default Значение по умолчанию: Нет	Включить/выключить буфер истории событий.
event_history_periodic		Варианты: size_small size_medium size_large size_disable default	Включить/выключить буфер периодической истории событий.
fast_external_fallover		Варианты: true false Значение по умолчанию: Нет	Включить/выключить мгновенную перезагрузку сессии, если соединение с напрямую подключенным BGP peer'ом прервано. Поддерживается только в глобальном контексте BGP.
flush_routes		Варианты: true false Значение по умолчанию: Нет	Включить/выключить сброс маршрутов в RIB при контролируемой перезагрузке. В NX-OS эта опция поддерживается только в глобальном контексте BGP.
graceful_restart		Варианты: true false Значение по умолчанию: Нет	Включить/выключить плавный перезапуск.
graceful_restart_helper		Варианты: true false Значение по умолчанию: Нет	Включить/выключить помощник плавного перезапуска.
graceful_restart_timers_restart		Значение по умолчанию: Нет	Установить максимальное время для отправки сообщения о перезапуске BGP peer'у.
graceful_restart_timers_stalepath_time		Значение по умолчанию: Нет	Установить максимальное время, в течение которого BGP хранит устаревшие маршруты от перезапускающегося BGP peer'а.
isolate		Варианты: true false Значение по умолчанию: Нет	Включить/выключить изоляцию этого маршрутизатора с точки зрения BGP.
local_as		Значение по умолчанию: Нет	Локальный номер AS, используемый внутри экземпляра VRF.
log_neighbor_changes		Варианты: true false Значение по умолчанию: Нет	Включить/выключить ведение журнала сообщений для событий "сосед вверх/вниз".
maxas_limit		Значение по умолчанию: Нет	Указать максимальное количество номеров AS, разрешенных в атрибуте AS-path. Допустимые значения от 1 до 512.
neighbor_down_fib_accelerate		Варианты: true false Значение по умолчанию: Нет	Включить/выключить обработку события "сосед BGP вниз" по разным причинам.
provider		Значение по умолчанию: Нет	Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Эта опция требуется только при использовании NX-API. Для получения дополнительной информации см. руководство NXOS Platform Options. Объект словаря, содержащий данные соединения.
	username		Настройка имени пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi, в зависимости от используемого транспорта. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_USERNAME`.
	authorize (добавлено в 2.5.3)	Варианты: нет ← да	Инструктирует модуль войти в привилегированный режим на удалённом устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTHORIZE`.
	ssh_keyfile		Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	use_proxy (добавлено в 2.5)	Варианты: да ← нет	Если `no`, переменные окружения `http_proxy` и `https_proxy` будут проигнорированы.
	auth_pass (добавлено в 2.5.3)	Значение по умолчанию: нет	Указывает пароль для входа в привилегированный режим на удалённом устройстве, если требуется. Если authorize равен false, этот аргумент ничего не делает. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTH_PASS`.
	host обязательно		Указывает имя хоста DNS или адрес для подключения к удалённому устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.

	timeout (added in 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 не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяющих сертификатов. Если аргумент транспорта не nxapi, это значение игнорируется.
	port	По умолчанию: 0 (используется стандартный порт)	Указывает порт для подключения к удалённому устройству. Это значение применимо для cli или nxapi. Значение порта по умолчанию будет соответствовать стандартному порту для выбранного транспорта, если в задаче не указано другое значение. (cli=22, http=80, https=443).
	transport обязательно	По умолчанию: cli	Настраивает транспортное соединение для подключения к удалённому устройству. Аргумент transport поддерживает подключение к устройству по cli (ssh) или nxapi.
reconnect_interval		По умолчанию: None	Интервал повторного подключения BGP для разорванных сессий. Допустимые значения находятся в диапазоне от 1 до 60.
router_id		По умолчанию: None	Идентификатор маршрутизатора (ID) экземпляра VRF маршрутизатора BGP.
shutdown		Варианты: true false По умолчанию: None	Административное отключение протокола BGP.
state		Варианты: present ← absent	Определяет, должен ли конфиг присутствовать на устройстве или нет.
suppress_fib_pending		Варианты: true false По умолчанию: None	Включить/выключить рекламу только маршрутов, запрограммированных в аппаратуре, для пэров.
timer_bestpath_limit		По умолчанию: None	Укажите таймаут для первого лучшего пути после перезапуска в секундах.
timer_bgp_hold		По умолчанию: None	Установить таймер удержания BGP.
timer_bgp_keepalive		По умолчанию: None	Установить таймер ожидания BGP.
vrf		По умолчанию: None	Имя VRF. Имя «default» — это допустимый VRF, представляющий глобальный BGP.

Примечания

Примечание

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

Примеры

- name: Configure a simple ASN
  nxos_bgp:
      asn: 65535
      vrf: test
      router_id: 1.1.1.1
      state: present

Значения возврата

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

Ключ	Возвращаемое значение	Описание
commands список	всегда	Команды, отправленные устройству Пример: ['router bgp 65535', 'vrf test', 'router-id 1.1.1.1']

Статус

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

Поддержка

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

Автор

Jason Edelman (@jedelman8)
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_bgp_module.html