Elasticsearch / المتقدم: استرجاع صامد وقابل للتعافي / الدرس 18

ترقيات الإصدارات وضوابط النشر

ابنِ مراجعة توافق وتعافٍ تشمل العملاء والفهارس والميزات ومسؤوليات النشر.

وقت القراءة التقريبي: 5 دقيقةتاريخ مراجعة المحتوى 2026-10-28

في هذه الصفحة

أهداف الدرس

ميّز توافق الواجهة وصيغة الفهرس والإضافات واللقطات.
خطط لنقاط تحقق النشر ومسار تعافٍ مدعوم.

للتوافق طبقات مستقلة متعددة

قد يستخدم تطبيق عنوان HTTP متوافقاً، بينما تمنع صيغة إنشاء فهرس قديم ترقية الخادم. لكل من مكتبات العميل والإضافات والتعيينات والسكربتات والمحللات وإصدارات اللقطات وأتمتة التشغيل قيوده. اجرد إصدارات الخادم والعميل الفعلية، ولا تستنتجها من ملف حزم المطور. تسمي الدورة مرجع 8.19 أساساً للشرح، ولا توصي بمعاملة صفحاته المؤرشفة كسياسة دعم إنتاج حالية. راجع وثائق الترقية والدعم الرسمية الخاصة بالمصدر والوجهة المختارين، بما فيها الإصدارات الوسيطة المطلوبة وقيود الإصدارات التي صدرت خارج ترتيب أرقامها.

اجمع أدلة ما قبل النشر المعتمدة

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

http مثال تقني توضيحي؛ النتائج المنطقية مستنتجة ولم تُختبر على المحرك.

GET /_migration/deprecations
GET /_nodes?filter_path=nodes.*.version,nodes.*.plugins.name

هذه أسطر طلبات HTTP قرائية توضيحية لمراجعة عنقود ذي إصدار محدد ومصرح به. لا يقدم المثال عنوان خدمة أو بيانات اعتماد.

اختبر الحمل لا بدء العنقود فقط

ينبغي للتمرين إعادة بناء أو استعادة بيانات اصطناعية متوافقة، وتشغيل استعلامات ممثلة، واختبار خطوط معالجة البيانات، وفحص التعيينات عبر الفهارس القديمة والجديدة. ضمّن تحليل العربية واستعلامات nested وإخفاقات Bulk الجزئية ورموز المتابعة وتوقعات دقة التجميع وتفويض التشغيل. تحقق من تسلسل الطلبات وتحليل الاستجابات في العميل؛ فقد ينكسر توافق التطبيق حتى إذا قَبِل الخادم الطلب. احفظ مجموعة أحكام ملاءمة لرصد تغير المحلل أو الدرجات. لا تقارن الزمن إلا ضمن حمل وحد قياس معلنين؛ ولا تنفذ هذه الدورة التحريرية أياً من اختبارات المحرك هذه أو تدعي أداء ترقية.

يحتاج التراجع خطة مستقلة متوافقة

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

json مثال تقني توضيحي؛ النتائج المنطقية مستنتجة ولم تُختبر على المحرك.

{"review_scope":"synthetic versioned-cluster release","checkpoints":["inventory source and target compatibility","rehearse representative requests","prove compatible restore or rebuild","reconcile writer handoff","verify runtime access and search quality"],"recovery_rule":"do not start older binaries against upgraded data"}

هذه قائمة نشر تحريرية محلية. ليست إعداد Elasticsearch ولا سجلاً لترقية نُفذت.

تنتمي ملكية المنصة والترخيص للمراجعة

تختلف ملكية الترقية بين العناقيد ذات الإدارة الذاتية وHosted ومنصات التنسيق. مشاريع Serverless مستمرة التحديث ولا يختار المستخدم إصدارها؛ لذلك تركز مراجعة توافقها على الواجهات المدعومة وسلوك التطبيق، لا اختيار ملفات العقد. وللترخيص طبقات أيضاً: تستخدم توزيعة Elasticsearch الافتراضية ELv2، وتتيح أجزاء مصدر مجانية مؤهلة خيارات موثقة منها AGPLv3 وSSPL، وللعملاء شروطهم المستقلة. وتظل الميزات الخاضعة للاشتراك والخدمات السحابية مسائل استحقاق منفصلة. اقرأ وثائق الترخيص والعرض للبرنامج المحدد، ولا تفترض أن ترخيص عميل Apache يغطي توزيعة الخادم.

الأخطاء الشائعة وإصلاحها

يُعامل العميل المدعوم كأنه دليل جاهزية الترقية

لماذا يحدث؟: أُسقطت صيغ الفهارس أو الإضافات أو سلوك التطبيق من مراجعة التوافق.
كيف تصلحه؟: اجرد كل طبقات التوافق ذات الصلة، وتمرن عليها.
كيف تتجنب تكراره؟: احفظ أدلة ما قبل النشر الخاصة بالإصدار مع أمثلة التطبيق.

تُستخدم ملفات أقدم كتراجع مرتجل

لماذا يحدث؟: اختلط عكس إصدار الملف التنفيذي بالتعافي المدعوم للبيانات.
كيف تصلحه؟: اتبع خطة استعادة أو إعادة بناء متوافقة ثبتت مستقلة.
كيف تتجنب تكراره؟: اعتمد مسار التعافي قبل أن تغير الترقية صيغ البيانات.

يُفترض أن ترخيص عميل Apache يرخص الخادم أيضاً

لماذا يحدث؟: اختلطت مكونات برمجية مختلفة وحقوق اشتراك مستقلة.
كيف تصلحه؟: راجع التوزيعة وجزء المصدر وشروط العرض المحددة.
كيف تتجنب تكراره؟: تتبع التراخيص واستحقاقات الميزات لكل مكون منشور.

اختبر فهمك

1. هل يغني تقرير إهمالات نظيف عن اختبار تطبيق ممثل؟

اعرض الحل المشروح

لا. لا يثبت صحة سلوك كل استعلام أو محلل استجابة أو خط معالجة بيانات أو إضافة أو مسار أمني. استخدمه مع وثائق التوافق الخاصة بالإصدار وتمرين حمل معزول. سجل المسارات غير المختبرة صراحة بدلاً من استنتاج النجاح من بدء العنقود.

2. ماذا يجب أن تقول خطة التراجع عن الكتابات المقبولة بعد نقطة تحقق الترقية؟