Comprendre les modules YANG qui définissent la configuration junos OS
Juniper Networks publie le schéma de configuration Junos OS à l’aide de modèles YANG. Dans junos OS version 17.3 et versions antérieures, le schéma de configuration de Junos OS est publié dans un seul module YANG. À partir de la version 17.4R1 de Junos OS, le schéma de configuration de Junos OS est publié à l’aide d’un module de configuration racine complété par plusieurs modules plus petits. Cela permet aux utilisateurs du schéma d’importer uniquement les modules nécessaires à leurs tâches.
À partir de la version 17.4R1 de Junos OS, les modules Yang de Junos OS utilisent une nouvelle convention de nommage pour le nom, le nom et l’espace de noms du module. Pour plus d’informations, voir Comprendre les modules YANG Junos.
Le module de configuration racine comprend le nœud de configuration de niveau supérieur et tous les nœuds qui ne sont pas émis en tant que modules distincts. Des modules plus petits et distincts viennent compléter le module de configuration racine pour les différentes hiérarchies d’énoncés de configuration. Les modules de configuration qui augmentent le module racine contiennent le schéma pour le niveau hiérarchique des déclarations de configuration, indiqué dans le nom, le nom et l’espace de noms du module.
L’exemple suivant montre une partie du module contenant le modèle YANG pour la [edit interfaces]
hiérarchie :
/* * Copyright (c) 2017 Juniper Networks, Inc. * All rights reserved. */ module junos-conf-interfaces { namespace "http://yang.juniper.net/junos/conf/interfaces"; prefix jc-interfaces; import junos-common-types { prefix jt; } import junos-conf-root { prefix jc; } organization "Juniper Networks, Inc."; contact "yang-support@juniper.net"; description "Junos interfaces configuration module"; revision 2017-01-01 { description "Junos: 17.4R1.17"; } augment /jc:configuration { uses interfaces-group; } augment /jc:configuration/jc:groups { uses interfaces-group; } ...
Les services publics YANG doivent importer uniquement les modules nécessaires à la tâche de configuration spécifique en cours. En conséquence, les outils qui utilisent les modules de configuration nécessitent moins de temps pour compiler, valider ou exécuter d’autres fonctions sur les modules que lorsqu’ils importent un seul et grand module.
Pour déterminer le module YANG de configuration correspondant à une zone spécifique de la configuration, commandez le show | display detail
mode de configuration. Dans l’exemple suivant, le schéma pour le [edit protocols ospf]
niveau hiérarchique est inclus dans le module junos-conf-protocols@2017-01-01.yang .
user@host# show protocols ospf | display detail ## ## ospf: OSPF configuration ## YANG module: junos-conf-protocols@2017-01-01.yang ## lsa-refresh-interval: LSA refresh interval (minutes) ## range: 25 .. 50 ## ## default: 50 ## ...
Vous pouvez télécharger les modules YANG Junos OS à partir du site de téléchargement Juniper Networks ou du référentiel Juniper Networks GitHub pour YANG, ou vous pouvez générer les modules sur l’équipement local. Pour générer les modules de configuration sur l’équipement local, émettez la show system schema format yang module module
commande. La version Junos OS détermine les options de commande disponibles.
-
Dans Junos OS version 17.3 et versions antérieures, spécifiez le
configuration
module.user@host> show system schema format yang module configuration
-
Dans junos OS version 17.4 et versions ultérieures, spécifiez un nom de module individuel pour renvoyer un seul module de configuration, ou spécifiez
all-conf
de renvoyer tous les modules de configuration.user@host> show system schema format yang module all-conf output-directory /var/tmp/yang
À partir des versions 19.1R2 et 19.2R1 de Junos OS, la
show system schema
commande doit inclure l’optionoutput-directory
de commande et spécifier le répertoire dans lequel générer le ou les fichiers. Dans les versions précédentes, vous pouvez omettre l’option lors de laoutput-directory
demande d’un seul module d’afficher le module en sortie standard.
Pour générer les modules à partir d’une session distante, exécutez l’opération <get-yang-schema>
JUNOs OS RPC ou <get-schema>
NETCONF (Network Configuration Protocol) avec les options appropriées.
Si vous spécifiez module configuration
ou module all-conf
, les fichiers de sortie comprennent à la fois des modules de configuration Junos OS natifs ainsi que tous les modules de configuration standard ou personnalisés qui ont été ajoutés à l’équipement.
À partir de la version 17.4R1 de Junos OS, les modules YANG natifs générés sur un équipement local contiennent des schémas spécifiques à la famille, qui sont identiques sur tous les équipements de la famille d’équipements donnée. Dans les versions précédentes, les modules générés contiennent des schémas spécifiques aux équipements. Pour générer des modules spécifiques à un équipement dans Junos OS version 17.4R1 et versions ultérieures, configurez l’instruction de device-specific
configuration au niveau de la [edit system services netconf yang-modules]
hiérarchie.
show system schema
commande doit inclure l’option
output-directory
de commande et spécifier le répertoire dans lequel générer le ou les fichiers.