Descripción de los módulos YANG que definen la configuración de Junos OS
Juniper Networks publica el esquema de configuración de Junos OS mediante modelos YANG. En la versión 17.3 y anteriores de Junos OS, el esquema de configuración de Junos OS se publica en un solo módulo YANG. A partir de Junos OS versión 17.4R1, el esquema de configuración de Junos OS se publica mediante un módulo de configuración raíz que se complementa con varios módulos más pequeños. Esto permite que los consumidores del esquema solo importen los módulos necesarios para sus tareas.
A partir de Junos OS versión 17.4R1, los módulos YANG de Junos OS usan una nueva convención de nomenclatura para el nombre, el nombre de archivo y el espacio de nombres del módulo. Para obtener más información, consulte Descripción de los módulos JUnos YANG.
El módulo de configuración raíz está compuesto por el nodo de configuración de nivel superior y los nodos que no se emiten como módulos independientes. Los módulos independientes y más pequeños aumentan el módulo de configuración raíz para las diferentes jerarquías de instrucción de configuración. Los módulos de configuración que aumentan el módulo raíz contienen el esquema para el nivel de jerarquía de instrucción de configuración que se indica en el nombre, el nombre de archivo y el espacio de nombres del módulo.
En el siguiente ejemplo, se muestra una parte del módulo que contiene el modelo YANG para la [edit interfaces]
jerarquía:
/* * 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; } ...
Las utilidades yang solo deben importar los módulos necesarios para la tarea de configuración específica que se tenga en cuenta. Como resultado, las herramientas que consumen los módulos de configuración requieren menos tiempo para compilar, validar o realizar otras funciones en los módulos que cuando importan un solo módulo de gran tamaño.
Para determinar el módulo YANG de configuración que corresponde a un área específica de la configuración, emita el comando de modo de show | display detail
configuración. En el ejemplo siguiente, el esquema para el [edit protocols ospf]
nivel de jerarquía se incluye en el módulo 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 ## ...
Puede descargar los módulos yang de Junos OS desde el sitio de descargas de Juniper Networks o el depósito de GitHub de Juniper Networks para YANG, o puede generar los módulos en el dispositivo local. Para generar los módulos de configuración en el dispositivo local, emita el show system schema format yang module module
comando. La versión de Junos OS determina las opciones de comando disponibles.
-
En junos OS versión 17.3 y anteriores, especifique el
configuration
módulo.user@host> show system schema format yang module configuration
-
En junos OS versión 17.4 y posteriores, especifique un nombre de módulo individual para devolver un único módulo de configuración o especifique
all-conf
que devuelva todos los módulos de configuración.user@host> show system schema format yang module all-conf output-directory /var/tmp/yang
A partir de Junos OS versión 19.1R2 y 19.2R1, el
show system schema
comando debe incluir laoutput-directory
opción de comando y especificar el directorio en el que se generará el archivo o archivos. En versiones anteriores, puede omitir laoutput-directory
opción al solicitar un solo módulo para mostrarlo en la salida estándar.
Para generar los módulos desde una sesión remota, ejecute la <get-yang-schema>
operación RPC de Junos OS o el <get-schema>
Protocolo de configuración de red (NETCONF) con las opciones adecuadas.
Si especifica module configuration
o module all-conf
, los archivos de salida incluyen tanto módulos de configuración nativos de Junos OS como cualquier módulo de configuración estándar o personalizado que se haya agregado al dispositivo.
A partir de Junos OS versión 17.4R1, los módulos YANG nativos generados en un dispositivo local contienen esquemas específicos de la familia, que son idénticos en todos los dispositivos de la familia de dispositivos dada. En versiones anteriores, los módulos generados contienen esquemas específicos del dispositivo. Para generar módulos específicos del dispositivo en la versión 17.4R1 y posteriores de Junos OS, configure la device-specific
instrucción de configuración en el [edit system services netconf yang-modules]
nivel de jerarquía.
show system schema
comando debe incluir la
output-directory
opción de comando y especificar el directorio en el que se generará el archivo o archivos.