Spec-Zone.ru › Ansible

модуль dellemc.enterprise_sonic.sonic_l3_interfaces — Настройка параметров IPv4 и IPv6 на интерфейсах, таких как Eth, LAG, VLAN и loopback

Примечание

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

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

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

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

Новое в dellemc.enterprise_sonic 1.0.0

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

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

  • Настраивает параметры интерфейсов уровня 3 на устройствах под управлением Enterprise SONiC Distribution by Dell Technologies. Этот модуль позволяет управлять конфигурацией параметров IPv4 и IPv6 на интерфейсах Ethernet устройств под управлением Enterprise SONiC.

Параметры

Параметр

Комментарии

config

list / elements=dictionary

Список конфигураций l3_interfaces.

ipv4

dictionary

Конфигурация IPv4, задаваемая для интерфейса уровня 3, указанного в параметре name.

addresses

list / elements=dictionary

Список задаваемых IPv4-адресов.

address

string

Задаваемый IPv4-адрес в формате <ipv4 address>/<mask>, например, 192.0.2.1/24.

secondary

boolean

Флаг дополнительного IP-адреса.

Значение по умолчанию: ‘false’

Варианты:

  • false
  • true

anycast_addresses

list / elements=string

Список IPv4-адресов anycast, которые нужно задать.

proxy_arp

dictionary

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

Параметры конфигурации прокси-ARP для IPv4

mode

string

Режимы proxy_arp

Варианты:

  • "DISABLE"
  • "REMOTE_ONLY"
  • "ALL"

ipv6

dictionary

Конфигурация IPv6, задаваемая для интерфейса уровня 3, указанного в параметре name.

addresses

list / elements=dictionary

Список задаваемых IPv6-адресов.

address

string

Задаваемый IPv6-адрес в формате <ipv6 address>/<mask>, например, 2001:db8:2201:1::1/64.

eui64

boolean

добавлено в dellemc.enterprise_sonic 2.5.0

Флаг, указывающий, является ли адрес адресом eui64

Варианты:

  • false
  • true

anycast_addresses

list / elements=string

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

Список IPv6-адресов anycast.

autoconf

boolean

добавлено в dellemc.enterprise_sonic 2.5.0

Флаг автоматической настройки

Варианты:

  • false
  • true

dad

string

добавлено в dellemc.enterprise_sonic 2.5.0

Параметры IPv6, связанные с DAD протокола ND.

Варианты:

  • "ENABLE"
  • "DISABLE"
  • "DISABLE_IPV6_ON_FAILURE"

enabled

boolean

Флаг включения IPv6.

Варианты:

  • false
  • true

nd_proxy

dictionary

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

Параметры конфигурации ND-прокси для IPv6

mode

string

Режимы nd_proxy

Варианты:

  • "DISABLE"
  • "REMOTE_ONLY"
  • "ALL"

nd_proxy_rules

list / elements=string

Список префиксов IPv6 (подсетей), для которых этот интерфейс должен выполнять функцию ND-прокси

name

string / обязательный

Полное имя интерфейса, например Eth1/3.

state

string

Состояние конфигурации после выполнения модуля.

Варианты:

  • "merged" ← (по умолчанию)
  • "deleted"
  • "replaced"
  • "overridden"

Примечания

Примечание

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

Примеры

# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration interface
# !
# interface Ethernet20
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 83.1.1.1/16
#  ip address 84.1.1.1/16 secondary
#  ipv6 address 83::1/16
#  ipv6 address 84::1/16
#  ipv6 address 85::/64 eui-64
#  ipv6 enable
#  ipv6 address autoconfig
#  ipv6 nd dad enable
#  ip proxy-arp enable remote-only
#  ipv6 nd-proxy enable all
# !
# interface Ethernet24
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 91.1.1.1/16
#  ip address 92.1.1.1/16 secondary
#  ipv6 address 90::1/16
#  ipv6 address 91::1/16
#  ipv6 address 92::1/16
#  ipv6 address 93::1/16
# !
# interface Vlan501
#  ip anycast-address 11.12.13.14/12
#  ip anycast-address 1.2.3.4/22
#  ipv6 anycast-address 101::101/64
#  ipv6 anycast-address 102::102/64
# !

- name: delete l3 interface attributes
  dellemc.enterprise_sonic.sonic_l3_interfaces:
    config:
      - name: Ethernet20
        ipv4:
          proxy_arp:
            mode: REMOTE_ONLY
          addresses:
            - address: 83.1.1.1/16
            - address: 84.1.1.1/16
        ipv6:
          addresses:
            - address: 85::/64
      - name: Ethernet24
        ipv6:
          enabled: true
          addresses:
            - address: 91::1/16
      - name: Vlan501
        ipv4:
          anycast_addresses:
            - 11.12.13.14/12
        ipv6:
          anycast_addresses:
            - 101::101/64
    state: deleted

