Note

Ce plugin fait partie de la collection cisco.iosxr (version 1.2.1).

Pour l'installer, utilisez : ansible-galaxy collection install cisco.iosxr.

Pour l'utiliser dans un playbook, spécifiez : cisco.iosxr.iosxr_lag_interfaces.

Nouveau dans la version 1.0.0 : de cisco.iosxr

  • Synopsis
  • Paramètres
  • Notes
  • Exemples
  • Valeurs de retour

Synopsis

  • Ce module gère les attributs des interfaces LAG/Ether-Bundle sur les appareils IOS-XR.

Note

Ce module a un correspondant plugin d'action.

Paramètres

Paramètre Choix/par défaut Commentaires
configliste / elements=dictionnaire Une configuration de groupe d'agrégation de liens (LAG) fournie.
liensdictionnaire Ce dictionnaire contient des options configurables liées aux liens LAG/Ether-Bundle.
max_activenombre entier Spécifie la limite du nombre de liens qui peuvent être actifs dans le LAG/Ether-Bundle.Reportez-vous à la documentation du fournisseur pour les valeurs valides.
min_activenombre entier Spécifie le nombre minimum de liens actifs nécessaires pour faire monter le LAG/Ether-Bundle.Se référer à la documentation du fournisseur pour les valeurs valides.
load_balancing_hashchaîne de caractères
    Choix :

  • dst-ip
  • src-ip
Spécifie la fonction de hachage utilisée pour le trafic transmis sur le LAG/Ether-Bundle.L'option 'dst-ip' utilise l'IP de destination comme fonction de hachage.L'option 'src-ip' utilise l'IP source comme fonction de hachage.
membresliste / elements=dictionnaire Liste des interfaces membres pour le LAG/Ether-Bundle.
membrechaîne de caractères Nom de l'interface membre.
modechaîne de caractères
    Choix :

  • sur
  • actif
  • passif
  • hériter
Spécifie le mode de fonctionnement de l'interface membre.Le mode 'actif' exécute LACP en mode actif.Le mode 'on' n'exécute pas LACP sur le port.Le mode 'passif' exécute LACP en mode passif sur le port.Le mode 'inherit' exécute LACP tel que configuré dans le faisceau.
modechaîne de caractères
    Choix :

  • sur
  • actif
  • passif
Mode LAG.Le mode 'actif' exécute LACP en mode actif sur le port.Le mode 'on' n'exécute pas LACP sur le port.Le mode 'passif' exécute LACP en mode passif sur le port.
nomchaîne de caractères / obligatoire Nom/identifiant du LAG/Ether-Bundle à configurer.
running_configchaîne de caractères Cette option est utilisée uniquement avec l'état analysé.La valeur de cette option doit être la sortie reçue du dispositif IOS-XR en exécutant la commande show running-config int L'état analysé lit la configuration de running_config et la transforme en données structurées Ansible selon l'argspec du module de ressources et la valeur est ensuite retournée dans l'option analysé dans le résultat.
étatchaîne de caractères
    Choix :

  • fusionné
  • a remplacé
  • remplacé
  • supprimé
  • analysé
  • rendu
  • rassemblé
L'état de la configuration après l'achèvement du module.

Notes

Note

  • Testé contre IOS-XR 6.1.3.
  • Ce module fonctionne avec la connexion network_cli. Voir les options de la plate-forme IOS-XR.

Exemples

