Модуль dellemc.enterprise_sonic.sonic_ospfv3 — настройка глобальных параметров протокола OSPFv3 на SONiC.

Примечание

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

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

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

Чтобы использовать коллекцию в плейбуке, укажите: dellemc.enterprise_sonic.sonic_ospfv3.

Добавлено в dellemc.enterprise_sonic 3.1.0

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

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

Этот модуль управляет конфигурацией глобальных параметров OSPFv3 на устройствах под управлением SONiC.
Перед настройкой OSPFv3 в VRF настройте экземпляр VRF.

Параметры

Параметр	Комментарии
config list / elements=dictionary	Задает конфигурацию, связанную с OSPFv3.
auto_cost_reference_bandwidth integer	Задает эталонную пропускную способность для автоматического расчета стоимости интерфейса (от 1 до 4294967).
distance dictionary	Задает административное расстояние маршрута.
all integer	Значение расстояния для всех типов маршрутов (от 1 до 255).
external integer	Внешние маршруты (от 1 до 255).
inter_area integer	Межзональные маршруты (от 1 до 255).
intra_area integer	Внутризональные маршруты (от 1 до 255).
graceful_restart dictionary	Непрерывная переадресация OSPFv3 (NSF), также известная как Graceful Restart для OSPFv3.
enable boolean	Включает плавный перезапуск. Возможные значения: `false` `true`
grace_period integer	Максимальная длительность периода ожидания (от 1 до 1800).
helper dictionary	Помощник GR для OSPFv3.
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	Включает ведение журналов изменения состояния смежности OSPFv3. Возможные значения: `"brief"` `"detail"`
maximum_paths integer	Задает максимальное количество путей для поддержки ECMP (от 1 до 256).
redistribute list / elements=dictionary	Настраивает перераспределение маршрутов в маршрутизатор OSPFv3.
always boolean	Всегда включает перераспределение маршрута по умолчанию в OSPFv3. Доступно только для protocol=default_route. Возможные значения: `false` `true`
metric integer	Значение метрики для перераспределяемых маршрутов (от 0 до 16777214).
metric_type integer	Тип метрики для перераспределяемых маршрутов. Возможные значения: `1` `2`
protocol string / обязательный	Задает тип протокола для перераспределения в OSPFv3. Удаление только protocol также приведет к удалению всей остальной конфигурации в разделе redistribute. `bgp` — протокол пограничного шлюза. `connected` — непосредственно подключенные или присоединенные подсети и узлы. `default_route` — маршруты по умолчанию. `kernel` — маршруты ядра, кроме маршрутов, установленных FRR. `static` — статически настроенные маршруты. Возможные значения: `"bgp"` `"connected"` `"default_route"` `"kernel"` `"static"`
route_map string	Карта маршрутов для фильтрации перераспределяемых маршрутов. Предварительно настройте карту маршрутов.
router_id string	Задает идентификатор маршрутизатора OSPFv3 (A.B.C.D).
timers dictionary	Настраивает таймеры маршрутизатора.
lsa_min_arrival integer	Минимальный интервал поступления LSA (от 0 до 600000).
throttle_spf dictionary	Таймеры SPF для OSPFv3. Параметры 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	Задает операцию, выполняемую над процессом OSPFv3, настроенным на устройстве. При значении merged входная конфигурация объединяется с существующей конфигурацией OSPFv3 на устройстве. При значении deleted указанная существующая конфигурация OSPFv3 удаляется с устройства. При значении overridden вся существующая конфигурация OSPFv3 удаляется, а указанная входная конфигурация устанавливается. При значении replaced существующая конфигурация OSPFv3 на устройстве заменяется конфигурацией из плейбука для каждой группы VRF, настроенной в плейбуке. Возможные значения: `"merged"` ← (по умолчанию) `"deleted"` `"replaced"` `"overridden"`

Примечания

Примечание

Поддерживает check_mode.
Проверено на Enterprise SONiC Distribution от Dell Technologies.

Примеры

# Using deleted

# Before state:
# -------------
#
# sonic# show running-configuration ospfv3
# router ospfv3 vrf Vrf_1
# timers throttle spf 50 20 1000
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# !
# router ospfv3
# ospfv3 router-id 20.20.20.20
# distance 30
# distance ospfv3 external 20
# write-multiplier 20
# !
# sonic#
# sonic# show running-configuration vrf Vrf_1
# !
# ip vrf Vrf_1
# sonic# show running-configuration ipv6 prefix-list
# !
# ipv6 prefix-list PRF_LIST seq 1 permit 1::1/64
# ipv6 prefix-list PRF_LIST2 seq 1 permit 2::1/64
# sonic# show running-configuration route-map
# !
# route-map RMAP permit 1
# sonic#

- name: Delete the OSPFv3 configurations
  sonic_ospfv3:
    config:
      - vrf_name: 'default'
        router_id: "20.20.20.20"
        distance:
          external: 20
      - vrf_name: "Vrf_1"
        timers:
          throttle_spf:
          delay_time: 50
          initial_hold_time: 20
          maximum_hold_time: 1000
    state: deleted

# After state:
# ------------
#
# sonic# show running-configuration ospfv3
# router ospfv3 vrf Vrf_1
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# !
# router ospfv3
# distance 30
# write-multiplier 20
# !
# sonic#


# Using deleted

# Before state:
# -------------
#
# sonic# show running-configuration ospfv3
# router ospfv3 vrf Vrf_1
# timers throttle spf 50 20 1000
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# !
# router ospfv3
# distance 30
# write-multiplier 20
# !
# sonic#
# sonic# show running-configuration vrf Vrf_1
# !
# ip vrf Vrf_1
# sonic# show running-configuration ipv6 prefix-list
# !
# ipv6 prefix-list PRF_LIST seq 1 permit 1::1/24
# ipv6 prefix-list PRF_LIST2 seq 1 permit 2::1/24
# sonic# show running-configuration route-map
# !
# route-map RMAP permit 1
# sonic#

