dellemc.enterprise_sonic.sonic_ospfv2 модуль – Настройка глобальных параметров протокола OSPFv2 на SONiC.

Примечание

Этот модуль входит в коллекцию dellemc.enterprise_sonic (версия 2.5.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

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

Для использования в плейбуке укажите: dellemc.enterprise_sonic.sonic_ospfv2.

Впервые в dellemc.enterprise_sonic 2.5.0

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

Обзор

Этот модуль обеспечивает управление конфигурацией глобальных параметров OSPFv2 на устройствах, работающих под управлением SONiC.
Настройте экземпляр VRF перед настройкой OSPF в VRF.

Параметры

Параметр	Комментарии
config list / elements=dictionary	Указывает конфигурацию, связанную с OSPFv2. non_passive_interfaces и passive_interfaces являются взаимоисключающими. Когда default_passive=True, passive_interfaces не может быть сконфигурирован. Когда default_passive=False, non_passive_interfaces не может быть сконфигурирован.
abr_type string	Настроить тип ABR маршрутизатора. `cisco` - Тип ABR по реализации Cisco. `ibm` - Тип ABR по реализации IBM. `shortcut` - Сокращенный ABR. `standard` - ABR со стандартной реализацией RFC2328. Варианты: `"cisco"` `"ibm"` `"shortcut"` `"standard"`
auto_cost_reference_bandwidth integer	Настроить эталонную пропускную способность автоматической стоимости интерфейса (от 1 до 4294967).
default_metric integer	Настроить метрику для перераспределяемых маршрутов (от 0 до 16777214).
default_passive boolean	Подавляет обновления маршрутизации OSPFv2 на всех интерфейсах. Варианты: `false` `true`
distance dictionary	Настроить административное расстояние маршрута.
all integer	Значение расстояния для всех типов маршрутов (от 1 до 255).
external integer	Значение расстояния для внешних маршрутов (от 1 до 255).
inter_area integer	Значение расстояния для межзональных маршрутов (от 1 до 255).
intra_area integer	Значение расстояния для внутризональных маршрутов (от 1 до 255).
graceful_restart dictionary	Переадресация OSPF без остановки (NSF), также известная как OSPF Graceful Restart.
enable boolean	Включить плавное возобновление работы. Варианты: `false` `true`
grace_period integer	Максимальная продолжительность периода восстановления в секундах (от 1 до 1800).
helper dictionary	Вспомогательная программа OSPF GR.
advertise_router_id list / elements=string	Рекламируемый идентификатор маршрутизатора.
enable boolean	Включить поддержку Helper. Варианты: `false` `true`
planned_only boolean	Поддерживается только запланированная перезагрузка. Варианты: `false` `true`
strict_lsa_checking boolean	Включить строгую проверку LSA. Варианты: `false` `true`
supported_grace_time integer	Поддерживаемый интервал восстановления в секундах (от 10 до 1800).
log_adjacency_changes string	Включить логи состояния смежности OSPFv2. Варианты: `"brief"` `"detail"`
max_metric dictionary	Включает рекламирование бесконечной метрики в LSA OSPFv2.

administrative boolean	Включает рекламу метрики бесконечного типа административного типа. Choices: `false` `true`
external_lsa_all integer	Настройка рекламы максимальной метрики для всех префиксов внешних LSA. Настройте максимальное значение метрики (от 1 до 16777215).
external_lsa_connected integer	Настройка рекламы максимальной метрики для префиксов внешних LSA, подключенных к сети. Настройте максимальное значение метрики (от 1 до 16777215).
on_startup integer	Включает рекламу метрики бесконечного типа при запуске маршрутизатора OSPFv2 (от 5 до 86400).
router_lsa_all integer	Настройка рекламы максимальной метрики для всех каналов LSA маршрутизатора. Настройте максимальное значение метрики (от 1 до 16777215).
router_lsa_stub integer	Настройка рекламы максимальной метрики для stub каналов LSA маршрутизатора. Настройте максимальное значение метрики (от 1 до 16777215).
maximum_paths integer	Настройка максимального количества путей для поддержки ECMP (от 1 до 256).
non_passive_interfaces list / elements=dictionary	Настройка типов непассивных интерфейсов.
addresses list / elements=string	Настройка IPv4-адресов интерфейса.
interface string / required	Полное имя интерфейса 3-го уровня, например, Eth1/1.
opaque_lsa_capability boolean	Включает возможность Opaque LSA. Choices: `false` `true`
passive_interfaces list / elements=dictionary	Настройка типов пассивных интерфейсов.
addresses list / elements=string	Настройка IPv4-адресов интерфейса.
interface string / required	Полное имя интерфейса 3-го уровня, например, Eth1/1.
redistribute list / elements=dictionary	Настройка перераспределения маршрутов в маршрутизатор OSPFv2.
always boolean	Включить перераспределение маршрута по умолчанию в OSPF всегда. Доступно только для protocol=default_route. Choices: `false` `true`
metric integer	Значение метрики для перераспределяемых маршрутов (от 0 до 16777214).
metric_type integer	Тип метрики для перераспределяемых маршрутов. Choices: `1` `2`
protocol string / required	Настройка типа протокола для перераспределения в OSPF. Удаление только protocol также удалит все остальные конфигурации в redistribute. `bgp` - Border Gateway Protocol. `connected` - Прямо подключенные или присоединенные подсети и хосты. `default_route` - Маршруты по умолчанию. `kernel` - Маршруты ядра, отличные от маршрутов, установленных FRR. `static` - Статически настроенные маршруты. Choices: `"bgp"` `"connected"` `"default_route"` `"kernel"` `"static"`
route_map string	Карта маршрутов для фильтрации перераспределяемых маршрутов. Настройте карту маршрутов заранее.
refresh_timer integer	Настраивает интервал обновления LSA в секундах (от 10 до 1800).

rfc1583_compatible boolean	Включить совместимость OSPFv2 с RFC. Варианты: `false` `true`
router_id string	Настройка идентификатора маршрутизатора OSPFv2 (A.B.C.D).
timers dictionary	Настройка таймеров маршрутизатора.
lsa_min_arrival integer	Таймер минимального прибытия LSA в миллисекундах (от 0 до 600000).
throttle_lsa_all integer	Задержка LSA между передачами в миллисекундах (от 0 до 5000).
throttle_spf dictionary	Таймеры OSPFv2 SPF. delay_time, initial_hold_time и maximum_hold_time должны быть указаны вместе.
delay_time integer	Время задержки SPF в миллисекундах (от 0 до 600000).
initial_hold_time integer	Начальное время удержания SPF в миллисекундах (от 0 до 600000).
maximum_hold_time integer	Максимальное время удержания SPF в миллисекундах (от 0 до 600000).
vrf_name string	Указывает имя vrf. По умолчанию: `"default"`
write_multiplier integer	Указывает максимальное количество обслуживаемых интерфейсов за один запрос (от 1 до 100)
state string	Указывает операцию, которая должна быть выполнена над процессом OSPFv2, настроенным на устройстве. В случае слияния входная конфигурация будет слита с существующей конфигурацией OSPFv2 на устройстве. В случае удаления существующая конфигурация OSPFv2 будет удалена с устройства. В случае переопределения вся существующая конфигурация OSPFv2 будет удалена, а указанная входная конфигурация будет установлена. В случае замены существующая конфигурация OSPFv2 на устройстве будет заменена конфигурацией в книге задач для каждой группы VRF, настроенной книгой задач. Варианты: `"merged"` ← (по умолчанию) `"deleted"` `"replaced"` `"overridden"`

Примечания

Примечание

Поддерживает check_mode.

Примеры

# Using deleted

# Before state:
# -------------
#
#sonic# show running-configuration ospf
#router ospf vrf Vrf_1
# default-metric 100
# max-metric router-lsa external-lsa all 2
# passive-interface default
# timers throttle spf 50 20 10
# timers throttle lsa all 300
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# no passive-interface Eth1/1 2.2.2.2
# no passive-interface Eth1/2 2.2.2.2
#!
#router ospf
# ospf router-id 20.20.20.20
# distance 30
# distance ospf external 20
# refresh timer 300
# write-multiplier 20
# maximum-paths 200
# passive-interface Eth1/2 3.3.3.3
# passive-interface Eth1/3
#!
#sonic#
#sonic# show running-configuration vrf Vrf_1
#!
#ip vrf Vrf_1
#sonic# show running-configuration ip prefix-list
#!
#ip prefix-list PRF_LIST seq 1 permit 1.1.1.1/24
#ip prefix-list PRF_LIST2 seq 1 permit 1.1.1.1/24
#sonic# show running-configuration route-map
#!
#route-map RMAP permit 1
#sonic#

  - name: Delete the OSPFv2 configurations
    sonic_ospf:
      config:
        - vrf_name: 'default'
          router_id: "20.20.20.20"
          distance:
            external: 20
          default_passive: false
          maximum_paths: 200
          passive_interfaces:
            interfaces:
              - interface: 'Eth1/3'
          redistribute:
            - protocol: "bgp"
              metric: 15
              metric_type: 2
              route_map: "RMAP"
          refresh_timer: 300
        - vrf_name: "Vrf_1"
          timers:
            throttle_spf:
              delay_time: 50
              initial_hold_time: 20
              maximum_hold_time: 10
          default_metric: 100
          max_metric:
            external_lsa_all: 2
          non_passive_interfaces:
            interfaces:
              - interface: "Eth1/2"
                addresses:
                  - "2.2.2.2"
      state: deleted

# After state:
# ------------
#
#sonic# show running-configuration ospf
#router ospf vrf Vrf_1
# passive-interface default
# timers throttle lsa all 300
# no passive-interface Eth1/1 2.2.2.2
# no passive-interface Eth1/2 2.2.2.2
#!
#router ospf
# distance 30
# write-multiplier 20
# passive-interface Eth1/2 3.3.3.3
#!
#sonic#


# Using deleted

# Before state:
# -------------
#
#sonic# show running-configuration ospf
#router ospf vrf Vrf_1
# passive-interface default
# timers throttle lsa all 300
# no passive-interface Eth1/1 2.2.2.2
# no passive-interface Eth1/2 2.2.2.2
#!
#router ospf
# distance 30
# write-multiplier 20
# passive-interface Eth1/2 3.3.3.3
#!
#sonic#
#sonic# show running-configuration vrf Vrf_1
#!
#ip vrf Vrf_1
#sonic# show running-configuration ip prefix-list
#!
#ip prefix-list PRF_LIST seq 1 permit 1.1.1.1/24
#ip prefix-list PRF_LIST2 seq 1 permit 1.1.1.1/24
#sonic# show running-configuration route-map
#!
#route-map RMAP permit 1
#sonic#

  - name: Delete the OSPFv2 configurations
    sonic_ospf:
      config:
        - vrf_name: "Vrf_1"
      state: deleted

# After state:
# ------------
#
#sonic# show running-configuration ospf
#router ospf
# distance 30
# write-multiplier 20
# passive-interface Eth1/2 3.3.3.3
#!
#sonic#


# Using merged

# Before state:
# -------------
#
# sonic# show running-configuration ospf
# (No ospf configuration present)
#sonic# show running-configuration vrf Vrf_1
#!
#ip vrf Vrf_1
#sonic# show running-configuration ip prefix-list
#!
#ip prefix-list PRF_LIST seq 1 permit 1.1.1.1/24
#ip prefix-list PRF_LIST2 seq 1 permit 1.1.1.1/24
#sonic# show running-configuration route-map
#!
#route-map RMAP permit 1
#sonic#

  - name: Add the OSPFv2 configurations
    sonic_ospf:
      config:
        - vrf_name: 'default'
          router_id: "10.10.10.10"
          distance:
            external: 20
          auto_cost_reference_bandwidth: 100
        - vrf_name: "Vrf_1"
          timers:
            throttle_lsa_all: 300
            throttle_spf:
              delay_time: 10
              initial_hold_time: 20
              maximum_hold_time: 50
          redistribute:
            - protocol: "bgp"
              metric: 15
              metric_type: 2
              route_map: "RMAP"
          default_passive: true
          non_passive_interfaces:
            interfaces:
              - interface: "Eth1/1"
                addresses:
                  - "2.2.2.2"
      state: merged

# After state:
# ------------
#
#sonic# show running-configuration ospf
#router ospf vrf Vrf_1
# passive-interface default
# timers throttle spf 10 20 50
# timers throttle lsa all 300
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# no passive-interface Eth1/1 2.2.2.2
#!
#router ospf
# auto-cost reference-bandwidth 100
# ospf router-id 10.10.10.10
# distance ospf external 20
#!
#sonic#


# Using merged

# Before state:
# -------------
#
#sonic# show running-configuration ospf
#router ospf vrf Vrf_1
# passive-interface default
# timers throttle spf 10 20 50
# timers throttle lsa all 300
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# no passive-interface Eth1/1 2.2.2.2
#!
#router ospf
# ospf router-id 10.10.10.10
# distance ospf external 20
#!
#sonic#
#sonic# show running-configuration vrf Vrf_1
#!
#ip vrf Vrf_1
#sonic# show running-configuration ip prefix-list
#!
#ip prefix-list PRF_LIST seq 1 permit 1.1.1.1/24
#ip prefix-list PRF_LIST2 seq 1 permit 1.1.1.1/24
#sonic# show running-configuration route-map
#!
#route-map RMAP permit 1
#sonic#

  - name: Add the OSPFv2 configurations
    sonic_ospf:
      config:
        - vrf_name: 'default'
          write_multiplier: 20
          router_id: "20.20.20.20"
          distance:
            all: 30
          default_passive: false
          graceful_restart:
            enable: true
            grace_period: 100
            helper:
              enable: true
              planned_only: true
              advertise_router_id:
                - '1.1.1.1'
                - '2.2.2.2'
          passive_interfaces:
            interfaces:
              - interface: 'Eth1/2'
                addresses:
                  - '3.3.3.3'
              - interface: 'Eth1/3'
          log_adjacency_changes: 'detail'
        - vrf_name: "Vrf_1"
          timers:
            throttle_spf:
              delay_time: 50
              initial_hold_time: 20
              maximum_hold_time: 10
          max_metric:
            external_lsa_all: 30
          log_adjacency_changes: 'brief'
          default_passive: true
          non_passive_interfaces:
            interfaces:
              - interface: "Eth1/2"
                addresses:
                  - "2.2.2.2"
      state: merged

# After state:
# ------------
#
#sonic# show running-configuration ospf
#router ospf vrf Vrf_1
# log-adjacency-changes
# max-metric router-lsa external-lsa all 30
# passive-interface default
# timers throttle spf 50 20 10
# timers throttle lsa all 300
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# no passive-interface Eth1/1 2.2.2.2
# no passive-interface Eth1/2 2.2.2.2
#!
#router ospf
# ospf router-id 20.20.20.20
# distance 30
# distance ospf external 20
# log-adjacency-changes detail
# graceful-restart grace-period 100
# graceful-restart helper enable
# graceful-restart helper planned-only
# graceful-restart helper enable 1.1.1.1
# graceful-restart helper enable 2.2.2.2
# write-multiplier 20
# passive-interface Eth1/2 3.3.3.3
# passive-interface Eth1/3
#!
#sonic#


# Using replaced

# Before state:
# -------------
#
#sonic# show running-configuration ospf
#router ospf vrf Vrf_1
# max-metric router-lsa external-lsa all 2
# passive-interface default
# timers throttle spf 50 20 10
# timers throttle lsa all 300
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# no passive-interface Eth1/1 2.2.2.2
# no passive-interface Eth1/2 2.2.2.2
#!
#router ospf
# ospf router-id 20.20.20.20
# distance 30
# distance ospf external 20
# write-multiplier 20
# passive-interface Eth1/2 3.3.3.3
# passive-interface Eth1/3
#!
#sonic#
#sonic# show running-configuration vrf Vrf_1
#!
#ip vrf Vrf_1
#sonic# show running-configuration ip prefix-list
#!
#ip prefix-list PRF_LIST seq 1 permit 1.1.1.1/24
#ip prefix-list PRF_LIST2 seq 1 permit 1.1.1.1/24
#sonic# show running-configuration route-map
#!
#route-map RMAP permit 1
#route-map RMAP2 permit 2
#sonic#

  - name: Replace the OSPFv2 vrf default configurations
    sonic_ospf:
      config:
        - vrf_name: 'default'
          router_id: "20.20.20.20"
          redistribute:
            - protocol: "connected"
              metric: 15
              metric_type: 2
              route_map: "RMAP2"
            - protocol: "default_route"
              always: true
              route_map: "RMAP"
          distance:
            all: 20
          abr_type: cisco
          opaque_lsa_capability: true
      state: replaced

# After state:
# ------------
#
#sonic# show running-configuration ospf
#router ospf vrf Vrf_1
# max-metric router-lsa external-lsa all 2
# passive-interface default
# timers throttle spf 50 20 10
# timers throttle lsa all 300
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# no passive-interface Eth1/1 2.2.2.2
# no passive-interface Eth1/2 2.2.2.2
#!
#router ospf
# capability opaque
# ospf router-id 20.20.20.20
# default-information originate always route-map RMAP
# distance 20
# ospf abr-type cisco
# redistribute connected metric 15 metric-type 2 route-map RMAP2
#!


# Using overridden

# Before state:
# -------------
#
#sonic# show running-configuration ospf
#router ospf vrf Vrf_1
# max-metric router-lsa external-lsa all 2
# passive-interface default
# timers throttle spf 50 20 10
# timers throttle lsa all 300
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# no passive-interface Eth1/1 2.2.2.2
# no passive-interface Eth1/2 2.2.2.2
#!
#router ospf
# ospf router-id 20.20.20.20
# distance 30
# distance ospf external 20
# write-multiplier 20
# passive-interface Eth1/2 3.3.3.3
# passive-interface Eth1/3
#!
#sonic#
#sonic# show running-configuration vrf Vrf_1
#!
#ip vrf Vrf_1
#sonic# show running-configuration ip prefix-list
#!
#ip prefix-list PRF_LIST seq 1 permit 1.1.1.1/24
#ip prefix-list PRF_LIST2 seq 1 permit 1.1.1.1/24
#sonic# show running-configuration route-map
#!
#route-map RMAP permit 1
#route-map RMAP2 permit 2
#sonic#

  - name: Override the OSPFv2 configurations
    sonic_ospf:
      config:
        - vrf_name: 'default'
          router_id: "20.20.20.20"
          redistribute:
            - protocol: "connected"
              metric: 15
              metric_type: 2
              route_map: "RMAP2"
          distance:
            all: 20
          rfc1583_compatible: true
      state: overridden

# After state:
# ------------
#
#sonic# show running-configuration ospf
#router ospf
# compatible rfc1583
# ospf router-id 20.20.20.20
# distance 20
# redistribute connected metric 15 metric-type 2 route-map RMAP2
#!

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

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

Ключ	Описание
after список / элементы=строка	Вызов модуля конфигурации с результатом. Возвращается: при изменении Пример: `["The configuration returned will always be in the same format\n as the parameters above.\n"]`
after(generated) список / элементы=строка	Вызов модуля конфигурации с сгенерированным результатом. Возвращается: при `check_mode` Пример: `["The configuration returned will always be in the same format\n as the parameters above.\n"]`
before список / элементы=строка	Конфигурация до вызова модуля. Возвращается: всегда Пример: `["The configuration returned will always be in the same format\n as the parameters above.\n"]`
commands список / элементы=строка	Набор команд, отправленных на удалённое устройство. Возвращается: всегда Пример: `["command 1", "command 2", "command 3"]`

Авторы

Santhosh kumar T (@santhosh-kt)

Ссылки на сборки

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/dellemc/enterprise_sonic/sonic_ospfv2_module.html