# Using merged### ------------# Before state# ------------## RP/0/0/CPU0:iosxr01#show run int# Sun Jul  7 19:42:59.416 UTC# interface Loopback888#  description test for ansible#  shutdown# !# interface MgmtEth0/0/CPU0/0#  ipv4 address 192.0.2.11 255.255.255.0# !# interface GigabitEthernet0/0/0/1#  description "GigabitEthernet - 1"# !# interface GigabitEthernet0/0/0/2#  description "GigabitEthernet - 2"# !# interface GigabitEthernet0/0/0/3#  description "GigabitEthernet - 3"# !# interface GigabitEthernet0/0/0/4#  description "GigabitEthernet - 4"# !##-name: Merge provided configuration with device configuration
  cisco.iosxr.iosxr_lag_interfaces:config:-name: Bundle-Ether10
      members:-member: GigabitEthernet0/0/0/1
        mode: inherit
      -member: GigabitEthernet0/0/0/3
        mode: inherit
      mode: active
      links:max_active:5min_active:2load_balancing_hash: src-ip

    -name: Bundle-Ether12
      members:-member: GigabitEthernet0/0/0/2
        mode: passive
      -member: GigabitEthernet0/0/0/4
        mode: passive
      load_balancing_hash: dst-ip
    state: merged
### -----------# After state# -----------## RP/0/0/CPU0:iosxr01#show run int# Sun Jul  7 20:51:17.685 UTC# interface Bundle-Ether10#  lacp mode active#  bundle load-balancing hash src-ip#  bundle maximum-active links 5#  bundle minimum-active links 2# !# interface Bundle-Ether12#  bundle load-balancing hash dst-ip# !# interface Loopback888#  description test for ansible#  shutdown# !# interface MgmtEth0/0/CPU0/0#  ipv4 address 192.0.2.11 255.255.255.0# !# interface GigabitEthernet0/0/0/1#  description 'GigabitEthernet - 1"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/2#  description "GigabitEthernet - 2"#   bundle id 12 mode passive# !# interface GigabitEthernet0/0/0/3#  description "GigabitEthernet - 3"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/4#  description "GigabitEthernet - 4"#  bundle id 12 mode passive# !## Using replaced### -------------# Before state# -------------### RP/0/0/CPU0:iosxr01#sho run int# Sun Jul  7 20:58:06.527 UTC# interface Bundle-Ether10#  lacp mode active#  bundle load-balancing hash src-ip#  bundle maximum-active links 5#  bundle minimum-active links 2# !# interface Bundle-Ether12#  bundle load-balancing hash dst-ip# !# interface Loopback888#  description test for ansible#  shutdown# !# interface MgmtEth0/0/CPU0/0#  ipv4 address 192.0.2.11 255.255.255.0# !# interface GigabitEthernet0/0/0/1#  description 'GigabitEthernet - 1"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/2#  description "GigabitEthernet - 2"#  bundle id 12 mode passive# !# interface GigabitEthernet0/0/0/3#  description "GigabitEthernet - 3"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/4#  description "GigabitEthernet - 4"#  bundle id 12 mode passive# !##-name: Replace device configuration of listed Bundles with provided configurations
  cisco.iosxr.iosxr_lag_interfaces:config:-name: Bundle-Ether12
      members:-name: GigabitEthernet0/0/0/2
      mode: passive

    -name: Bundle-Ether11
      members:-name: GigabitEthernet0/0/0/4
      load_balancing_hash: src-ip
    state: replaced
