Desenvolvimento de Módulos YANG

Introdução

Antes de começar:

sudo apt update && sudo apt install procps -y && sudo apt install libyang-tools -y

O que você irá aprender

Neste laboratório, você irá desenvolver competências práticas fundamentais para trabalhar com YANG (Yet Another Next Generation), a linguagem de modelagem de dados padrão para configuração e gerenciamento de dispositivos de rede.

Objetivos de Aprendizado

Ao concluir este laboratório, você será capaz de:

1. Compreender a estrutura de módulos YANG

   • Entender a sintaxe e semântica da linguagem YANG
   • Conhecer os principais elementos: containers, lists, leafs e leaf-lists
   • Trabalhar com namespaces, prefixos e imports

2. Desenvolver módulos YANG do zero

   • Criar módulos YANG para modelar interfaces de rede
   • Implementar configurações IPv4 em interfaces
   • Modelar dispositivos de rede complexos com ACLs
   • Diferenciar dados de configuração (read-write) de dados operacionais (read-only)

3. Validar e testar módulos YANG

   • Utilizar ferramentas de validação como pyang e yanglint
   • Interpretar saídas em formato de árvore
   • Identificar e corrigir erros de sintaxe e estrutura

4. Trabalhar com dados de instância

   • Criar arquivos de dados em JSON e YAML compatíveis com módulos YANG
   • Validar dados de instância contra schemas YANG
   • Converter entre diferentes formatos de dados

5. Estender módulos existentes

   • Utilizar o comando augment para adicionar funcionalidades
   • Implementar extensões condicionais com when
   • Criar módulos modulares e reutilizáveis

Estrutura do Laboratório

O laboratório está organizado em 4 exercícios progressivos:

• Exercício 1: Módulo IETF Interfaces (básico)
• Exercício 2: Módulo Device com ACLs e Interfaces (intermediário)
• Exercício 3: Criação e Validação de Dados de Instância
• Exercício 4: Augmentação de Módulos (avançado - bônus)

Ferramentas Utilizadas

• pyang: Validação e visualização de módulos YANG
• yanglint: Validação de dados de instância
• yang2dsdl: Conversão e validação de dados

Como Navegar

Acesse a pasta tasks/ para encontrar as instruções detalhadas de cada exercício:

• Exercício 1: Módulo IETF Interfaces
• Exercício 2: Módulo Device (ACLs e Interfaces)
• Exercício 3: Criação de Dados de Instância
• Exercício 4: Augmentação de Módulos (Bônus)

As soluções completas estão disponíveis na pasta solutions/ para consulta após completar cada exercício.

---

Comandos Úteis do Pyang

# Visualização em árvore
pyang -f tree module.yang

# Validação de sintaxe
pyang module.yang

# Geração de esquema JSON
pyang -f jsonschema module.yang -o module.jsonschema

# Geração de documentação HTML
pyang -f jstree module.yang -o module.html

# Verificar dependências
pyang --print-depends module.yang

# Visualização detalhada com tipos
pyang -f tree --tree-print-types module.yang