قد ينتمي التاريخ الأحدث إلى الفرع الخطأ

الخلاصة

• تسمح draft-ietf-netmod-yang-module-versioning-17 صراحة بسجل غير خطي للوحدة والوحدة الفرعية. يعرّف تاريخ المراجعة نسخة ثابتة، لكنه لا يثبت النسب أو الترتيب الدلالي أو التوافق.
• علامة NBC والتاريخ الأدنى الموصى به ومؤشرا YANG Library تصريحات محدودة. أما المخطط الفعلي وسلوك الخادم وتنفيذ العميل وهجرة البيانات وترتيب النشر والتراجع فلها اختبارات مستقلة.

يرى محلل الاعتماد مراجعتين للوحدة نفسها: واحدة في أبريل وأخرى في مايو. يوصي الاستيراد بأبريل حداً أدنى، فيبدو مايو اختياراً صالحاً. غير أن نسخة مايو خرجت من فرع آخر ولم ترث grouping الذي أضيف في أبريل. ينجح اختبار التاريخ ويفشل الاعتماد.

هذه هي النقلة الأساسية في المراجعة 17 من Updated YANG Module Revision Handling. نُشرت في 29 يونيو 2026 وما زالت Internet-Draft وليست RFC. تسمح بأن تشتق مراجعتان مستقلتان لوحدة أو submodule من الأب نفسه. تبقى التواريخ فريدة، لكنها لا تعني تسلسلاً زمنياً أو نسباً أو توافقاً خلفياً.

السجل مسار واحد داخل رسم متفرع

يسرد revision history الخاص بكل مراجعة السلسلة التي اشتقت منها فقط، ولا يسرد كل الفروع الممكنة. لذلك لا يمكن تقرير أن B اشتقت من A بمقارنة التاريخ أو version label؛ يجب فحص سجل B نفسه.

وقد يكون السجل مختصراً. تسمح المسودة بحذف إدخالات قديمة عندما تبقى علامات NBC المتبقية وصفاً صحيحاً للعلاقات الظاهرة، ولا تسمح بحذف أحدث إدخال. تمنع القاعدة رواية توافق زائفة، لكنها لا تضمن بقاء الرسم الكامل. يحتاج الإثبات التشغيلي إلى البايتات الدقيقة، ومستودع المصدر أو أرشيفه، ونسب commits، وسجل ما حُذف.

تضيف الوحدات الفرعية غموضاً آخر. ينبغي للوحدة أن تثبت revision-date لكل include. من دون ذلك لا تحدد هوية الوحدة وحدها المحتوى الذي جرى تجميعه فعلاً.

علامة NBC إنذار منسوب إلى صاحبه

لا تشجع المسودة التغييرات غير المتوافقة، لكنها تسمح بها لإصلاح عيب أو إنهاء عقدة قديمة أو إعادة بناء نموذج غير مستقر. إذا خالفت مراجعة قواعد BC مقارنة بالسابق في سجلها، وجب أن تحمل rev:non-backwards-compatible. وإذا غابت العلامة، وجب أن تكون التغييرات BC.

هذا يجعل الحكم ظاهراً، لكنه لا ينفذ المقارنة. قد يضيف المؤلف العلامة احتياطياً حتى لتوسعة متوافقة شكلياً إذا كان أثرها على العملاء كبيراً. وفي المقابل، لا تكون العلامة الغائبة أقوى من دقة المراجعة والسجل المحفوظ. يجب ربط البايتات القديمة والجديدة، وقائمة التغييرات، والقاعدة المطبقة، وهوية المراجع. خوارزمية schema-comparison موضوع وثيقة أخرى ولا تتكرر هنا.

الحد الأدنى للتاريخ ليس قيداً على الفرع

يسمح RFC 7950 بتحديد revision-date دقيق، ومن دونه لا تحدد لغة YANG أي مراجعة تستخدم. ولتفادي الربط الصارم، توفر rev:recommended-min-date توصية قابلة للقراءة الآلية لأقدم مراجعة متوقع أن تلبي الاستيراد.

