Entendendo os módulos YANG do Junos

Visão geral dos módulos Junos YANG

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

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. Além disso, os módulos JUNOS YANG nativos usam uma nova convenção de nomenclatura para nome, nome de arquivo e namespace do módulo. O nome do módulo e o nome do arquivo incluem a família de dispositivos e a área da configuração ou hierarquia de comando à qual o esquema no módulo pertence. O nome do arquivo do módulo também 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.

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 de arquivo 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 Baixar e gerar módulos YANG do Junos.

Para obter informações sobre os namespaces do módulo, consulte Understanding Junos YANG Module Namespaces and Prefixes.

Baixe e gere módulos YANG do Junos

Você pode recuperar os módulos JUNOS OS e Junos OS Evolved YANG por:

• Baixar os módulos do site da Juniper Networks em https://www.juniper.net/support/downloads

• Baixar os módulos do repositório Juniper/yang GitHub

• Gerando os módulos em um dispositivo da Juniper Networks

No Junos OS Release 17.1 e anteriores, os módulos YANG para a configuração e as hierarquias de 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. O esquema específico do dispositivo inclui nós tanto de módulos nativos quanto de quaisquer módulos padrão ou personalizados que foram 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 pacote de download e o repositório do GitHub incluem um diretório separado para os 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 para esse 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, que são idênticos em todos os dispositivos da família de dispositivos. Para gerar módulos específicos do dispositivo, configure a declaração de device-specific 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.

A partir do Junos OS Evolved Release 23.4R1, publicamos os módulos YANG do Junos OS Evolved no site de download da Juniper Networks e no GitHub. Em versões anteriores, você deve gerar os módulos no dispositivo.

Além disso, a partir do Junos OS Release 23.4R1 e junos OS Evolved Release 23.4R1, fornecemos todos os modelos de dados YANG para um determinado SO e versão em um único pacote de download e pasta de repositório GitHub. A pasta de pacotes e repositórios inclui:

• Modelos de dados nativos de configuração, estado e RPC

• Configuração do OpenConfig e modelos de estado suportados por esse OS

• Modelos IETF suportados por esse OS

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

Entendendo os namespaces e 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 string de versão 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 para cada módulo e que diferencia o namespace do módulo do de outros módulos.

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

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 que está incluída nesse módulo. Os módulos de extensão e tipo Junos YANG 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.

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