Spec-Zone.ru › Ansible 2.11

cisco.ios.ios_bgp – Настройка глобальных параметров протокола BGP на Cisco IOS.

Примечание

Этот плагин входит в коллекцию cisco.ios (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install cisco.ios

Для использования в playbook, укажите: cisco.ios.ios_bgp

Новое в версии 1.0.0: коллекции cisco.ios

  • Обзор
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

  • Этот модуль обеспечивает управление конфигурацией глобальных параметров BGP на устройствах, работающих под управлением Cisco IOS.

Примечание

Для этого модуля есть соответствующий плагин действий.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
config
словарь
Указывает конфигурацию, связанную с BGP.
address_family
список / элементы=словарь
Указывает конфигурацию, связанную с семейством адресов BGP.
afi
строка / обязательно
    Варианты:
  • ipv4
  • ipv6
Тип семейства адресов для настройки.
auto_summary
булево
    Варианты:
  • нет
  • да
Включить/отключить автоматическое обобщение сетевых номеров.
neighbors
список / элементы=словарь
Указывает конфигурацию, связанную с соседями BGP в режиме конфигурации семейства адресов.
activate
булево
    Варианты:
  • нет
  • да
Включить семейство адресов для этого соседа.
advertisement_interval
целое число
Минимальный интервал между отправкой обновлений маршрутизации BGP для этого соседа.
maximum_prefix
целое число
Максимальное количество префиксов для приема от этого узла.
Диапазон от 1 до 2147483647.
neighbor
строка / обязательно
Адрес маршрутизатора соседа.
next_hop_self
булево
    Варианты:
  • нет
  • да
Включить/отключить вычисление следующего узла для этого соседа.
next_hop_unchanged
булево
    Варианты:
  • нет
  • да
Передавать следующий узел без изменений для iBGP путей к этому соседу.
prefix_list_in
строка
Имя списка префиксов ip для применения к входящим префиксам.
prefix_list_out
строка
Имя списка префиксов ip для применения к исходящим префиксам.
remove_private_as
булево
    Варианты:
  • нет
  • да
Удалить частный номер AS из исходящих обновлений.
route_reflector_client
булево
    Варианты:
  • нет
  • да
Указать соседа как клиента рефлектора маршрутов.
route_server_client
булево
    Варианты:
  • нет
  • да
Указать соседа как клиента сервера маршрутов.
networks
список / элементы=словарь
Указать сети для объявления через BGP.
Для операции замены этот параметр является взаимоисключающим с параметром сетей на уровне корня.
masklen
целое число
Длина маски подсети для объявления сети (например, 8, 16, 24 и т. д.).
prefix
строка / обязательно
Идентификатор сети для объявления через BGP.
route_map
строка
Карта маршрутов для изменения атрибутов.
redistribute
список / элементы=словарь
Указывает информацию о перераспределении из другого протокола маршрутизации.
id
строка
Идентификатор протокола маршрутизации для настройки информации о перераспределении.
Действительно для протоколов 'ospf', 'ospfv3' и 'eigrp'.
metric
целое число
Указывает метрику для перераспределенных маршрутов.
protocol
строка / обязательно
    Варианты:
  • ospf
  • ospfv3
  • eigrp
  • isis
  • статический
  • подключенный
  • odr
  • lisp
  • мобильный
  • rip
Указывает протокол для настройки информации о перераспределении.
route_map
строка
Указывает ссылку на карту маршрутов.
safi
строка
    Варианты:
  • flowspec
  • одноадресная ←
  • многоадресная
  • меченый-одноадресная
Указывает тип адресации для семейства адресов.
synchronization
булево
    Варианты:
  • нет
  • да
Включить/отключить синхронизацию IGP.
bgp_as
целое число / обязательно
Указывает номер автономной системы BGP (AS) для настройки на устройстве.
log_neighbor_changes
булево
    Варианты:
  • нет
  • да
Включить/отключить протоколирование установления/отключения соседей и причины сброса.
neighbors
список / элементы=словарь
Указывает конфигурацию, связанную с соседями BGP.
description
строка
Описание, специфичное для соседа.
ebgp_multihop
целое число
Указывает максимальное число переходов для соседей EBGP, не находящихся на непосредственно подключенных сетях.
Диапазон от 1 до 255.
enabled
булево
    Варианты:
  • нет
  • да
Административно выключить или включить соседа.
local_as
целое число
Местный номер AS для соседа.
neighbor
строка / обязательно
Адрес маршрутизатора соседа.
password
строка
Пароль для аутентификации соединения BGP.
peer_group
строка
Имя группы узлов, членом которой является сосед.
remote_as
целое число / обязательно
Удаленный AS соседа BGP для настройки.
timers
словарь
Указывает конфигурацию таймеров, связанных с соседями BGP.
holdtime
целое число / обязательно
Интервал (в секундах) после того, как не получено сообщение keepalive, что IOS объявляет соседа неактивным.
Диапазон от 0 до 65535.
keepalive
целое число / обязательно
Частота (в секундах), с которой устройство отправляет сообщения keepalive своему партнеру.
Диапазон значений от 0 до 65535.
min_neighbor_holdtime
целое число
Интервал (в секундах), определяющий минимально допустимое время удержания от соседа по BGP.
Минимально допустимое время удержания должно быть меньше или равно интервалу, указанному в аргументе holdtime.
Диапазон значений от 0 до 65535.
update_source
строка
Источник маршрутных обновлений.
networks
список / элементы=словарь
Укажите сети для объявления через BGP.
Для операции замены этот параметр взаимоисключающий с параметром networks в блоке address_family.
Для операции замены, если на устройстве уже активирована семейство адресов, этот параметр недопустим.
masklen
целое число
Длина маски подсети для объявления сети (например, 8, 16, 24 и т. д.).
prefix
строка / обязательно
Идентификатор сети для объявления через BGP.
route_map
строка
Карта маршрутов для изменения атрибутов.
router_id
строка
Настраивает значение router-id процесса маршрутизации BGP.
operation
строка
    Варианты:
  • merge ←
  • replace
  • override
  • delete
Определяет операцию, которая должна быть выполнена над процессом BGP, настроенным на устройстве.
В случае merge, входная конфигурация будет объединена с существующей конфигурацией BGP на устройстве.
В случае replace, если есть разница между существующей и входной конфигурацией, существующая конфигурация будет заменена входной конфигурацией для каждого параметра, у которого есть эта разница.
В случае override, вся существующая конфигурация BGP будет удалена с устройства и заменена входной конфигурацией.
В случае delete существующая конфигурация BGP будет удалена с устройства.

Примечания

Примечание

  • Проверено на Cisco IOS версии 15.6(3)M2

Примеры

- name: configure global bgp as 64496
  cisco.ios.ios_bgp:
    config:
      bgp_as: 64496
      router_id: 192.0.2.1
      log_neighbor_changes: true
      neighbors:
      - neighbor: 203.0.113.5
        remote_as: 64511
        timers:
          keepalive: 300
          holdtime: 360
          min_neighbor_holdtime: 360
      - neighbor: 198.51.100.2
        remote_as: 64498
      networks:
      - prefix: 198.51.100.0
        route_map: RMAP_1
      - prefix: 192.0.2.0
        masklen: 23
      address_family:
      - afi: ipv4
        safi: unicast
        redistribute:
        - protocol: ospf
          id: 223
          metric: 10
    operation: merge

- name: Configure BGP neighbors
  cisco.ios.ios_bgp:
    config:
      bgp_as: 64496
      neighbors:
      - neighbor: 192.0.2.10
        remote_as: 64496
        password: ansible
        description: IBGP_NBR_1
        ebgp_multihop: 100
        timers:
          keepalive: 300
          holdtime: 360
          min_neighbor_holdtime: 360
      - neighbor: 192.0.2.15
        remote_as: 64496
        description: IBGP_NBR_2
        ebgp_multihop: 150
    operation: merge

- name: Configure root-level networks for BGP
  cisco.ios.ios_bgp:
    config:
      bgp_as: 64496
      networks:
      - prefix: 203.0.113.0
        masklen: 27
        route_map: RMAP_1
      - prefix: 203.0.113.32
        masklen: 27
        route_map: RMAP_2
    operation: merge

- name: Configure BGP neighbors under address family mode
  cisco.ios.ios_bgp:
    config:
      bgp_as: 64496
      address_family:
      - afi: ipv4
        safi: unicast
        neighbors:
        - neighbor: 203.0.113.10
          activate: yes
          maximum_prefix: 250
          advertisement_interval: 120
        - neighbor: 192.0.2.15
          activate: yes
          route_reflector_client: true
    operation: merge

- name: remove bgp as 64496 from config
  cisco.ios.ios_bgp:
    config:
      bgp_as: 64496
    operation: delete

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

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

Ключ Возвращаемое значение Описание
commands
список / элементы=строка
всегда
Список команд конфигурации режима, которые необходимо отправить на устройство

Пример:
['router bgp 64496', 'bgp router-id 192.0.2.1', 'bgp log-neighbor-changes', 'neighbor 203.0.113.5 remote-as 64511', 'neighbor 203.0.113.5 timers 300 360 360', 'neighbor 198.51.100.2 remote-as 64498', 'network 198.51.100.0 route-map RMAP_1', 'network 192.0.2.0 mask 255.255.254.0', 'address-family ipv4', 'redistribute ospf 223 metric 70', 'exit-address-family']


Авторы

  • Nilashish Chakraborty (@NilashishC)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cisco/ios/ios_bgp_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API