- name: Delete the OSPFv3 configurations
  sonic_ospfv3:
    config:
      - vrf_name: "Vrf_1"
    state: deleted

# After state:
# ------------
#
# sonic# show running-configuration ospfv3
# router ospfv3
# distance 30
# write-multiplier 20
# !
# sonic#


# Using merged

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

- name: Add the OSPFv3 configurations
  sonic_ospfv3:
    config:
      - vrf_name: 'default'
        router_id: "10.10.10.10"
        distance:
          external: 20
      - vrf_name: "Vrf_1"
        timers:
          throttle_spf:
          delay_time: 10
          initial_hold_time: 20
          maximum_hold_time: 50
        redistribute:
          - protocol: "bgp"
            metric: 15
            metric_type: 2
            route_map: "RMAP"
    state: merged

# After state:
# ------------
#
# sonic# show running-configuration ospfv3
# router ospfv3 vrf Vrf_1
# timers throttle spf 10 20 50
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# !
# router ospfv3
# ospfv3 router-id 10.10.10.10
# distance ospfv3 external 20
# !
# sonic#


# Using merged

# Before state:
# -------------
#
# sonic# show running-configuration ospfv3
# router ospfv3 vrf Vrf_1
# timers throttle spf 10 20 50
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# !
# router ospfv3
# ospfv3 router-id 10.10.10.10
# distance ospfv3 external 20
# !
# sonic#
# sonic# show running-configuration vrf Vrf_1
# !
# ip vrf Vrf_1
# sonic# show running-configuration ipv6 prefix-list
# !
# ipv6 prefix-list PRF_LIST seq 1 permit 1::1/24
# ipv6 prefix-list PRF_LIST2 seq 1 permit 2::1/24
# sonic# show running-configuration route-map
# !
# route-map RMAP permit 1
# sonic#

- name: Add the OSPFv3 configurations
  sonic_ospfv3:
    config:
      - vrf_name: 'default'
        write_multiplier: 20
        router_id: "20.20.20.20"
        distance:
          all: 30
      - vrf_name: "Vrf_1"
        timers:
          throttle_spf:
            delay_time: 50
            initial_hold_time: 20
            maximum_hold_time: 100
    state: merged

# After state:
# ------------
#
# sonic# show running-configuration ospfv3
# router ospfv3 vrf Vrf_1
# timers throttle spf 50 20 100
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# !
# router ospfv3
# ospfv3 router-id 20.20.20.20
# distance 30
# distance ospfv3 external 20
# write-multiplier 20
# !
# sonic#


# Using replaced

# Before state:
# -------------
#
# sonic# show running-configuration ospfv3
# router ospfv3 vrf Vrf_1
# timers throttle spf 50 20 10
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# !
# router ospfv3
# ospfv3 router-id 20.20.20.20
# distance 30
# distance ospfv3 external 20
# write-multiplier 20
# !
# sonic#
# sonic# show running-configuration vrf Vrf_1
# !
# ip vrf Vrf_1
# sonic# show running-configuration ipv6 prefix-list
# !
# ipv6 prefix-list PRF_LIST seq 1 permit 1::1/24
# ipv6 prefix-list PRF_LIST2 seq 1 permit 2::1/24
# sonic# show running-configuration route-map
# !
# route-map RMAP permit 1
# route-map RMAP2 permit 2
# sonic#

- name: Replace the OSPFv3 vrf default configurations
  sonic_ospfv3:
    config:
      - vrf_name: 'default'
        router_id: "20.20.20.20"
        redistribute:
          - protocol: "connected"
            metric: 15
            metric_type: 2
            route_map: "RMAP2"
        distance:
          all: 20
    state: replaced

# After state:
# ------------
#
# sonic# show running-configuration ospfv3
# router ospfv3 vrf Vrf_1
# timers throttle spf 50 20 10
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# !
# router ospfv3
# ospfv3 router-id 20.20.20.20
# distance 20
# redistribute connected metric 15 metric-type 2 route-map RMAP2
# !


# Using overridden

# Before state:
# -------------
#
# sonic# show running-configuration ospfv3
# router ospfv3 vrf Vrf_1
# timers throttle spf 50 20 10
# redistribute bgp metric 15 metric-type 2 route-map RMAP
# !
# router ospfv3
# ospfv3 router-id 20.20.20.20
# distance 30
# distance ospfv3 external 20
# write-multiplier 20
# !
# sonic#
# sonic# show running-configuration vrf Vrf_1
# !
# ip vrf Vrf_1
# sonic# show running-configuration ipv6 prefix-list
# !
# ipv6 prefix-list PRF_LIST seq 1 permit 1::1/24
# ipv6 prefix-list PRF_LIST2 seq 1 permit 2::1/24
# sonic# show running-configuration route-map
# !
# route-map RMAP permit 1
# route-map RMAP2 permit 2
# sonic#

- name: Override the OSPFv3 configurations
  sonic_ospfv3:
    config:
      - vrf_name: 'default'
        router_id: "20.20.20.20"
        redistribute:
          - protocol: "connected"
            metric: 15
            metric_type: 2
            route_map: "RMAP2"
        distance:
          all: 20
    state: replaced

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

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

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

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

Авторы

Thenmozhi Gopal (@thenmozhi-gopal), Naresh Sasivarnan (@NareshSasivarnan)

Ссылки на коллекцию

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