استلام شيفرة مدمجة قديمة

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

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

1.0 نقطة البداية المعتادة

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

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

2.0 المرحلة 1: تأمين الأصول

اجمعوا كل شيء قبل أن يختفي:

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

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

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

3.0 المرحلة 2: جعل البناء قابلًا للتكرار

الهدف أن نُنتج من الشيفرة ملفًا ثنائيًا مطابقًا لما في الميدان، أو أن نفسّر كل اختلاف.

  1. إعادة إنشاء سلسلة الأدوات في حاوية أو آلة افتراضية موثّقة، مع تثبيت الإصدارات.
  2. البناء ومقارنة الناتج بالملف الثنائي الميداني. الاختلافات الناتجة عن طوابع زمنية أو مسارات مضمّنة في البناء متوقعة، أما الاختلافات في الشيفرة فلا.
  3. إذا لم يتطابقا، يُبحث عن مراجعة الشيفرة المطابقة. وإن لم تطابق أي مراجعة، يُسجَّل ذلك نتيجةً: فقد تحتوي البرامج الثابتة في الميدان على تغييرات لم تُودَع قط.
  4. إضافة نص بناء وتكامل مستمر حتى يستطيع أي شخص البناء بأمر واحد.

تعريف مشروع Reproducible Builds معيار مفيد يُستهدف. وحتى قابلية التكرار الجزئية تخبركم إن كنتم تعملون على الشيفرة التي تعمل فعلًا في الميدان.

4.0 المرحلة 3: إعادة إنتاج الأعطال

جهّزوا جهازًا أو أكثر على منضدة العمل يطابق مراجعات العتاد في الميدان. ولكل عطل مبلَّغ عنه:

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

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

5.0 المرحلة 4: الفهم والتقييم

الآن تُقرأ الشيفرة بهدف محدد. نكتب تقييمًا قصيرًا يغطي:

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

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

6.0 المرحلة 5: الإصلاح والتحقق والإصدار

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

6.1 إصلاح أم إعادة كتابة؟

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

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

7.0 ما تحصلون عليه في كل مرحلة

  • جرد للأصول ومستودع قاعدته الأرشيف الأصلي.
  • بناء قابل للتكرار مع سلسلة أدوات موثّقة وتكامل مستمر.
  • تقرير إعادة إنتاج الأعطال.
  • تقييم للشيفرة مع مخاطر مرتبة.
  • إصلاحات مع اختبارات وملاحظات إصدار.

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

المراجع

الأسئلة الشائعة

المورّد السابق لا يسلّمنا الشيفرة المصدرية. ماذا يمكن أن نفعل؟

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

كم من الوقت قبل أن تتمكنوا من إصلاح أول خطأ؟

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

هل يمكنكم العمل دون الوصول إلى أجهزة الميدان؟

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

هل ستغيّرون أسلوب الشيفرة أو بنيتها؟

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