Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Entender os módulos Junos YANG

A Juniper Networks publica o esquema de dispositivos Junos usando modelos YANG para as hierarquias de configuração, comandos operacionais e extensões Junos. As seções a seguir discutem os módulos JUNOS YANG nativos.

Visão geral dos módulos Junos YANG

A Juniper Networks fornece módulos YANG que definem as hierarquias de configuração e os comandos operacionais, bem como extensões e tipos YANG, para dispositivos Junos. A partir do Junos OS Release 17.2, os módulos Junos YANG são específicos para uma família de dispositivos. A Tabela 1 descreve os identificadores para as diferentes famílias de dispositivos Junos e indica quais plataformas estão incluídas em cada família.

Tabela 1: Famílias de dispositivos Junos

Identificador da família de dispositivos

Plataformas suportadas

Junos

Série ACX, Série EX (determinadas plataformas), Série MX, Série PTX

junos-es

Série J, Série LN, Série SRX

junos-ex

Série EX (determinadas plataformas)

junos-qfx

Série QFX

Nota:

Plataformas diferentes dentro da mesma série podem ser categorizadas em diferentes famílias de dispositivos. Você pode verificar a família em busca de um dispositivo específico executando o comando de show system information modo operacional ou o <get-system-information/> RPC no dispositivo. O valor do campo na saída de Family comando ou no <os-name> elemento na resposta ao RPC indica a família do dispositivo.

A partir do Junos OS Release 17.4R1, o módulo YANG de configuração é dividido em um módulo raiz que é aumentado por vários módulos menores, e os módulos Junos YANG nativos usam uma nova convenção de nomeação para o nome, nome e namespace do módulo. O nome e o nome do arquivo do módulo incluem a família de dispositivos e a área da hierarquia de configuração ou comando a que o esquema no módulo pertence. Além disso, o nome do arquivo do módulo inclui uma data de revisão. A Tabela 2 resume os módulos YANG nativos dos dispositivos Junos e identifica a versão em que os diferentes nomes dos módulos são usados.

Tabela 2: Módulos YANG nativos da Juniper Networks

Módulo Junos YANG

Descrição

Nome do módulo

Libera

Módulos de configuração

Define o esquema para a hierarquia de configuração do Junos.

A partir do Junos OS Release 17.4R1, o módulo YANG de configuração é dividido em um módulo raiz que é aumentado por vários módulos menores.

configuration

14,2 a 17,3

family-conf-hierarchy

17.4R1 e posterior

Módulos de comando operacionais

Representa a hierarquia de comando operacional e o grupo coletivo de módulos que definem as chamadas de procedimento remoto (RPCs) para comandos de modo operacional. Existem módulos separados para as diferentes áreas da hierarquia de comando.

juniper-command

16,1 a 17,3

family-rpc-hierarchy

17.4R1 e posterior

Módulo de extensões DDL

Contém declarações da Linguagem de Definição de Dados (DDL) para dispositivos Junos.

Este módulo inclui as must palavras-chave e must-message as palavras-chave, que identificam restrições de hierarquia de configuração que usam palavras-chave especiais. O módulo também inclui declarações necessárias em RPCs personalizados.

junos-extension

15,1 a 17,3

junos-common-ddl-extensions

17.4R1 e posterior

Módulo de extensões ODL

Contém declarações de linguagem de definição de saída (ODL) que podem ser usadas para criar e personalizar a saída ASCII formatada para RPCs executados em dispositivos Junos.

junos-extension-odl

16,1 a 17,3

junos-common-odl-extensions

17.4R1 e posterior

Módulo de extensões de extensões de anotação de metadados

Define anotações de metadados para operações de configuração.

As anotações são definidas no RFC 7952, definindo e usando metadados com YANG.

junos-configuration-metadata

22.2R1 e posterior (Junos OS Evolved)

Módulo de tipos

Contém definições para tipos YANG

junos-common-types

17.4R1 e posterior

Para oferecer suporte a módulos YANG para diferentes famílias de dispositivos em diferentes versões, os módulos baixados são organizados pela família de dispositivos, e o nome, nome e namespace de cada módulo reflete a família de dispositivos à qual o esquema no módulo pertence. Para obter informações sobre a obtenção dos módulos, consulte o download e a geração de módulos Junos YANG. Para obter informações sobre os namespaces do módulo, consulte Understanding Junos YANG Module Namespaces and Prefixes.

