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/yangsuiteEnsuite, 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.shEnfin, il faut instancier votre container. C’est prêt !
cd yangsuite/docker/ ; docker compose upVous 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
Authors
3 commentaires
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