#
# After state:
# ------------
#
# sonic# show running-configuration interface
# !
# interface Ethernet20
#  mtu 9100
#  speed 100000
#  shutdown
#  ipv6 address 83::1/16
#  ipv6 address 84::1/16
#  ipv6 enable
#  ipv6 address autoconfig
#  ipv6 nd dad enable
#  ipv6 nd-proxy enable all
# !
# interface Ethernet24
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 91.1.1.1/16
#  ip address 92.1.1.1/16 secondary
#  ipv6 address 90::1/16
#  ipv6 address 92::1/16
#  ipv6 address 93::1/16
# !
# interface Vlan501
#  ip anycast-address 1.2.3.4/22
#  ipv6 anycast-address 102::102/64
# !

# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration interface
# !
# interface Ethernet20
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 83.1.1.1/16
#  ip address 84.1.1.1/16 secondary
#  ipv6 address 83::1/16
#  ipv6 address 84::1/16
#  ipv6 address 85::/64 eui-64
#  ipv6 enable
#  ipv6 address autoconfig
#  ipv6 nd dad enable
#  ip proxy-arp enable remote-only
#  ipv6 nd-proxy enable all
#  ipv6 nd-proxy rule prefix 5001::/24
# !
# interface Ethernet24
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 91.1.1.1/16
#  ipv6 address 90::1/16
#  ipv6 address 91::1/16
#  ipv6 address 92::1/16
#  ipv6 address 93::1/16
#  ip proxy-arp enable all
#  ipv6 nd-proxy enable remote-only
#  ipv6 nd-proxy rule prefix 6001::/24
# !
# interface Vlan501
#  ip anycast-address 11.12.13.14/12
#  ip anycast-address 1.2.3.4/22
#  ipv6 anycast-address 101::101/64
#  ipv6 anycast-address 102::102/64
# !

- name: delete all l3 interface
  dellemc.enterprise_sonic.sonic_l3_interfaces:
    config:
    state: deleted

#
# After state:
# ------------
#
# sonic# show running-configuration interface
# !
# interface Ethernet20
#  mtu 9100
#  speed 100000
#  shutdown
# !
# interface Ethernet24
#  mtu 9100
#  speed 100000
#  shutdown
# !
# interface Vlan501
# !

# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show running-configuration interface
# !
# interface Ethernet20
#  mtu 9100
#  speed 100000
#  shutdown
# !
# interface Ethernet24
#  mtu 9100
#  speed 100000
#  shutdown
# !
# interface Vlan501
#  ip anycast-address 1.2.3.4/22
#  ipv6 anycast-address 101::101/64
# !

- name: Add l3 interface configurations
  dellemc.enterprise_sonic.sonic_l3_interfaces:
    config:
      - name: Ethernet20
        ipv4:
          addresses:
            - address: 83.1.1.1/16
            - address: 84.1.1.1/16
              secondary: true
          proxy_arp:
            mode: REMOTE_ONLY
        ipv6:
          enabled: true
          dad: ENABLE
          autoconf: true
          addresses:
            - address: 83::1/16
            - address: 84::1/16
            - address: 85::/64
              eui64: true
      - name: Ethernet24
        ipv4:
          addresses:
            - address: 91.1.1.1/16
        ipv6:
          addresses:
            - address: 90::1/16
            - address: 91::1/16
            - address: 92::1/16
            - address: 93::1/16
          nd_proxy:
            mode: REMOTE_ONLY
            nd_proxy_rules:
              - 6001::/24
      - name: Vlan501
        ipv4:
          anycast_addresses:
            - 11.12.13.14/12
        ipv6:
          anycast_addresses:
            - 102::102/64
    state: merged

# After state:
# ------------
#
# sonic# show running-configuration interface
# !
# interface Ethernet20
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 83.1.1.1/16
#  ip address 84.1.1.1/16 secondary
#  ip proxy-arp enable remote-only
#  ipv6 address 83::1/16
#  ipv6 address 84::1/16
#  ipv6 address 85::/64 eui-64
#  ipv6 enable
#  ipv6 address autoconfig
#  ipv6 nd dad enable
# !
# interface Ethernet24
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 91.1.1.1/16
#  ipv6 address 90::1/16
#  ipv6 address 91::1/16
#  ipv6 address 92::1/16
#  ipv6 address 93::1/16
#  ipv6 nd-proxy enable remote-only
#  ipv6 nd-proxy rule prefix 6001::/24
# !
# interface Vlan501
#  ip anycast-address 1.2.3.4/22
#  ip anycast-address 11.12.13.14/12
#  ipv6 anycast-address 101::101/64
#  ipv6 anycast-address 102::102/64
# !

# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show running-configuration interface
# !
# interface Ethernet20
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 83.1.1.1/16
#  ip address 84.1.1.1/16 secondary
#  ipv6 address 83::1/16
#  ipv6 address 84::1/16
#  ipv6 enable
# !
# interface Ethernet24
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 91.1.1.1/16
#  ipv6 address 90::1/16
#  ipv6 address 91::1/16
#  ipv6 address 92::1/16
#  ipv6 address 93::1/16
# !