### -----------# After state# -----------### RP/0/0/CPU0:iosxr01#sh run int# Sun Jul  7 21:22:27.397 UTC# interface Bundle-Ether10#  lacp mode active#  bundle load-balancing hash src-ip#  bundle maximum-active links 5#  bundle minimum-active links 2# !# interface Bundle-Ether11#  bundle load-balancing hash src-ip# !# interface Bundle-Ether12#  lacp mode passive# !# interface Loopback888#  description test for ansible#  shutdown# !# interface MgmtEth0/0/CPU0/0#  ipv4 address 192.0.2.11 255.255.255.0# !# interface GigabitEthernet0/0/0/1#  description 'GigabitEthernet - 1"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/2#  description "GigabitEthernet - 2"#  bundle id 12 mode on# !# interface GigabitEthernet0/0/0/3#  description "GigabitEthernet - 3"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/4#  description "GigabitEthernet - 4"#  bundle id 11 mode on# !### Using overridden### ------------# Before state# ------------### RP/0/0/CPU0:iosxr01#sh run int# Sun Jul  7 21:22:27.397 UTC# interface Bundle-Ether10#  lacp mode active#  bundle load-balancing hash src-ip#  bundle maximum-active links 5#  bundle minimum-active links 2# !# interface Bundle-Ether11#  bundle load-balancing hash src-ip# !# interface Bundle-Ether12#  lacp mode passive# !# interface Loopback888#  description test for ansible#  shutdown# !# interface MgmtEth0/0/CPU0/0#  ipv4 address 192.0.2.11 255.255.255.0# !# interface GigabitEthernet0/0/0/1#  description 'GigabitEthernet - 1"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/2#  description "GigabitEthernet - 2"#  bundle id 12 mode on# !# interface GigabitEthernet0/0/0/3#  description "GigabitEthernet - 3"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/4#  description "GigabitEthernet - 4"#  bundle id 11 mode on# !##-name: Overrides all device configuration with provided configuration
  cisco.iosxr.iosxr_lag_interfaces:config:-name: Bundle-Ether10
      members:-member: GigabitEthernet0/0/0/1
        mode: inherit
      -member: GigabitEthernet0/0/0/2
        mode: inherit
      mode: active
      load_balancing_hash: dst-ip
    state: overridden