Download e geração de módulos Junos YANG

Você pode recuperar os módulos Junos YANG por:

No Junos OS Release 17.1 e anterior, os módulos YANG para as hierarquias de configuração e comando do Junos OS que são publicados no site da Juniper Networks e no GitHub definem o esquema para todos os dispositivos em execução que o Junos OS lança. Por outro lado, os módulos YANG gerados no dispositivo local definem o esquema específico para esse dispositivo, incluindo nós tanto de módulos nativos quanto de quaisquer módulos padrão ou personalizados que tenham sido adicionados ao dispositivo.

A partir do Junos OS Release 17.2, os módulos Junos YANG são específicos para uma família de dispositivos e o namespace de cada módulo reflete a família de dispositivos à qual o esquema no módulo pertence. Como resultado, o arquivo de piche publicado no site da Juniper Networks e que contém os módulos YANG para uma determinada versão inclui um diretório separado para módulos de cada família de dispositivos e um diretório comum para os módulos que são comuns a todas as famílias de dispositivos. Cada diretório específico da família usa o identificador da família de dispositivos como nome do diretório e contém os módulos de configuração e comando operacional que são suportados nas plataformas dessa família. Os identificadores da família de dispositivos são definidos na Tabela 1. Os módulos YANG gerados em um dispositivo local que executa o Junos OS Release 17.2 ainda definem o esquema específico desse dispositivo.

A partir do Junos OS Release 17.4R1, os módulos YANG gerados em um dispositivo local, por padrão, contêm esquemas específicos da família, idênticos em todos os dispositivos da família de dispositivos. Para gerar módulos específicos do dispositivo, configure a device-specific declaração de configuração no nível de [edit system services netconf yang-modules] hierarquia.

A Tabela 3 resume o escopo do esquema nos módulos YANG baixados e gerados para diferentes versões do Junos OS.

Tabela 3: Escopo do Junos OS YANG Schema

Versão do Junos OS

Escopo do schema em módulos baixados

Escopo do esquema em módulos gerados

17.1 e anterior

Todos os dispositivos

Dispositivo

17,2 a 17,3

Família de dispositivos

Dispositivo

17.4R1 e posterior

Família de dispositivos

Família de dispositivos

Para obter mais informações sobre como baixar ou gerar os módulos YANG do Junos OS, consulte os módulos YANG da Juniper Networks.

Entender os espaços de nome e os prefixos do módulo Junos YANG

No Junos OS Release 17.1 e anterior, os módulos Junos YANG usam um identificador exclusivo para diferenciar o namespace para cada módulo.

A partir do Junos OS Release 17.2R1, os módulos Junos YANG são específicos para uma família de dispositivos. Para oferecer suporte a módulos YANG distintos para diferentes famílias de dispositivos em uma determinada versão, os módulos YANG usam um namespace que inclui o nome do módulo, a família de dispositivos e a cadeia de lançamento do Junos OS, além do identificador. Por exemplo:

A partir do Junos OS Release 17.4R1, o namespace é simplificado para incluir a família de dispositivos, o tipo de módulo e um identificador exclusivo de cada módulo e que diferencia o espaço de nome do módulo do de outros módulos.

As definições a seguir aplicam-se a todas as versões do namespace em que essa variável aparece:

device-family

Identificador para a família de dispositivos à qual o esquema no módulo pertence, por exemplo,junosjunos-es, junos-exoujunos-qfx. As diferentes famílias de dispositivos estão descritas na Tabela 1.

Módulos com esquemas e módulos específicos de dispositivos com esquemas específicos da família usam o mesmo identificador da família de dispositivos no namespace.

Nota:

Os módulos comuns usam o identificador da junos família de dispositivos no namespace, mas os módulos são comuns a todas as famílias de dispositivos.

identifier

String que diferencia o espaço de nome do módulo do de outros módulos.

A configuração e os módulos de comando junos incluem um identificador que indica a área da configuração ou hierarquia de comando à qual o esquema no módulo pertence. Módulos comuns usam o diferencial de nome do módulo como identificador, por exemplo odl-extensions.

module-id

Identificador exclusivo específico do módulo, por exemplo, jcjrpcjeou.jodl

module-name

Nome do módulo YANG incluído nesse arquivo, por exemplo, configuration ou junos-extension. Cada um dos módulos individuais juniper-command usa seu próprio nome de módulo exclusivo no namespace, por exemplo, show-class-of-service.