يمكن للأداة إصدار warning، لكن الامتداد لا يغير سلوك import ولا conformance. وتوضح المسودة نفسها أن مراجعة بتاريخ لاحق على فرع آخر قد لا تحتوي التعريف المطلوب. لذلك تناسب الآلية السجل الخطي أكثر من الفروع.

يجب أن يحدد إيصال resolver المراجعة المختارة، ويثبت نسبها أو وجود التعريفات المطلوبة، ويحل الرموز في سياق features وdeviations الفعلي، ثم يثبت hash للمخطط الناتج. اجتياز التاريخ يفتح الفحص ولا يغلقه.

قيمتان منطقيتان توضحان تصريح الخادم

تضيف ietf-yang-library-status إلى YANG Library قيمتي deprecated-nodes-implemented وobsolete-nodes-absent. تعني الأولى عند true أن العقد deprecated منفذة مثل current ما لم تزلها deviation صريحة. وتعني الثانية عند true أن الخادم لا ينفذ أي عقد obsolete. أما false فهو الافتراضي ويترك السلوك غير محدد.

تقلل القيمتان true غموض المخطط المعلن، وإذا لم تكن الأولى true فلا يجوز للعميل الاعتماد على علامات NBC وحدها. ومع ذلك فهما تصريحان من الخادم نفسه، لا ينفذان قراءة أو كتابة أو RPC أو notification، ولا يثبتان تحميل deviations أو الثبات بعد إعادة التشغيل. يلزم اختبار العقد الحقيقية ومقارنة الفهرس المعلن بالمخطط الذي حمّلته العملية.

للعميل والبيانات حق اعتراض مستقل

قد يعيد خادم يستخدم مراجعة NBC قيمة صحيحة وفق مخططه لكنها خارج القيود التي بُني عليها عميل قديم. توصي المسودة بالمعالجة الدفاعية ومراقبة السجل وفهم التغيير قبل الهجرة. ينبغي ترك العقد deprecated في وقت مناسب، ويجب التوقف عن استخدام العقد obsolete.

ينبغي اختبار الاتجاهين: عميل قديم مع خادم جديد، وعميل جديد مع خادم قديم. تشمل الاختبارات encodings وdefaults وRPC والإشعارات والأخطاء وأدوار NACM، مع تسجيل binaries والوحدات وfeatures وdeviations بدقة.

للبيانات الدائمة حد آخر. يربط RFC 9195 instance data بـcontent-schema، لكن نجاح validation بعد التحويل لا يثبت حفظ المعنى. يجب أن يحصي إيصال الهجرة العقد المعاد تسميتها والمحذوفة والمولدة والمرفوضة، ويختبر ثوابت دلالية، ويثبت أن النسخة القديمة تستطيع قراءة الحالة بعد rollback.

يفصل RFC 8342 بين running وintended وoperational لأن الإعداد والنية المطبقة والواقع المرصود قد تختلف. نجاح الاستيراد لا يثبت تقارب الجهاز أو التشغيل البيني أثناء النشر المتدرج أو نتيجة الخدمة.

تجعل المراجعة 17 تطور YANG أكثر صدقاً حين يبقى لكل تصريح نطاقه: التاريخ يعرّف، والسجل يصف سلسلة نسب، وNBC يحذر، والتاريخ الأدنى يوصي، وYANG Library يبلغ. العميل المنفذ والبيانات المهاجرة والشبكة المرصودة تكمل الدليل.

المصادر الأساسية

تضم المجموعة الرسمية المجمدة المراجعة 17، وسجل Datatracker وتاريخه، وRFC 7950، وRFC 8525، وRFC 9907، وRFC 8342، وRFC 8341، وRFC 9195، ومتطلبات الإصدار، المراجعة 13.