### ------------# After state# ------------### RP/0/0/CPU0:iosxr01#sh run int# Sun Jul  7 21:43:04.802 UTC# interface Bundle-Ether10#  lacp mode active#  bundle load-balancing hash dst-ip# !# interface Bundle-Ether11# !# interface Bundle-Ether12# !# interface Loopback888#  description test for ansible#  shutdown# !# interface MgmtEth0/0/CPU0/0#  ipv4 address 192.0.2.11 255.255.255.0# !# interface GigabitEthernet0/0/0/1#  description 'GigabitEthernet - 1"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/2#  description "GigabitEthernet - 2"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/3#  description "GigabitEthernet - 3"# !# interface GigabitEthernet0/0/0/4#  description "GigabitEthernet - 4"# !### Using deleted### ------------# Before state# ------------## RP/0/0/CPU0:iosxr01#sh run int# Sun Jul  7 21:22:27.397 UTC# interface Bundle-Ether10#  lacp mode active#  bundle load-balancing hash src-ip#  bundle maximum-active links 5#  bundle minimum-active links 2# !# interface Bundle-Ether11#  bundle load-balancing hash src-ip# !# interface Bundle-Ether12#  lacp mode passive# !# interface Loopback888#  description test for ansible#  shutdown# !# interface MgmtEth0/0/CPU0/0#  ipv4 address 192.0.2.11 255.255.255.0# !# interface GigabitEthernet0/0/0/1#  description 'GigabitEthernet - 1"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/2#  description "GigabitEthernet - 2"#  bundle id 12 mode on# !n# interface GigabitEthernet0/0/0/3#  description "GigabitEthernet - 3"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/4#  description "GigabitEthernet - 4"#  bundle id 11 mode on# !##-name: Delete attributes of given bundles and removes member interfaces from them
    (Note - This won't delete the bundles themselves)
  cisco.iosxr.iosxr_lag_interfaces:config:-name: Bundle-Ether10
    -name: Bundle-Ether11
    -name: Bundle-Ether12
    state: deleted

### ------------# After state# ------------## RP/0/0/CPU0:iosxr01#sh run int# Sun Jul  7 21:49:50.004 UTC# interface Bundle-Ether10# !# interface Bundle-Ether11# !# interface Bundle-Ether12# !# interface Loopback888#  description test for ansible#  shutdown# !# interface MgmtEth0/0/CPU0/0#  ipv4 address 192.0.2.11 255.255.255.0# !# interface GigabitEthernet0/0/0/1#  description 'GigabitEthernet - 1"# !# interface GigabitEthernet0/0/0/2#  description "GigabitEthernet - 2"# !# interface GigabitEthernet0/0/0/3#  description "GigabitEthernet - 3"# !# interface GigabitEthernet0/0/0/4#  description "GigabitEthernet - 4"# !### Using deleted (without config)### ------------# Before state# ------------## RP/0/0/CPU0:an-iosxr#sh run int# Sun Aug 18 19:49:51.908 UTC# interface Bundle-Ether10#  lacp mode active#  bundle load-balancing hash src-ip#  bundle maximum-active links 10#  bundle minimum-active links 2# !# interface Bundle-Ether11#  bundle load-balancing hash dst-ip# !# interface MgmtEth0/0/CPU0/0#  ipv4 address 192.0.2.11 255.255.255.0# !# interface GigabitEthernet0/0/0/0#  shutdown# !# interface GigabitEthernet0/0/0/1#  bundle id 10 mode inherit#  shutdown# !# interface GigabitEthernet0/0/0/2#  bundle id 10 mode passive#  shutdown# !# interface GigabitEthernet0/0/0/3#  bundle id 11 mode passive#  shutdown# !# interface GigabitEthernet0/0/0/4#  bundle id 11 mode passive#  shutdown# !#-name: Delete attributes of all bundles and removes member interfaces from them (Note
    - This won't delete the bundles themselves)
  cisco.iosxr.iosxr_lag_interfaces:state: deleted

### ------------# After state# ------------### RP/0/0/CPU0:an-iosxr#sh run int# Sun Aug 18 19:54:22.389 UTC# interface Bundle-Ether10# !# interface Bundle-Ether11# !# interface MgmtEth0/0/CPU0/0#  ipv4 address 10.8.38.69 255.255.255.0# !# interface GigabitEthernet0/0/0/0#  shutdown# !# interface GigabitEthernet0/0/0/1#  shutdown# !# interface GigabitEthernet0/0/0/2#  shutdown# !# interface GigabitEthernet0/0/0/3#  shutdown# !# interface GigabitEthernet0/0/0/4#  shutdown# !# Using parsed:# parsed.cfg# interface Bundle-Ether10#  lacp mode active#  bundle load-balancing hash src-ip#  bundle maximum-active links 5#  bundle minimum-active links 2# !# interface Bundle-Ether12#  bundle load-balancing hash dst-ip# !# interface Loopback888#  description test for ansible#  shutdown# !# interface MgmtEth0/0/CPU0/0#  ipv4 address 192.0.2.11 255.255.255.0# !# interface GigabitEthernet0/0/0/1#  description 'GigabitEthernet - 1"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/2#  description "GigabitEthernet - 2"#   bundle id 12 mode passive# !# interface GigabitEthernet0/0/0/3#  description "GigabitEthernet - 3"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/4#  description "GigabitEthernet - 4"#  bundle id 12 mode passive# !#-name: Convert lag interfaces config to argspec without connecting to the appliance
  cisco.iosxr.iosxr_lag_interfaces:running_config:"{{ lookup('file', './parsed.cfg') }}"state: parsed

# --------------# Output# --------------#   parsed:#     - name: Bundle-Ether10#       members:#         - member: GigabitEthernet0/0/0/1#           mode: inherit#         - member: GigabitEthernet0/0/0/3#           mode: inherit#       mode: active#       links:#         max_active: 5#         min_active: 2#       load_balancing_hash: src-ip#     - name: Bundle-Ether12#       members:#         - member: GigabitEthernet0/0/0/2#           mode: passive#         - member: GigabitEthernet0/0/0/4#           mode: passive#       load_balancing_hash: dst-ip# using gathered# Device Config:# -------------# interface Bundle-Ether10#  lacp mode active#  bundle load-balancing hash src-ip#  bundle maximum-active links 5#  bundle minimum-active links 2# !# interface Bundle-Ether12#  bundle load-balancing hash dst-ip# !# interface Loopback888#  description test for ansible#  shutdown# !# interface MgmtEth0/0/CPU0/0#  ipv4 address 192.0.2.11 255.255.255.0# !# interface GigabitEthernet0/0/0/1#  description 'GigabitEthernet - 1"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/2#  description "GigabitEthernet - 2"#   bundle id 12 mode passive# !# interface GigabitEthernet0/0/0/3#  description "GigabitEthernet - 3"#  bundle id 10 mode inherit# !# interface GigabitEthernet0/0/0/4#  description "GigabitEthernet - 4"#  bundle id 12 mode passive# !#-name: Gather IOSXR lag interfaces configuration
  cisco.iosxr.iosxr_lag_interfaces:config:state: gathered

# --------------# Output# --------------#   gathered:#     - name: Bundle-Ether10#       members:#         - member: GigabitEthernet0/0/0/1#           mode: inherit#         - member: GigabitEthernet0/0/0/3#           mode: inherit#       mode: active#       links:#         max_active: 5#         min_active: 2#       load_balancing_hash: src-ip#     - name: Bundle-Ether12#       members:#         - member: GigabitEthernet0/0/0/2#           mode: passive#         - member: GigabitEthernet0/0/0/4#           mode: passive#       load_balancing_hash: dst-ip# Using rendered:-name: Render platform specific commands from task input using rendered state
  cisco.iosxr.iosxr_lag_interfaces:config:-name: Bundle-Ether10
      members:-member: GigabitEthernet0/0/0/1
        mode: inherit
      -member: GigabitEthernet0/0/0/3
        mode: inherit
      mode: active
      links:max_active:5min_active:2load_balancing_hash: src-ip

    -name: Bundle-Ether12
      members:-member: GigabitEthernet0/0/0/2
        mode: passive
      -member: GigabitEthernet0/0/0/4
        mode: passive
      load_balancing_hash: dst-ip
    state: rendered

# Output:# rendered:#    [#         - "interface Bundle-Ether10"#         - " lacp mode active"#         - " bundle load-balancing hash src-ip"#         - " bundle maximum-active links 5"#         - " bundle minimum-active links 2"#         - "interface Bundle-Ether12"#         - " bundle load-balancing hash dst-ip"#         - "interface Loopback888"#         - " description test for ansible"#         - " shutdown"#         - "interface MgmtEth0/0/CPU0/0"#         - " ipv4 address 192.0.2.11 255.255.255.0"#         - "interface GigabitEthernet0/0/0/1"#         - " description 'GigabitEthernet - 1""#         - " bundle id 10 mode inherit"#         - "interface GigabitEthernet0/0/0/2"#         - " description "GigabitEthernet - 2""#         - "  bundle id 12 mode passive"#         - "interface GigabitEthernet0/0/0/3"#         - " description "GigabitEthernet - 3""#         - " bundle id 10 mode inherit"#         - "interface GigabitEthernet0/0/0/4"#         - " description "GigabitEthernet - 4""#         - " bundle id 12 mode passive"#    ]##

Valeurs de retour

Les valeurs de retour courantes sont documentées ici, les champs suivants sont uniques à ce module :

Clé Renvoyé Description
aprèsliste / elements=string when changed La configuration sous forme de données structurées après l'achèvement du module.
Exemple : La configuration retournée sera toujours dans le même format des paramètres ci-dessus.
avantliste / elements=chaîne toujours La configuration sous forme de données structurées avant l'invocation du module.
Exemple : La configuration retournée sera toujours dans le même format des paramètres ci-dessus.
Commandesliste / elements=chaîne toujours L'ensemble des commandes poussées vers le périphérique distant.
Exemple :['interface Bundle-Ether10', 'bundle minimum-active links 2', 'bundle load-balancing hash src-ip']

Auteurs

  • Nilashish Chakraborty (@NilashishC)