Resumo

  • O draft recomenda um arquivo com ysv:version, permite também formas com revision-date e sem sufixo e exige identidade byte a byte para a mesma revisão.
  • O conteúdo do módulo continua autoritativo. Descoberta, seleção, carregamento, schema efetivo, compatibilidade de instâncias e resultado do rollout são afirmações diferentes.

Um catálogo apresenta access.yang junto de seus aliases com sufixo de data de revisão e de versão semântica. Os três hashes coincidem e a versão do nome aparece na revisão mais recente do corpo. O catálogo está coerente. Ainda assim, não há prova de que um cliente tenha aberto qualquer um desses objetos.

Datado de 20 de agosto de 2026, draft-ietf-netmod-yang-module-filename-15 é um Internet-Draft ativo do NETMOD e está na fila do RFC Editor. Continua sendo trabalho em andamento. Ele estende a convenção por data para aceitar um identificador YANG Semver após um delimitador de arroba e reconhece que ferramentas legadas podem não suportar o formato.

O texto torna o corpo, e não o nome, a autoridade de ysv:version. Também aceita identificadores completos: _non_compatible, pré-lançamento, metadados de build e rótulos de drafts concorrentes. Guardar apenas X.Y.Z pode apagar a diferença justamente relevante para a classificação.

Hash igual tem escopo limitado

A exigência byte a byte é forte para alias de uma revisão. Ela não avalia se o autor escolheu corretamente a versão semântica, se imports e includes fecharam, ou se a execução usou esses bytes. Registro, listagem e symlink também são evidências de publicação e descoberta, não de consumo.

Uma ferramenta pode preferir outro diretório, usar cache, carregar recurso embutido ou aplicar override. Um sistema antigo pode sequer reconhecer o novo sufixo. Assim, o recibo de seleção precisa registrar ferramenta e versão, configuração, caminhos em ordem, candidatos, regra de precedência, caminho final e digest lido.

O schema é um conjunto contextual

Segundo o RFC 8525, o schema de um datastore reúne conjuntos de módulos, módulos import-only, submódulos, features, deviations e localizações. Um conjunto isolado pode não ser referencialmente completo; o schema precisa satisfazer as importações.

Duas pontas com o mesmo hash principal ainda podem resolver dependências diferentes, ativar features distintas ou aplicar deviations incompatíveis. O content-id do YANG Library deve mudar com a informação do servidor, mas é específico da implementação; valores distintos não provam diferença e valores locais iguais não são um digest universal.

É necessário comparar os conjuntos expandidos, ligados à sessão e ao datastore. A classificação de compatibilidade não substitui essa identidade. O algoritmo de schema comparison já foi tratado em outro artigo; aqui o ponto é provar o arquivo selecionado e carregado.

Cada degrau responde a uma pergunta

Parsing responde se o arquivo é sintaticamente aceito. Compilação responde se a clausura funciona naquele contexto. Validação responde sobre amostras de dados. Integração responde sobre comportamentos testados. Rollout misto responde sobre ordem. Telemetria responde sobre execução e serviço.

Não há herança automática. Dados válidos podem mudar de sentido; um canário pode omitir um consumidor; restaurar o arquivo não restaura estado já convertido. Por isso o registro deve separar descoberta, bytes, declaração interna, base da versão, resolução, seleção, load, schemas das duas pontas, instâncias, ordem, runtime e efeito externo.

O Datatracker hoje mostra dois erros e dois avisos no exemplo extraído, incluindo prefixo ysv ausente nesse contexto. É evidência do documento e do validador, não de falha em produção. Estar na fila editorial também não comprova implantação.

Fontes primárias

O conjunto fechado contém a revisão 15 e histórico, Updated YANG Module Revision Handling 17, YANG Semantic Versioning 28, RFC 7950, RFC 8525, RFC 9907 e IANA YANG guidance 03: https://datatracker.ietf.org/doc/html/draft-ietf-netmod-yang-module-filename-15; https://datatracker.ietf.org/doc/draft-ietf-netmod-yang-module-filename/; https://datatracker.ietf.org/doc/draft-ietf-netmod-yang-module-filename/history/; https://datatracker.ietf.org/doc/html/draft-ietf-netmod-yang-module-versioning-17; https://datatracker.ietf.org/doc/html/draft-ietf-netmod-yang-semver-28; https://www.rfc-editor.org/rfc/rfc7950.html; https://www.rfc-editor.org/rfc/rfc8525.html; https://www.rfc-editor.org/rfc/rfc9907.html; https://datatracker.ietf.org/doc/html/draft-ietf-netmod-iana-yang-guidance-03.