Resumen

  • La revisión 15 recomienda el nombre con ysv:version, permite también el alias con fecha y sin sufijo, y exige identidad byte a byte entre archivos de la misma revisión.
  • El texto del módulo es la autoridad. Para pasar de catálogo a producción hacen falta pruebas independientes de resolución, selección, carga, esquema efectivo, datos de instancia, orden de despliegue y resultado operativo.

Tres rutas parecen resolver toda duda: core.yang y sus alias con sufijo de fecha de revisión y de versión semántica. Sus hashes son iguales. El sufijo coincide con la última revisión interna. Sin embargo, ningún hash cuenta si el controlador tomó un recurso incorporado, una caché antigua o un directorio anterior en su ruta de búsqueda.

draft-ietf-netmod-yang-module-filename-15, fechado el 20 de agosto de 2026, sigue siendo un Internet-Draft activo de NETMOD y está en la cola del RFC Editor. Propone ampliar el convenio basado en fecha: cuando existe ysv:version, debería publicarse un archivo con esa versión; los formatos con fecha y sin sufijo pueden coexistir.

El propio borrador fija el límite. El valor del nombre debe concordar con la revisión más reciente, pero el contenido del módulo es la fuente autorizada. Además, un identificador válido puede incluir _non_compatible, datos de compilación o una etiqueta de borrador. Dos ramas con los mismos números X.Y.Z pueden seguir siendo versiones distintas.

Cuatro hechos que suelen mezclarse

La presencia es un hecho de descubrimiento. El hash es un hecho sobre bytes capturados. La declaración ysv:version es un hecho del cuerpo. La elección es un hecho de ejecución. Solo el cuarto responde qué consumió un proceso.

Ni un registro, ni un enlace simbólico, ni una entrada de paquete incluye por sí mismo la precedencia de directorios, la política de caché o la opción usada al arrancar. El borrador reconoce que sistemas heredados pueden no admitir el nuevo nombre y presenta los enlaces como apoyo de migración. Un alias no actualiza un parser antiguo ni prueba que se haya seguido el enlace.

El recibo mínimo de selección enumera herramienta y versión, configuración, rutas ordenadas, candidatos, regla ganadora, ruta canónica y hash realmente leído. Si no existe ese rastro, “compiló correctamente” no permite reconstruir la selección.

La dependencia cambia el objeto probado

RFC 8525 define el esquema de un datastore como la unión de conjuntos de módulos. Incluye módulos implementados y solo importados, submódulos, funciones, desviaciones y ubicaciones. El esquema debe cerrar todas las importaciones aunque un conjunto individual no sea completo.

Por eso el mismo archivo principal puede producir resultados diferentes. Una herramienta encuentra otra revisión importada; otra activa una función; el servidor incorpora una desviación; el cliente conserva una caché. El content-id de YANG Library cambia cuando cambia la información de esa biblioteca, pero es específico del servidor y no sirve como digest universal entre partes.

La prueba bilateral debe expandir y comparar ambos conjuntos efectivos en la sesión y datastore pertinentes. La clasificación de compatibilidad puede acompañar esa comparación; no identifica los inputs. El artículo anterior sobre schema comparison ya cubre su algoritmo, que aquí no se repite.

De la sintaxis al efecto

Parsear prueba sintaxis. Compilar una clausura completa prueba referencias. Validar ejemplos prueba esos datos. Ensayar cliente y servidor prueba conductas concretas. Probar cohortes mixtas aborda el orden del rollout. Observar telemetría y servicio aborda el resultado.

Una capa no hereda automáticamente la conclusión de la anterior. Datos válidos pueden adquirir otro significado; un canario puede ocultar consumidores no cubiertos; restaurar un archivo no restaura una configuración ya transformada. El expediente debe separar descubrimiento, bytes, versión interna, base de clasificación, resolución, selección, carga, esquema en ambos extremos, instancias, despliegue, estado y efecto.

Datatracker muestra hoy dos errores y dos advertencias al extraer el módulo de ejemplo, entre ellos un prefijo ysv no definido en ese contexto. Es evidencia del documento y su validación, no de una avería desplegada. La situación editorial del borrador tampoco demuestra adopción.

Fuentes primarias

El conjunto cerrado incluye la revisión 15 y su historial, Updated YANG Module Revision Handling 17, YANG Semantic Versioning 28, RFC 7950, RFC 8525, RFC 9907 y la guía IANA YANG 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.