- name: Replace l3 interface
  dellemc.enterprise_sonic.sonic_l3_interfaces:
    config:
      - name: Ethernet20
        ipv4:
          - address: 81.1.1.1/16
        proxy_arp:
          mode: ALL
    state: replaced

# After state:
# ------------
#
# sonic# show running-configuration interface
# !
# interface Ethernet20
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 81.1.1.1/16
#  ip proxy-arp enable all
# !
# interface Ethernet24
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 91.1.1.1/16
#  ipv6 address 90::1/16
#  ipv6 address 91::1/16
#  ipv6 address 92::1/16
#  ipv6 address 93::1/16
# !

# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show running-configuration interface
# !
# interface Ethernet20
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 83.1.1.1/16
#  ip address 84.1.1.1/16 secondary
#  ip proxy-arp enable all
#  ipv6 address 83::1/16
#  ipv6 address 84::1/16
#  ipv6 enable
#  ipv6 nd-proxy enable remote-only
#  ipv6 nd-proxy rule prefix 6001::/24
# !
# interface Ethernet24
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 91.1.1.1/16
#  ipv6 address 90::1/16
#  ipv6 address 91::1/16
#  ipv6 address 92::1/16
#  ipv6 address 93::1/16
# !

- name: Replace l3 interface
  dellemc.enterprise_sonic.sonic_l3_interfaces:
    config:
      - name: Ethernet20
    state: replaced

# After state:
# ------------
#
# sonic# show running-configuration interface
# !
# interface Ethernet20
#  mtu 9100
#  speed 100000
#  shutdown
# !
# interface Ethernet24
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 91.1.1.1/16
#  ipv6 address 90::1/16
#  ipv6 address 91::1/16
#  ipv6 address 92::1/16
#  ipv6 address 93::1/16
# !

# Using "overridden" state
#
# Before state:
# -------------
#
# sonic# show running-configuration interface
# !
# interface Ethernet20
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 83.1.1.1/16
#  ip address 84.1.1.1/16 secondary
#  ipv6 address 83::1/16
#  ipv6 address 84::1/16
#  ipv6 address 85::/64 eui-64
#  ipv6 enable
#  ipv6 address autoconfig
#  ipv6 nd dad enable
#  ipv6 nd-proxy enable remote-only
#  ipv6 nd-proxy rule prefix 6001::/24
# !
# interface Ethernet24
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 91.1.1.1/16
#  ipv6 address 90::1/16
#  ipv6 address 91::1/16
#  ipv6 address 92::1/16
#  ipv6 address 93::1/16
# !

- name: Override l3 interface
  dellemc.enterprise_sonic.sonic_l3_interfaces:
    config:
      - name: Ethernet24
        ipv4:
          - address: 81.1.1.1/16
        proxy_arp:
          mode: ALL
      - name: Vlan100
        ipv4:
          anycast_addresses:
            - 83.1.1.1/24
            - 85.1.1.12/24
        ipv6:
          anycast_addresses:
            - 83::1/24
            - 85::1/24
          nd_proxy:
            mode: REMOTE_ONLY
            nd_proxy_rules:
              - 6001::/24
    state: overridden

# After state:
# ------------
#
# sonic# show running-configuration interface
# !
# interface Ethernet20
#  mtu 9100
#  speed 100000
#  shutdown
# !
# interface Ethernet24
#  mtu 9100
#  speed 100000
#  shutdown
#  ip address 81.1.1.1/16
#  ip proxy-arp enable all
# !
# interface Vlan100
#  ip anycast-address 83.1.1.1/24
#  ip anycast-address 85.1.1.12/24
#  ipv6 anycast-address 83::1/24
#  ipv6 anycast-address 85::1/24
#  ipv6 nd-proxy enable remote-only
#  ipv6 nd-proxy rule prefix 6001::/24

# !

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

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

Ключ

Описание

after

list / elements=string

Конфигурация, полученная в результате вызова модуля.

Возвращается: при изменении

Пример: ["The configuration returned will always be in the same format as the parameters above.\n"]

after(generated)

list / elements=string

Сгенерированная конфигурация для вызова модуля.

Возвращается: когда check_mode

Пример: ["The configuration returned will always be in the same format as the parameters above.\n"]

before

list / elements=string

Конфигурация до вызова модуля.

Возвращается: всегда

Пример: ["The configuration returned will always be in the same format as the parameters above.\n"]

commands

list / elements=string

Набор команд, отправленных на удалённое устройство.

Возвращается: всегда

Пример: ["command 1", "command 2", "command 3"]

Авторы

  • Kumaraguru Narayanan (@nkumaraguru)

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

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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_l3_interfaces_module.html

Spec-Zone.ru

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