Кратко

  • draft-ietf-netmod-yang-versioning-reqs-14 описывает проблемы и пять групп требований, не рассматривая и не поддерживая конкретное решение.
  • Статус WG Document, I-D Exists, заполненная матрица пунктов и метки BC/NBC подтверждают наличие документации, но не точность классификации, безопасность старых клиентов, результат миграции или готовность к эксплуатации.

На архитектурном разборе открывают таблицу с пятью зелёными строками. Несовместимые изменения — учтены. Классификация совместимости — учтена. Старые клиенты — учтены. Устаревающие узлы — учтены. Миграция — учтена. В колонке доказательств находятся только ссылки на раздел 5 двенадцатистраничного Internet-Draft.

План испытаний приняли за результат испытаний.

Редакция 14 документа YANG Module Versioning Requirements датирована 20 июля 2026 года. На титульной странице указан предполагаемый статус Informational. В Datatracker это активный Internet-Draft рабочей группы NETMOD, WG Document со статусом IESG I-D Exists. Аннотация проводит чёткую границу: документ описывает проблемы и требования к возможным решениям, но не рассматривает и не рекомендует ни одно из них.

Первая группа требует вносить NBC-изменение без одновременного переименования всех импортирующих модулей и защищать клиентов, использующих только неизменённые или совместимо изменённые узлы. Нужны также ограничение импорта между «любой редакцией» и одной точной редакцией и способ выразить несовместимый переход.

Это не один критерий приёмки. Механизм может избежать переименования, но разрешить не ту зависимость. Он может пометить переход как NBC, хотя классификация ошибочна. Все импортеры могут собраться, а старый клиент всё равно не поймёт новое значение, значение по умолчанию или поведение. Поэтому в доказательстве нужны исходные и конечные артефакты, полное замыкание import/include, эффективная схема с features и deviations и точные версии реально запущенных клиентов.

Вторая группа требует, чтобы люди и инструменты различали BC- и NBC-изменения. В предыстории документа объясняется, почему одного синтаксиса мало: семантика может измениться при неизменных YANG statements, и оценка последствий остаётся за автором модели. Значит, проверяются два разных свойства: можно ли стабильно прочитать классификацию и верна ли она для конкретной пары редакций в конкретном контексте. Следует сохранять сравниваемые байты, правило сравнения, наборы features и deviations, ручные решения, предупреждения и имя проверяющего.

Третья группа посвящена существующим клиентам, в том числе ожидающим старую версию модуля после NBC-изменения. Четвёртая требует сообщать, реализованы ли deprecated-узлы, какие есть альтернативы и почему узел выводится из эксплуатации, а также заранее предупреждать об obsolete, пока определение ещё работает.

Это свойства целевой системы, а не текста. Нужны испытания в обе стороны: старый клиент с новым сервером и новый клиент со старым сервером. Следует проверить чтение, запись, RPC, notifications, ошибки и роли доступа при точных версиях программ, модулей, features и deviations. Для выводимых узлов опубликованную политику нужно сопоставить с эффективной схемой и наблюдаемым поведением, включая состояние после перезапуска.

Пятая группа требует руководства, перехода с YANG 1.0/1.1 и объяснения того, как NBC-изменение схемы влияет на instance data и ссылки. RFC 9195 позволяет указать content-schema, но пригодность данных под другой схемой всё равно зависит от редакций, features, deviations, области действия и совместимости. Акт миграции должен посчитать переименованные, удалённые, синтезированные, дополненные значениями по умолчанию и отклонённые значения, проверить смысловые инварианты и показать, что откат умеет прочитать новое состояние.

Истории редакций, Semver, packages, сравнение схем, правила имён файлов и YANG 2.0 могут закрыть отдельные ячейки этой матрицы. Само их соседство с документом требований ничего не закрывает. В редакции 14 нет нового протокола или модели данных. Её роль — удерживать обещания открытыми до тех пор, пока предложение, инструмент, сервер, клиент и миграция не предъявят соответствующие доказательства.

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

Зафиксированный официальный набор включает редакцию 14, карточку Datatracker, историю, список документов NETMOD, а также RFC 2119, RFC 6020, RFC 7950, RFC 8049, RFC 8299, RFC 8525 и RFC 9195.