Модуль arista.eos.eos_static_routes – Модуль ресурса статических маршрутов
Примечание
Этот модуль является частью коллекции arista.eos (версия 9.0.0).
Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install arista.eos.
Для использования в playbook, укажите: arista.eos.eos_static_routes.
Новое в arista.eos 1.0.0
Краткое описание
- Этот модуль настраивает и управляет атрибутами статических маршрутов на платформах Arista EOS.
Псевдонимы: static_routes
Параметры
Параметр | Комментарии |
|---|---|
config список / элементы=словарь | Список конфигураций для статических маршрутов. |
|
address_families список / элементы=словарь |
Словарь, указывающий семейство адресов, к которому принадлежат статические маршруты. |
|
afi строка / обязательно |
Указывает основной индикатор семейства адресов. Варианты:
|
|
routes список / элементы=словарь |
Словарь, который указывает конфигурации статических маршрутов. |
|
dest строка / обязательно |
Подсеть назначения IPv4 (нотация CIDR или адрес-маска). Формат адреса: <v4/v6 адрес>/<маска> или <v4/v6 адрес> <маска>. Маска — это число в диапазоне 0-32 для IPv4 и в диапазоне 0-128 для IPv6. |
|
next_hops список / элементы=словарь |
Подробности маршрута, который будет пройден. |
|
admin_distance целое число |
Приоритет или административное расстояние маршрута (диапазон 1-255). |
|
description строка |
Название статического маршрута. |
|
forward_router_address строка |
Адрес маршрутизатора пересылки на интерфейсе назначения. |
|
interface строка |
Исходящий интерфейс. Для всего, кроме «null0», необходимо также настроить IP-адрес следующего прыжка. IP-адрес маршрутизатора следующего прыжка или null0 Интерфейс Null0 или ethernet e_num Ethernet интерфейс или loopback l_num Loopback интерфейс или management m_num Интерфейс управления или port-channel p_num vlan v_num vxlan vx_num Nexthop-Group Укажите имя группы nexthop Tunnel Интерфейс туннеля vtep Настройка конечных точек туннеля VXLAN |
|
mpls_label целое число |
Метка MPLS |
|
nexthop_grp строка |
Группа nexthop |
|
tag целое число |
Значение метки маршрута (диапазон от 0 до 4294967295). |
|
track строка |
Значение отслеживания (диапазон 1-512). Отслеживание должно быть уже настроено на устройстве перед добавлением маршрута. |
|
vrf строка |
VRF назначения. |
|
vrf строка |
VRF, к которому принадлежат статические маршруты. |
running_config строка | Этот параметр используется только с состоянием parsed. Значение этого параметра должно быть выводом, полученным от устройства EOS путем выполнения команды show running-config | grep routes. Состояние parsed считывает конфигурацию из параметра |
state строка | Состояние, в котором должна находиться конфигурация. Варианты:
|
Примечания
Примечание
- Тестировалось на Arista EOS 4.24.6F
- Этот модуль работает с подключением
network_cli. См. Параметры платформы EOS.
Примеры
# Using deleted
# Before State:
# ------------
# veos(config)#show running-config | grep route
# ip route vrf testvrf 22.65.1.0/24 Null0 90 name testroute
# ipv6 route 5222:5::/64 Management1 4312:100::1
# ipv6 route vrf testvrf 2222:6::/64 Management1 4312:100::1
# ipv6 route vrf testvrf 2222:6::/64 Ethernet1 55
# ipv6 route vrf testvrf 2222:6::/64 Null0 90 name testroute1
# veos(config)#
- name: Delete afi
arista.eos.eos_static_routes:
config:
- vrf: testvrf
address_families:
- afi: ipv4
state: deleted
# Task Output
# -------------
# before:
# - address_families:
# - afi: ipv6
# routes:
# - dest: 5222:5::/64
# next_hops:
# - forward_router_address: 4312:100::1
# interface: Management1
# - address_families:
# - afi: ipv4
# routes:
# - dest: 22.65.1.0/24
# next_hops:
# - admin_distance: 90
# description: testroute
# interface: Null0
# - afi: ipv6
# routes:
# - dest: 2222:6::/64
# next_hops:
# - forward_router_address: 4312:100::1
# interface: Management1
# - admin_distance: 55
# interface: Ethernet1
# - admin_distance: 90
# description: testroute1
# interface: Null0
# vrf: testvrf
# commands:
# - no ip route vrf testvrf 22.65.1.0/24 Null0 90 name testroute
# after:
# - address_families:
# - afi: ipv6
# routes:
# - dest: 5222:5::/64
# next_hops:
# - forward_router_address: 4312:100::1
# interface: Management1
# - address_families:
# - afi: ipv6
# routes:
# - dest: 2222:6::/64
# next_hops:
# - forward_router_address: 4312:100::1
# interface: Management1
# - admin_distance: 55
# interface: Ethernet1
# - admin_distance: 90
# description: testroute1
# interface: Null0
# vrf: testvrf
# After State
# ___________
# veos(config)#show running-config | grep route
# ipv6 route 5222:5::/64 Management1 4312:100::1
# ipv6 route vrf testvrf 2222:6::/64 Management1 4312:100::1
# ipv6 route vrf testvrf 2222:6::/64 Ethernet1 55
# ipv6 route vrf testvrf 2222:6::/64 Null0 90 name testroute1
# Using merged
# Before State
# -------------
# veos(config)#show running-config | grep "route"
# ip route 165.10.1.0/24 Ethernet1 100
# ip route 172.17.252.0/24 Nexthop-Group testgroup
# ip route vrf testvrf 130.1.122.0/24 Ethernet1 tag 50
# ipv6 route 5001::/64 Ethernet1 50
# veos(config)#
- name: Merge new static route configuration
arista.eos.eos_static_routes:
config:
- vrf: testvrf
address_families:
- afi: ipv6
routes:
- dest: 2211::0/64
next_hop:
- forward_router_address: 100:1::2
interface: Ethernet1
state: merged
# Task Output
# -------------
# before:
# - address_families:
# - afi: ipv4
# routes:
# - dest: 165.10.1.0/24
# next_hops:
# - admin_distance: 100
# interface: Ethernet1
# - dest: 172.17.252.0/24
# next_hops:
# - nexthop_grp: testgroup
# - afi: ipv6
# routes:
# - dest: 5001::/64
# next_hops:
# - admin_distance: 50
# interface: Ethernet1
# - address_families:
# - afi: ipv4
# routes:
# - dest: 130.1.122.0/24
# next_hops:
# - interface: Ethernet1
# tag: 50
# vrf: testvrf
# commands:
# - ipv6 route 2211::/64 Ethernet1 100:1::2
# after:
# - address_families:
# - afi: ipv4
# routes:
# - dest: 165.10.1.0/24
# next_hops:
# - admin_distance: 100
# interface: Ethernet1
# - dest: 172.17.252.0/24
# next_hops:
# - nexthop_grp: testgroup
# - afi: ipv6
# routes:
# - dest: 5001::/64
# next_hops:
# - admin_distance: 50
# interface: Ethernet1
# - address_families:
# - afi: ipv4
# routes:
# - dest: 130.1.122.0/24
# next_hops:
# - interface: Ethernet1
# tag: 50
# - afi: ipv6
# routes:
# - dest: 2211::0/64
# next_hops:
# - aforward_router_address: "100:1::2"
# interface: Ethernet1
# vrf: testvrf
# After State
# -----------
# veos(config)#show running-config | grep "route"
# ip route 165.10.1.0/24 Ethernet1 100
# ip route 172.17.252.0/24 Nexthop-Group testgroup
# ip route vrf testvrf 130.1.122.0/24 Ethernet1 tag 50
# ipv6 route 2211::/64 Ethernet1 100:1::2
# ipv6 route 5001::/64 Ethernet1 50
# veos(config)#
# Using overridden
# Before State
# -------------
# veos(config)#show running-config | grep "route"
# ip route 165.10.1.0/24 Ethernet1 100
# ip route 172.17.252.0/24 Nexthop-Group testgroup
# ip route vrf testvrf 130.1.122.0/24 Ethernet1 tag 50
# ipv6 route 5001::/64 Ethernet1 50
# veos(config)#
- name: Overridden static route configuration
arista.eos.eos_static_routes:
config:
- address_families:
- afi: ipv4
routes:
- dest: 10.2.2.0/24
next_hop:
- interface: Ethernet1
state: replaced
# Task Output
# -------------
# before:
# - address_families:
# - afi: ipv4
# routes:
# - dest: 165.10.1.0/24
# next_hops:
# - admin_distance: 100
# interface: Ethernet1
# - dest: 172.17.252.0/24
# next_hops:
# - nexthop_grp: testgroup
# - afi: ipv6
# routes:
# - dest: 5001::/64
# next_hops:
# - admin_distance: 50
# interface: Ethernet1
# - address_families:
# - afi: ipv4
# routes:
# - dest: 130.1.122.0/24
# next_hops:
# - interface: Ethernet1
# tag: 50
# vrf: testvrf
# commands:
# - no ip route 165.10.1.0/24 Ethernet1 100
# - no ip route 172.17.252.0/24 Nexthop-Group testgroup
# - no ip route vrf testvrf 130.1.122.0/24 Ethernet1 tag 50
# - no ipv6 route 5001::/64 Ethernet1 50
# - ip route 10.2.2.0/24 Ethernet1
# after:
# - address_families:
# - afi: ipv4
# routes:
# - dest: 10.2.2.0/24
# next_hops:
# - interface: Ethernet1
# After State
# -----------
# veos(config)#show running-config | grep "route"
# ip route 10.2.2.0/24 Ethernet1
# veos(config)#
# Using replaced
# Before State
# -------------
# ip route 10.2.2.0/24 Ethernet1
# ip route 10.2.2.0/24 64.1.1.1 label 17 33
# ip route 33.33.33.0/24 Nexthop-Group testgrp
# ip route vrf testvrf 22.65.1.0/24 Null0 90 name testroute
# ipv6 route 5222:5::/64 Management1 4312:100::1
# ipv6 route vrf testvrf 2222:6::/64 Management1 4312:100::1
# ipv6 route vrf testvrf 2222:6::/64 Ethernet1 55
# ipv6 route vrf testvrf 2222:6::/64 Null0 90 name testroute1
- name: Replace nexthop
arista.eos.eos_static_routes:
config:
- vrf: testvrf
address_families:
- afi: ipv6
routes:
- dest: 2222:6::/64
next_hops:
- admin_distance: 56
interface: Ethernet1
state: replaced
# Task Output
# -------------
# before:
# - address_families:
# - afi: ipv4
# routes:
# - dest: 10.2.2.0/24
# next_hops:
# - interface: Ethernet1
# - admin_distance: 33
# interface: 64.1.1.1
# mpls_label: 17
# - dest: 33.33.33.0/24
# next_hops:
# - nexthop_grp: testgrp
# - afi: ipv6
# routes:
# - dest: 5222:5::/64
# next_hops:
# - forward_router_address: 4312:100::1
# interface: Management1
# - address_families:
# - afi: ipv4
# routes:
# - dest: 22.65.1.0/24
# next_hops:
# - admin_distance: 90
# description: testroute
# interface: Null0
# - afi: ipv6
# routes:
# - dest: 2222:6::/64
# next_hops:
# - forward_router_address: 4312:100::1
# interface: Management1
# - admin_distance: 90
# description: testroute1
# interface: Null0
# vrf: testvrf
# commands:
# - no ipv6 route vrf testvrf 2222:6::/64 Management1 4312:100::1
# - no ipv6 route vrf testvrf 2222:6::/64 Ethernet1 55
# - no ipv6 route vrf testvrf 2222:6::/64 Null0 90 name testroute1
# - ipv6 route vrf testvrf 2222:6::/64 Ethernet1 56
# after:
# - address_families:
# - afi: ipv4
# routes:
# - dest: 10.2.2.0/24
# next_hops:
# - interface: Ethernet1
# - admin_distance: 33
# interface: 64.1.1.1
# mpls_label: 17
# - dest: 33.33.33.0/24
# next_hops:
# - nexthop_grp: testgrp
# - afi: ipv6
# routes:
# - dest: 5222:5::/64
# next_hops:
# - forward_router_address: 4312:100::1
# interface: Management1
# - address_families:
# - afi: ipv4
# routes:
# - dest: 22.65.1.0/24
# next_hops:
# - admin_distance: 90
# description: testroute
# interface: Null0
# - afi: ipv6
# routes:
# - dest: 2222:6::/64
# next_hops:
# - admin_distance: 56
# interface: Ethernet1
# vrf: testvrf
# After State
# -----------
# veos(config)#show running-config | grep route
# ip route 10.2.2.0/24 Ethernet1
# ip route 10.2.2.0/24 64.1.1.1 label 17 33
# ip route 33.33.33.0/24 Nexthop-Group testgrp
# ip route vrf testvrf 22.65.1.0/24 Null0 90 name testroute
# ipv6 route 5222:5::/64 Management1 4312:100::1
# ipv6 route vrf testvrf 2222:6::/64 Ethernet1 55
# Using Gathered
# Before State
# -------------
# veos(config)#show running-config | grep "route"
# ip route 165.10.1.0/24 Ethernet1 10.1.1.2 100
# ipv6 route 5001::/64 Ethernet1
# veos(config)#
- name: Gather the exisitng condiguration
arista.eos.eos_static_routes:
state: gathered
# Task Output
# -------------
# gathered:
# - address_families:
# - afi: ipv4
# routes:
# - dest: 165.10.1.0/24
# next_hop:
# - forward_router_address: 10.1.1.2
# interface: Ethernet1
# admin_distance: 100
# - afi: ipv6
# routes:
# - dest: 5001::/64
# next_hop:
# - interface: Ethernet1
# Using rendered
# arista.eos.eos_static_routes:
# config:
# - address_families:
# - afi: ipv4
# routes:
# - dest: 165.10.1.0/24
# next_hop:
# - forward_router_address: 10.1.1.2
# interface: "Ethernet1"
# admin_distance: 100
# - afi: ipv6
# routes:
# - dest: 5001::/64
# next_hop:
# - interface: "Ethernet1"
# Task Output
# -------------
# rendered:
# - ip route 165.10.1.0/24 Ethernet1 10.1.1.2 100
# - ipv6 route 5001::/64 Ethernet1
# Using parsed:
# parse_static_routes.cfg
# ip route 165.10.1.0/24 Ethernet1 10.1.1.2 100
# ipv6 route 5001::/64 Ethernet1
#
- name: parse configs
arista.eos.eos_static_routes:
running_config: "{{ lookup('file', './parse_static_routes.cfg') }}"
state: parsed
# Task Output
# -------------
# parsed:
# - address_families:
# - afi: ipv4
# routes:
# - dest: 165.10.1.0/24
# next_hop:
# - forward_router_address: 10.1.1.2
# interface: Ethernet1
# admin_distance: 100
# - afi: ipv6
# routes:
# - dest: 5001::/64
# next_hop:
# - interface: Ethernet1
Значения возврата
Общие значения возврата документированы здесь, следующие являются полями, уникальными для этого модуля:
Ключ | Описание |
|---|---|
after список / элементы=строка | Вызов модели конфигурации в результате. Возвращается: при изменении Пример: |
before список / элементы=строка | Конфигурация до вызова модели. Возвращается: всегда Пример: |
commands список / элементы=строка | Набор команд, отправленных на удалённое устройство. Возвращается: всегда Пример: |
gathered список / элементы=строка | Конфигурация как структурированные данные, преобразованные для полученной рабочей конфигурации с удалённого узла. Возвращается: Когда Пример: |
parsed список / элементы=строка | Конфигурация как структурированные данные, преобразованные для значения параметра Возвращается: Когда Пример: |
rendered список / элементы=строка | Набор команд CLI, сгенерированных из значения параметра Возвращается: Когда Пример: |
Ссылки на коллекцию
© 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/arista/eos/eos_static_routes_module.html
