Кратко

  • Редакция 15 рекомендует имя с ysv:version, разрешает варианты с revision-date и без суффикса и требует побайтовой идентичности файлов одной ревизии.
  • Авторитетен текст модуля. Обнаружение, байты, разрешение зависимостей, выбор, загрузка, эффективная схема, проверка экземпляров и результат внедрения требуют отдельных доказательств.

В каталоге видны system.yang без суффикса, псевдоним с суффиксом даты редакции и псевдоним с суффиксом семантической версии. Их SHA-256 совпадают, а версия в имени соответствует новейшему revision. Но неизвестно, какой путь открыл контроллер: он мог взять встроенный ресурс, старый кеш или файл из более приоритетного каталога.

draft-ietf-netmod-yang-module-filename-15 датирован 20 августа 2026 года. Это активный Internet-Draft NETMOD в очереди RFC Editor, всё ещё изменяемая рабочая спецификация. Для ревизии с ysv:version она рекомендует Semver-имя, одновременно разрешая имя с датой и без суффикса.

Значение в имени обязано совпадать с новейшей ревизией, однако источником истины названо содержимое. Полный идентификатор способен включать _non_compatible, prerelease, build-метаданные и метку конкурирующего проекта. Одинаковая тройка X.Y.Z не всегда означает одну версию.

Граница хеша

Побайтовое равенство доказывает идентичность захваченных объектов. Оно не доказывает правильность классификации, полноту import/include или факт чтения процессом. Реестр фиксирует публикацию, список — видимость, symlink — связь имён; ни один из них не хранит порядок поиска, кеш, слой контейнера или override.

Проект допускает отказ от соглашения для старых инструментов и называет ссылки способом миграции. Ссылка не обновляет старый parser и не создаёт событие загрузки. Нужен протокол с версией инструмента, конфигурацией, упорядоченными путями, кандидатами, правилом приоритета, финальным путём и фактически прочитанным digest.

Эффективная схема — это состав

RFC 8525 определяет схему datastore как объединение module sets: реализуемые и import-only модули, submodules, features, deviations и locations. Отдельный набор может быть неполным, а схема должна удовлетворять всем imports.

Поэтому одинаковый главный файл не гарантирует одинаковый результат. Разные dependency, feature, deviation, mount-контекст или кеш создают разные схемы. content-id YANG Library меняется с информацией сервера, но зависит от реализации и не является общим межсерверным хешем.

Следует сравнивать развёрнутые наборы обеих сторон в нужных session и datastore. Классификация совместимости — дополнительная запись, не замена идентичности входов. Алгоритм schema comparison уже рассмотрен в другой статье; здесь предмет — выбор и загрузка.

Лестница до результата

Parsing проверяет синтаксис. Compilation — конкретное замыкание. Instance validation — выбранные данные. Интеграция — наблюдаемое поведение. Mixed-version rehearsal — порядок rollout. Телеметрия — работу сервиса.

Успех ступени не переносится автоматически дальше. Валидные данные могут поменять смысл; canary может не охватить потребителя; возврат файла не возвращает преобразованное состояние. Отдельно сохраняются обнаружение, байты, декларация, основание версии, разрешение, выбор, load, схемы обеих сторон, экземпляры, порядок, runtime и внешний эффект.

Datatracker сейчас показывает два errors и два warnings для извлечённого примера, включая неопределённый в этом контексте префикс ysv. Это состояние документа и валидатора, не производственный сбой. Очередь RFC Editor также не доказывает внедрение.

Первичные источники

Закрытый набор включает редакцию 15 и историю, Updated YANG Module Revision Handling 17, YANG Semantic Versioning 28, RFC 7950, RFC 8525, RFC 9907 и 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.