release

Junos OS ou Junos OS Evolved versão em que o esquema nesse módulo é suportado.

type

Tipo de módulo. Os valores possíveis incluem:

  • conf— Módulo YANG de configuração que define o esquema para a área indicada da configuração.

  • rpc— módulo YANG de comando operacional que define os RPCs para comandos operacionais na área indicada da hierarquia de comando.

  • common— Módulo de extensão ou tipo que é comum em todas as famílias de dispositivos.

A Tabela 4 descreve o namespace URI e o prefixo de cada módulo (conforme definido pela declaração do prefix módulo) nas diferentes versões. A partir do Junos OS Release 17.2, o prefixo para cada módulo de comando operacional reflete a área de hierarquia de comando dos RPCs incluídos nesse módulo. Da mesma forma, a partir do Junos OS Release 17.4R1, o prefixo para cada módulo YANG de configuração reflete a hierarquia de declaração de configuração incluída nesse módulo. Os módulos de extensão e tipo Junos YANG usam o junos identificador da família de dispositivos no namespace, mas os módulos são comuns a todas as famílias de dispositivos.

Tabela 4: namespaces e prefixos para módulos Junos YANG

Módulo YANG

Lançamento

Namespace URI

Prefixo

Módulos de configuração

17.1 e anterior

http://yang.juniper.net/yang/1.1/jc

jc

17,2 a 17,3

http://yang.juniper.net/yang/1.1/jc/configuration/device-family/release

jc

17.4R1 e posterior

http://yang.juniper.net/device-family/conf/hierarchy

jc(módulo raiz)

jc-hierarchy

Módulos de comando operacionais

17.1 e anterior

http://yang.juniper.net/yang/1.1/jrpc

jrpc

17,2 a 17,3

http://yang.juniper.net/yang/1.1/jrpc/module-name/device-family/release

hierarchy

17.4R1 e posterior

http://yang.juniper.net/device-family/rpc/hierarchy

hierarchy

Módulo de extensões DDL

17.1 e anterior

http://yang.juniper.net/yang/1.1/je/

junos

17,2 e depois

http://yang.juniper.net/yang/1.1/je/junos-extension/junos/release

junos

17.4R1 e posterior

http://yang.juniper.net/junos/common/ddl-extensions

junos

Módulo de extensões ODL

17.1 e anterior

http://yang.juniper.net/yang/1.1/jodl

junos-odl

17,2 a 17,3

http://yang.juniper.net/yang/1.1/jodl/junos-extension-odl/junos/release

junos-odl

17.4R1 e posterior

http://yang.juniper.net/junos/common/odl-extensions

junos-odl

Módulo de extensões de extensões de anotação de metadados

22.2R1 e posterior

http://yang.juniper.net/junos/jcmd jcmd

Módulo de tipos

17.4R1 e posterior

http://yang.juniper.net/junos/common/types

jt

Começando pelo Junos OS Release 17.2, quando você configura a rfc-compliant declaração no nível da [edit system services netconf] hierarquia e solicita dados de configuração em uma sessão NETCONF, o servidor define o espaço de nome padrão para o <configuration> elemento no mesmo espaço de nome que no modelo YANG correspondente. Por exemplo:

Tabela de histórico de lançamento
Lançamento
Descrição
22.4R1 e 22.4R1-EVO
A partir do Junos OS Release 22.4R1 e do Junos OS Evolved Release 22.4R1, os módulos YANG que definem RPCs incluem a junos:command declaração de extensão em esquemas emitidos com extensões.
17.4R1
A partir do Junos OS Release 17.4R1, o módulo YANG de configuração é dividido em um módulo raiz que é aumentado por vários módulos menores, e os módulos NATIVOs Junos OS YANG usam uma nova convenção de nomeação para o nome, nome e namespace do módulo.
17.4R1
A partir do Junos OS Release 17.4R1, os módulos YANG gerados em um dispositivo local, por padrão, contêm esquemas específicos da família, idênticos em todos os dispositivos da família de dispositivos.
17.2R1
A partir do Junos OS Release 17.2, os módulos Junos OS YANG são específicos para uma família de dispositivos e o namespace de cada módulo reflete a família de dispositivos à qual o esquema no módulo pertence.
17.2R1
A partir do Junos OS Release 17.2, o prefixo para cada módulo de comando operacional reflete a área de hierarquia de comando dos RPCs incluídos nesse módulo.