كيف يُحدَّث عميل Fleetd؟ التحقق من التوقيع، ومقارنة الإصدارات، والتعافي من الفشل

كيف يتحقق Fleetd v0.3.0 من توقيع الحزمة والمعمارية والإصدار قبل استبدال الوكيل، وما حدود الفحص الأولي والاستعادة اليدوية؟

من أكثر ما يُخشى في أدوات الإدارة عن بُعد أن تُحدِّث العميل، ثم لا تعود قادرًا على الاتصال بتلك الآلة.

إذا كان الخادم قريبًا، فلا يزال بإمكانك تسجيل الدخول إليه وإصلاح المشكلة. أما إذا كان جهاز التوجيه المرن في مكان آخر، فقد لا يفيدك زر «إعادة المحاولة» في لوحة الإدارة بعد أن يقطع التحديث الاتصال.

لذلك، استكمالًا لسجلات تطوير Fleetd الخمسة السابقة، نتناول هذه المرة تحديث العميل. فالأمر لا يقتصر على تنزيل ملف جديد؛ بل يتطلب الإجابة عن ثلاثة أسئلة: هل يمكن الوثوق بهذا الملف؟ وهل يناسب هذه الآلة؟ وماذا نفعل إن ظهرت مشكلة بعد استبداله؟

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

في التحديث عن بُعد، ابدأ بالفصل بين الجهات التي تتخذ القرارات

تبدأ عملية تحديث Fleetd من لوحة الإدارة. يرفع المسؤول حزمة إصدار ويختار إصدارًا لآلة واحدة متصلة، ويمكنه أيضًا تحديث الآلات المتصلة ذات البنية نفسها إذا كانت تعمل بإصدارات أقدم.[1]

يتولى الخادم توزيع الحزمة وتمرير طلب التحديث، بينما يقرر العميل ما إذا كان سيقبلها.

هذا التمييز مهم: ظهور الملف في لوحة الإدارة الخاصة بك لا ينبغي أن يجعله موثوقًا تلقائيًا. يُضبط مفتاح الإصدار العام release_key محليًا لدى العميل، وعليه التحقق من توقيع الحزمة بنفسه بعد استلامها؛ وإذا لم يكن هذا المفتاح العام مضبوطًا، فإنه يرفض التحديث عن بُعد.[2]

إذا ضُبط مفتاح الإصدار العام على الخادم أيضًا، فسيتحقق من الحزمة عند رفعها. لكن تحقق الخادم لا يغني عن تحقق العميل. وفقًا للشيفرة المصدرية، يستطيع الخادم، عندما لا يكون مفتاح الإصدار العام مضبوطًا لديه، الاكتفاء بتحليل بيان الحزمة بغرض تخزينها وعرضها. لذلك، لا يثبت «نجاح الرفع» أن العميل سيقبلها بالضرورة.[4]

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

ويختلف هذا أيضًا عن توقيع أوامر المتصفح الذي تناولته مقالة سابقة: يُستخدم توقيع الأوامر للتصريح بعملية محددة، بينما يُستخدم توقيع الإصدار للتحقق من حزمة برمجية. ولا يجوز الخلط بين مسؤولياتهما أو إدارة مفاتيحهما.

التوقيع ليس مجرد حساب تجزئة للملف

تحتوي حزمة الإصدار في v0.3.0 على بيان وتوقيع والملف التنفيذي للعميل. ويسجل البيان الإصدار، وبنية المعالج، وحجم الملف، وقيمة SHA-256 له.[3]

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

يعالج ذلك مسألتين مترابطتين:

  • هل أصدر البيانَ من يملك المفتاح الخاص المقابل، وهل تعرّض للتعديل؟
  • هل الملف التنفيذي الذي نُزّل هو فعلًا الملف الذي يصفه هذا البيان؟

وجود قيمة تجزئة وحدها، من دون مصدر توقيع موثوق، لا يحقق الغرض نفسه. فإذا استطاع مهاجم استبدال الملف وقيمة التجزئة المجاورة له معًا، فسيظل الاثنان «متطابقين».

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

على العميل أن يعيد فحص الإصدار والبنية

بعد التحقق من التوقيع، يفحص العميل أيضًا ما إذا كانت البنية المذكورة في البيان تطابق runtime.GOARCH لديه، وما إذا كان إصدار البيان أحدث من الإصدار الذي يعمل به حاليًا.[2]

لذلك، لا يمكن تثبيت حزمة arm64 صحيحة التوقيع على عميل amd64 لمجرد ظهورها في قائمة لوحة الإدارة.

ولمقارنة الإصدارات حدود محددة أيضًا. ففي v0.3.0، تُقارن ثلاثة أعداد صحيحة تمثل الإصدار الرئيسي والفرعي وإصدار التصحيح؛ ويُتجاهل الجزء اللاحق للشرطة.[3]

على سبيل المثال، وفقًا لقواعد هذه الدالة، يتطابق جوهر الإصدارين 0.4.0-dev و0.4.0، ولن يُعدّ الثاني أحدث من الأول. هذه ليست قواعد الترتيب الكاملة للإصدارات الأولية في SemVer، ولا يصح إحلال التصور المعتاد عن SemVer محل سلوك الشيفرة المصدرية.

تُرفض الإصدارات المماثلة والأقدم. وهذا يمنع الرجوع إلى إصدار أقدم اعتباطيًا عبر مسار التحديث المعتاد، لكنه ليس آلية تمنع التراجع على جميع المستويات: فمن يملك صلاحية تعديل الملفات محليًا لا يزال قادرًا على استبدال البرنامج، كما أن استعادة ملف قديم وسيلة صيانة منصوص عليها صراحةً في الوثائق.

