Comprendre les modules Junos YANG

Présentation des modules YANG Junos

Juniper Networks fournit des modules YANG qui définissent les hiérarchies de configuration, les commandes opérationnelles et les données d’état, ainsi que les extensions et les types YANG, pour les équipements exécutant Junos OS et les équipements exécutant Junos OS Evolved. À partir de Junos OS version 17.2, les modules YANG sont spécifiques à une famille de périphériques. Le tableau 1 présente les identificateurs des différentes familles d’appareils et indique les plates-formes incluses dans chaque famille. À partir de Junos OS Evolved version 23.4R2, toutes les plates-formes Junos OS Evolved utilisent l’identificateur de famille de junos périphériques.

À partir de Junos OS version 17.4R1, le module YANG de configuration est scindé en un module racine auquel s’ajoutent plusieurs modules plus petits. De plus, les modules Junos YANG natifs utilisent une nouvelle convention de nommage pour le nom, le nom de fichier et l'espace de noms du module. Le nom du module et le nom de fichier incluent la famille de périphériques et la zone de la hiérarchie de configuration ou de commande à laquelle appartient le schéma du module. Le nom de fichier du module inclut également une date de révision. Le Tableau 2 récapitule les modules YANG natifs des équipements Junos et identifie la version dans laquelle les différents noms de modules sont utilisés.

Pour prendre en charge les modules YANG pour différentes familles de périphériques dans différentes versions, les modules téléchargés sont organisés par famille de périphériques, et le nom, le nom de fichier et l’espace de noms de chaque module reflètent la famille de périphériques à laquelle appartient le schéma du module.

Pour plus d’informations sur l’obtention des modules, reportez-vous à la section Téléchargement et génération de modules Junos YANG.

Pour plus d’informations sur les espaces de noms de module, reportez-vous à la section Présentation des espaces de noms et des préfixes des modules Junos YANG.

Télécharger et générer des modules Junos YANG

Vous pouvez récupérer les modules Junos OS et Junos OS Evolved YANG en :

• Téléchargement des modules sur le site Juniper Networks à l’adresse https://www.juniper.net/support/downloads

• Téléchargement des modules depuis le dépôt GitHub Juniper/yang

• Génération des modules sur un équipement Juniper Networks

Dans Junos OS version 17.1 et antérieure, les modules YANG pour la configuration de Junos OS et les hiérarchies de commandes qui sont publiés sur le site Web de Juniper Networks et dans GitHub définissent le schéma pour tous les périphériques exécutant cette version de Junos OS. En revanche, les modules YANG générés sur l’appareil local définissent le schéma spécifique à cet appareil. Le schéma spécifique à l’appareil inclut les nœuds à la fois des modules natifs et de tous les modules standard ou personnalisés qui ont été ajoutés à l’appareil.

À partir de Junos OS version 17.2, les modules Junos YANG sont spécifiques à une famille de périphériques et l’espace de noms de chaque module reflète la famille de périphériques à laquelle appartient le schéma du module. Par conséquent, le package de téléchargement et le référentiel GitHub incluent un répertoire distinct pour les modules de chaque famille d’appareils et un répertoire commun pour les modules communs à toutes les familles d’appareils. Chaque répertoire spécifique à une famille utilise son identificateur de famille de périphériques comme nom de répertoire et contient les modules de configuration et de commande opérationnelle qui sont pris en charge sur les plates-formes de cette famille. Les identificateurs de la famille d’appareils sont définis dans le Tableau 1. Les modules YANG générés sur un équipement local exécutant Junos OS version 17.2 définissent toujours le schéma spécifique à cet équipement.

À partir de Junos OS version 17.4R1, les modules YANG générés sur un périphérique local contiennent par défaut des schémas spécifiques à la famille, identiques sur tous les périphériques de la famille de périphériques donnée. Pour générer des modules spécifiques à l’appareil, configurez l’instruction de device-specific configuration au niveau de la [edit system services netconf yang-modules] hiérarchie.

Le Tableau 3 récapitule l’étendue du schéma dans les modules YANG téléchargés et générés pour différentes versions de Junos OS.

À partir de Junos OS Evolved version 23.4R1, nous publions les modules YANG de Junos OS Evolved sur le site de téléchargement Juniper Networks et sur GitHub. Dans les versions antérieures, vous devez générer les modules sur l’appareil.

En outre, à partir de Junos OS version 23.4R1 et Junos OS evolved version 23.4R1, nous fournissons tous les modèles de données YANG pour un système d’exploitation et une version donnés dans un package de téléchargement unique et un dossier de référentiel GitHub. Le dossier du package et du référentiel comprend :

• Modèles de données de configuration, d’état et RPC natifs

• Configuration OpenConfig et modèles d’état pris en charge par le système d’exploitation

• Modèles IETF pris en charge par ce système d’exploitation

Pour plus d’informations sur le téléchargement ou la génération des modules YANG de Junos OS, consultez Utiliser les modules YANG de Juniper Networks.

Présentation des espaces de noms et des préfixes des modules Junos YANG

Dans Junos OS version 17.1 et antérieure, les modules Junos YANG utilisent un identificateur unique pour différencier l’espace de noms de chaque module.

À partir de Junos OS version 17.2R1, les modules Junos YANG sont spécifiques à une famille de périphériques. Pour prendre en charge des modules YANG distincts pour différentes familles de périphériques dans une version donnée, les modules YANG utilisent un espace de noms qui inclut le nom du module, la famille de périphériques et la chaîne de version Junos OS, en plus de l’identifiant. Par exemple:

À partir de Junos OS version 17.4R1, l’espace de noms est simplifié pour inclure la famille de périphériques, le type de module et un identificateur unique à chaque module qui différencie l’espace de noms du module de celui des autres modules.

Les définitions suivantes s’appliquent à toutes les versions de l’espace de noms dans lequel cette variable apparaît :

Le Tableau 4 présente l’URI et le préfixe de l’espace de noms de chaque module (tels que définis par l’instruction du prefix module) dans les différentes versions. À partir de Junos OS version 17.2, le préfixe de chaque module de commande opérationnelle reflète la zone hiérarchique des commandes RPC incluses dans ce module. De même, à partir de Junos OS version 17.4R1, le préfixe de chaque module YANG de configuration reflète la hiérarchie des instructions de configuration incluse dans ce module. Les modules d’extension et de type Junos YANG utilisent l’identificateur de famille de junos périphériques dans l’espace de noms, mais les modules sont communs à toutes les familles de périphériques.

À partir de Junos OS version 17.2, lorsque vous configurez l’instruction rfc-compliant au niveau de la [edit system services netconf] hiérarchie et demandez des données de configuration dans une session NETCONF, le serveur définit l’espace de noms par défaut de l’élément <configuration> sur le même espace de noms que dans le modèle YANG correspondant. Par exemple: