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.

git clone https://github.com/CiscoDevNet/yangsuite

Ensuite, il faut générer un certificat et les identifiants pour votre container (utilisé pour s’y connecter en HTTPS). Cette commande doit être utilisée que la première fois, pour initialiser le container.

cd yangsuite/docker/ ; ./start_yang_suite.sh

Enfin, il faut instancier votre container. C’est prêt !

cd yangsuite/docker/ ; 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

3 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.

    • Bonjour Antoine,

      il n'y a plus le fichier gen_test_certs.sh dans le répertoire pour générer le certificat. est ce normal?

      Merci

      • Bonjour Philippe,

        Dans la dernière mise à jour de YANG Suite, la procédure d'installation a un peu changé. J'ai mis à jour l'article. Dans le doute, se référence à la procédure d'installation du dépot github officiel.

        https://github.com/CiscoDevNet/yangsuite