عند إصدار النسخ المعتادة، ينبغي أن يتطابق بيان الإصدار مع الإصدار المضمّن في الملف التنفيذي. يضبط نص البناء البرمجي في المشروع إصدار البرنامج؛ وعند تزويده بإصدار النشر وملف المفتاح الخاص بالتوقيع، ينشئ أيضًا حزمًا موقّعة للبنى المقابلة.[5]

قبل الاستبدال، اطلب من البرنامج الجديد أن يذكر إصداره

لا يستبدل العميل ملفه التنفيذي فور انتهاء التنزيل.

فهو يكتب أولًا الملف التنفيذي الذي اجتاز التحقق إلى ملف .new بجوار الملف التنفيذي الحالي، ثم يشغّل الأمر الفرعي version من الملف الجديد، ويشترط أن ينتهي البرنامج ضمن مهلة محددة وأن يطابق خرجه الإصدار الوارد في البيان الموقّع.[2]

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

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

بعد نجاح الفحص الذاتي، يحاول البرنامج الاحتفاظ بالملف القديم تحت الاسم .old، ثم يستبدل الملف الموجود في المسار الرسمي بملف .new عبر إعادة التسمية. ووضع الملف المؤقت في الدليل نفسه جزء من عملية الاستبدال هذه؛ ولا ينبغي فهمها على أن النسخ بين أنظمة ملفات مختلفة يملك السلوك نفسه بالضرورة.

بعد إتمام الاستبدال، تُبلّغ العملية الحالية بالنتيجة ثم تنتهي، ويُترك التشغيل التالي لـ systemd أو procd. تضبط قوالب التثبيت في المشروع آلية إعادة التشغيل لهما؛ أما إذا كنت تشغّل العميل يدويًا، أو عدّلت إعدادات الخدمة بنفسك، فعليك التأكد على نحو مستقل ممن سيتولى تشغيل البرنامج الجديد.

لذلك، فإن استلام لوحة الإدارة نتيجة تفيد بنجاح التثبيت، وعودة العملية الجديدة إلى العمل بحالة سليمة، حدثان يقعان في وقتين مختلفين.

التعافي من الفشل يعتمد على المرحلة التي وقع فيها

عبارة «سيُتراجع عن التحديث عند الفشل» عامة أكثر من اللازم. وفقًا لتنفيذ v0.3.0، يجب التمييز بين المراحل التالية على الأقل:

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

وهناك تفصيل يسهل إغفاله: تحاول الشيفرة المصدرية أولًا حفظ البرنامج القديم بإنشاء رابط صلب، وإذا فشلت، تحاول نسخه بالقراءة والكتابة؛ وبعض حالات الفشل في هذا المسار الاحتياطي لا تمنع متابعة الاستبدال.[2]

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

كذلك، فإن الاستبدال بإعادة التسمية ليس معاملة ترقية تشمل الآلة بأكملها، ولا يمثل ضمانًا لاستمرارية البيانات بعد انقطاع الكهرباء. لم تتضمن هذه المقالة تحققًا على أجهزة OpenWrt فعلية، ولا اختبارات لانقطاع الكهرباء أو أعطال الأقراص.

حدّث آلة واحدة قبل التفكير في التحديث الجماعي

توضح وثائق المشروع صراحةً أنه لا يوفر تحديثًا مؤتمتًا بالكامل: فقد يؤدي نشر إصدار معيب على جميع الآلات دفعة واحدة إلى انقطاع اتصال جميع العملاء، وبعد انقطاعهم لن يعود بالإمكان الاعتماد على لوحة الإدارة لإصلاح المشكلة.[1]

أفضّل تقسيم قبول التحديث إلى ثلاث مراحل.

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

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

المرحلة الثالثة هي فحص الوظائف بعد عودة الآلة إلى الاتصال. تأكد من أن الإصدار الجديد يعاود الاتصال، وأن المقاييس تستمر في الوصول، وأن العمليات الضرورية تُنجز. راقب ذلك مدة تناسب احتياجات عملك قبل توسيع نطاق التحديث. ولا تحدد هذه المقالة عتبة عامة من نوع «انتظر بضع دقائق وسيكون الوضع آمنًا».

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

إذا انقطع اتصال البرنامج الجديد بالفعل، فيجب إجراء التعافي وفق بيئة النشر. يقدم الدليل الرسمي طريقة لاستبدال الملف التنفيذي القديم يدويًا ثم إعادة تشغيل الخدمة؛ وتختلف مسارات البرنامج وطرق إدارة الخدمة بين Linux وOpenWrt، لذا لا يصح نسخ أوامر إحدى البيئتين واستخدامها في الأخرى كما هي.[1]

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

المراجع

تاريخ المراجعة: 2026-11-09. تحليل التنفيذ محصور في v0.3.0، ولا يعبّر بالضرورة عن سلوك الإصدارات اللاحقة. المقالة السابقة: بعد مراقبة الخوادم، كيف نجعل التنبيهات مفيدة فعلًا؟

  1. Fleetd v0.3.0: دليل تحديث العميل.
  2. تنفيذ تحديث العميل والفحص الذاتي.
  3. توقيع حزمة الإصدار والتحقق منها ومقارنة الإصدارات.
  4. رفع حزم الإصدار وتوزيعها على الخادم.
  5. نص البناء البرمجي وقالب تثبيت خدمة العميل.
  6. اختبارات التثبيت واختبارات حزمة الإصدار.

رسم مفاهيمي مولّد بالذكاء الاصطناعي، وليس صورة اختبار منتج أو واجهة فعلية أو مخطط توصيل.

Discussion

Share a question or your experience. Comments appear after moderation. Your email is never displayed publicly. Comment privacy

Loading comments…