nxos_bgp — Управляет конфигурацией BGP.
Новая версия 2.2.
Описание
- Управляет конфигурациями BGP на коммутаторах NX-OS.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| asn обязательно | Номер автономной системы BGP. Допустимые значения — строка, целое число в ASPLAIN или ASDOT формате. | ||
| bestpath_always_compare_med bool |
| Включить/выключить сравнение MED для путей из разных автономных систем. | |
| bestpath_aspath_multipath_relax bool |
| Включить/выключить распределение нагрузки между поставщиками с разными (но одинаковой длины) AS путями. | |
| bestpath_compare_neighborid bool |
| Включить/выключить neighborid. Используйте, когда доступно больше путей, чем максимальная конфигурация путей. | |
| bestpath_compare_routerid bool |
| Включить/выключить сравнение идентификаторов маршрутизаторов для идентичных путей eBGP. | |
| bestpath_cost_community_ignore bool |
| Включить/выключить игнорирование сообщества стоимости для расчёта лучшего пути BGP. | |
| bestpath_med_confed bool |
| Включить/выключить применение bestpath для сравнения MED только между путями, исходящими из одной конфедерации. | |
| bestpath_med_missing_as_worst bool |
| Включить/выключить присвоение бесконечного значения полученным маршрутам, не содержащим атрибут MED, что делает эти маршруты наименее предпочтительными. | |
| bestpath_med_non_deterministic bool |
| Включить/выключить детерминированный выбор лучшего пути MED среди путей из одной автономной системы. | |
| cluster_id | Идентификатор кластера отражателя маршрутов. | ||
| confederation_id | Конфедерация домена маршрутизации AS. | ||
| confederation_peers | Параметры конфедерации AS. | ||
| disable_policy_batching bool |
| Включить/выключить пакетную оценку объявлений префиксов всем узлам. | |
| disable_policy_batching_ipv4_prefix_list | Включить/выключить пакетную оценку объявлений префиксов всем узлам с списком префиксов. | ||
| disable_policy_batching_ipv6_prefix_list | Включить/выключить пакетную оценку объявлений префиксов всем узлам с списком префиксов. | ||
| enforce_first_as bool |
| Включить/выключить принудительное использование автономной системы узла в качестве первого номера AS, указанного в атрибуте AS пути для eBGP. В NX-OS этот параметр поддерживается только в глобальном контексте BGP. | |
| event_history_cli |
| Включить/выключить буфер истории событий CLI. | |
| event_history_detail |
| Включить/выключить буфер детальной истории событий. | |
| event_history_events |
| Включить/выключить буфер истории событий. | |
| event_history_periodic |
| Включить/выключить буфер периодической истории событий. | |
| fast_external_fallover bool |
| Включить/выключить немедленное сброс сессии, если соединение с напрямую подключённым узлом BGP обрывается. Поддерживается только в глобальном контексте BGP. | |
| flush_routes bool |
| Включить/выключить очистку маршрутов в RIB при контролируемой перезагрузке. В NX-OS этот параметр поддерживается только в глобальном контексте BGP. | |
| graceful_restart bool |
| Включить/выключить плавную перезагрузку. | |
| graceful_restart_helper bool |
| Включить/выключить помощник плавной перезагрузки. | |
| graceful_restart_timers_restart | Установить максимальное время для отправки команды перезагрузки узлу BGP. | ||
| graceful_restart_timers_stalepath_time | Установить максимальное время, в течение которого BGP сохраняет устаревшие маршруты от перезагружаемого узла BGP. | ||
| isolate bool |
| Включить/выключить изоляцию данного маршрутизатора с точки зрения BGP. | |
| local_as | Локальный номер AS, используемый внутри экземпляра VRF. | ||
| log_neighbor_changes bool |
| Включить/выключить протоколирование сообщений о событиях подключения/отключения узлов. | |
| maxas_limit | Указать максимальное количество номеров AS, разрешённых в атрибуте AS-пути. Допустимые значения от 1 до 512. | ||
| neighbor_down_fib_accelerate bool |
| Включить/выключить обработку событий отключения узла BGP по различным причинам. | |
| provider | Устарело Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli. Этот параметр требуется только при использовании NX-API. Для получения дополнительной информации см. руководство NXOS Platform Options. Объект словаря, содержащий данные подключения. | ||
| host обязательно | Указывает имя хоста DNS или адрес для подключения к удалённому устройству по указанному транспорту. Значение параметра host используется в качестве адреса назначения для транспорта. | ||
| port | Значение по умолчанию: "0 (использовать общий порт)" | Указывает порт для использования при подключении к удалённому устройству. Это значение применяется как к cli, так и к nxapi. Значение порта будет установлено по умолчанию на соответствующий транспортный общий порт, если не указано иное в задаче. (cli=22, http=80, https=443). | |
| username | Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задаче, будет использовано значение переменной окружения ANSIBLE_NET_USERNAME. | ||
| password | Указывает пароль для аутентификации подключения к удалённому устройству. Это общий аргумент, используемый для cli или nxapi транспортов. Если значение не указано в задаче, будет использовано значение переменной окружения ANSIBLE_NET_PASSWORD. | ||
| authorize bool (добавлено в 2.5.3) |
| Инструктирует модуль войти в привилегированный режим на удалённом устройстве перед отправкой каких-либо команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, будет использовано значение переменной окружения ANSIBLE_NET_AUTHORIZE. | |
| auth_pass (добавлено в 2.5.3) | Значение по умолчанию: "нет" | Указывает пароль для входа в привилегированный режим на удалённом устройстве, если это требуется. Если authorize ложно, этот аргумент ничего не делает. Если значение не указано в задаче, будет использовано значение переменной окружения ANSIBLE_NET_AUTH_PASS. | |
| timeout (добавлено в 2.3) | Значение по умолчанию: 10 | Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль выдаст ошибку. NX-API может медленно возвращать результаты при выполнении длительных команд (sh mac, sh bgp и т. д.). | |
| ssh_keyfile | Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_SSH_KEYFILE. | ||
| transport required | Значение по умолчанию: "cli" | Настраивает транспортное соединение для подключения к удалённому устройству. Аргумент transport поддерживает подключение к устройству по cli (ssh) или nxapi. | |
| use_ssl bool |
| Настраивает транспорт transport на использование SSL, если значение установлено в true, только когда transport=nxapi, в противном случае это значение игнорируется. | |
| validate_certs bool |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, которые используют самозаверяющие сертификаты. Если аргумент transport не nxapi, это значение игнорируется. | |
| use_proxy bool (added in 2.5) |
| Если no, переменные среды http_proxy и https_proxy будут проигнорированы. | |
| reconnect_interval | Интервал повторного подключения BGP для прерванных сессий. Допустимые значения от 1 до 60. | ||
| router_id | Идентификатор маршрутизатора (ID) экземпляра VRF маршрутизатора BGP. | ||
| shutdown bool |
| Административно остановить протокол BGP. | |
| state |
| Определяет, должен ли конфигурация быть присутствующей на устройстве или нет. | |
| suppress_fib_pending bool |
| Включить/выключить рекламу только маршрутов, запрограммированных в оборудовании, для узлов. | |
| timer_bestpath_limit | Указывает тайм-аут для первого лучшего пути после перезапуска в секундах. | ||
| timer_bgp_hold | Установить таймер удержания BGP. | ||
| timer_bgp_keepalive | Установить таймер keepalive BGP. | ||
| vrf | Имя VRF. Имя 'default' является допустимым VRF, представляющим глобальный BGP. | ||
Примечания
Примечание
- Тестировалось на NXOSv 7.3.(0)D1(1) на VIRL
-
state=absentудаляет всю конфигурацию ASN BGP при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'] |
Статус
Данный модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.
Обслуживание
Данный модуль помечен как сетевой, что означает, что он обслуживается командой Ansible Network. См. Модули технической поддержки для получения дополнительной информации.
Список других модулей, также поддерживаемых командой Ansible Network, см. в документе.
Поддержка
Дополнительную информацию о поддержке 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.6/modules/nxos_bgp_module.html
