Cisco France Blog
Partager

YANG Suite, l’attente est finie !


4 February 2021


Vous avez peut-être vu l’annonce sur les réseaux sociaux : YANG Suite est enfin disponible pour tous et gratuitement ! Mais qu’est ce que YANG Suite ? Bonne question ! Il s’agit d’un ensemble d’outils, mis à disposition sous la forme d’un container Docker, permettant d’explorer et de jouer avec les modèles YANG de vos équipements (IOS XE, IOS XR, NXOS…). Vous n’avez pas d’équipements sous la main ? Pas grave, vous pouvez aussi importer un modèle YANG directement.

Installation de YANG Suite

Rien de plus simple, il faut cloner le depot GitHub avec le code, générer un certificat pour votre container (utilisé pour s’y connecter en HTTPS), et instancier votre container.

git clone https://github.com/CiscoDevNet/yangsuite
cd yangsuite/docker/ ; ./gen_test_certs.sh
docker-compose up

Vous pouvez accéder à YANG Suite, en allant sur l’URL : https://localhost/. Si vous avez généré un certificat avec la deuxième commande ci-dessus, il se peut que votre navigateur affiche un avertissement. Vous pouvez l’ignorer.

Par défaut, les identifiants de connection sont ci-dessous. Vous pouvez les changer dans le fichier docker-compose.yml (lignes 13 et 15). Je vous recommande fortement de les changer.

username : admin
password : superuser

La documentation complète pour l’installation de YANG Suite est disponible ici.

Utilisation de YANG Suite

Vous ne savez pas par où commencer ? Pas d’inquiétude, ce Learning Lab Devnet vous permettra de faire le tour de YANG Suite. Voyons ci-dessous un aperçu de ses possibilités !

Récupérer les modèles YANG supportés par un équipement

Premièrement, il est possible de récupérer les modèles YANG supportés par un équipement. Fini de vous poser la question “est-ce que mon équipement supporte tel ou tel modèle ?”. Demandez-lui !

A noter qu’il est également possible d’importer une liste de modèle depuis un repo Git. Par exemple, le repo GitHub officiel avec l’ensemble des modèles supportés pour chaque OS, pour chaque version.

Comprendre les dépendances d’un modèle YANG

Un modèle YANG est rarement auto-suffisant. C’est à dire qu’il est souvent décrit en partie dans d’autres modèles YANG. Les YANG module sets vous permettront de rapidement identifier les dépendances d’un modèle, vous permettant ensuite de le manipuler et de l’explorer pleinement.

Explorer un modèle YANG

Évidemment, il est possible d’explorer un modèle YANG avec YANG Suite. Il est possible d’observer les différents éléments qui composent un modèle (ses leafs, ses containers…). Dit autrement, en l’explorant, il vous est rapidement possible de savoir si c’est le bon modèle que vous cherchiez pour récupérer telle et/ou telle information(s) ; comme par exemple le nom, l’adresse IPv6 et la description d’une interface.

Construire ses appels NETCONF

Le meilleur pour la fin ! Il est également possible avec YANG Suite de construire vos messages NETCONF. C’est à dire qu’il vous est possible de filtrer les informations que vous voulez récupérer (exemple : uniquement le nom, l’adresse IPv6 et la description des interfaces), et YANG Suite construira pour vous le bon RPC. Le bon filtre, si vous préférez. Ce n’est pas tout, vous pourrez même envoyer ce message à votre équipement et récupérer le résultat. Oui ! Directement YANG Suite !

Conclusion

En conclusion, YANG Suite est un ensemble d’outils, mis à disposition sous la forme d’un container Docker, permettant d’explorer et de jouer avec les modèles YANG de vos équipements (IOS XE, IOS XR, NXOS…). Il permet par exemple de :

  • Récupérer les modèles YANG supportés par un équipement,
  • Comprendre les dépendances d’un modèle YANG,
  • Explorer un modèle YANG,
  • Construire ses appels NETCONF.

Convaincu ? Qu’attendez-vous pour essayer ?!

Liens utiles

Le Learning Lab (pour vous lancer pas à pas) : https://developer.cisco.com/learning/lab/intro-yangsuite/step/1

Le site officiel : https://developer.cisco.com/yangsuite/

La documentation : https://developer.cisco.com/docs/yangsuite/

Le repo (pour télécharger YANG Suite) : https://github.com/CiscoDevNet/yangsuite/

L’espace Webex (pour rejoindre et échanger avec la communauté) : https://eurl.io/#MaW78CelS

 

Tags:
Laisser un commentaire

1 commentaires

  1. Merci Antoine pour cet excellent article! J'utilise depuis longtemps et je suis content de voir que nos clients et partenaires pourront en profiter aussi!

    Le modèle Cisco-IOS-XE-native est une façon simple de démarrer en IOS-XE pour pouvoir modéliser toute la configuration d'un coup sans avoir à aller chercher tous les modèles nécessaires.