Skip to Content
Getting Startedأول بناء لك

أول بناء لك

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

قبل أن تبدأ

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

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

1. صرّح بالنتيجة وتحققاتها

مثال:

Build a Debian 13 server image with OpenSSH and curl. Create a password-locked deploy user in the sudo group. Verify that the image boots, the deploy user exists, the ssh service is enabled, and curl is installed. Do not add Docker or a desktop.

الاستثناءات المحددة تساعد على تمييز صورة حدية مقصودة عن طلب أغفله المخطط ببساطة.

2. افحص معاينة الوصفة

تحقق على الأقل من أن:

  • base_image يطابق التوزيعة والإصدار المطلوبين؛
  • الحزم المطلوبة تظهر تحت os.packages أو تُوفَّر عبر ميزة صريحة؛
  • اختيارات المستخدمين والمجموعات والخدمات والشبكات والمثبّت وسطح المكتب تطابق الطلب؛
  • scenarios تحتوي التحققات التي تحتاجها فعلا؛
  • لم تُدرج حزمة أو سطح مكتب أو مثبّت أو بيان اعتماد أو مستودع خارجي غير مطلوب.

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

يمكن أن يفوت التحقق حزمة غير متاحة، أو انقطاعا في المصدر، أو فشل بناء خاص بالتوزيعة، أو سلوكا بلا اختبار. اقرأ المعاينة كعقد مقترح.

3. ابدأ البناء مرة واحدة

اختر Start Build على المعاينة المتحقَّق منها. النقرة الناجحة تنشئ معرف بناء. احتفظ بذلك المعرف عند الإبلاغ عن مشكلة؛ هو أوثق من نسبة مئوية أو لقطة شاشة وحدها.

يمكن أن تعرض لوحة البناء حالات مثل queued، planning، configured، building، finalizing، completed، failed، أو cancelled. قد ينتظر بناء queued سعة العامل أو استعادة بدء التشغيل. النسبة المعروضة إسقاط تقدم، وليست موعدا؛ بعض خطوات التعبئة ونظام الملفات تستغرق وقتا أطول بكثير من غيرها.

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

4. افصل اكتمال الصورة عن اكتمال الاختبار

قد تنتهي صورة قبل أن يبلغ تحقق VM المختار حالة نهائية. اقرأ كليهما:

  • حالة البناء: ما إذا جُمّع مخرج دائم وأُنهي؛
  • حالة الاختبار: not_run، running، passed، failed، أو error؛
  • حالة الشهادة، إن وُجدت: نتيجة سياسة الأدلة المضبوطة، وليست شهادة أمن أو عتاد عامة.

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

5. افحص المخرج ونزّله

قبل التنزيل، قارن الوصفة النهائية وأدلة الحزم/الاختبارات مع الطلب. سجّل معرف البناء، واسم ملف المخرج، والحجم، وchecksum عند عرضه.

استخدم إجراء تنزيل البناء فقط بعد اكتمال إنهاء المخرج. قد تحتوي حزمة التنزيل على ISO والأدلة المرتبطة. إذا أعاد التنزيل Failed to create download package، أو not found، أو خطأ JSON آخر:

  1. أكد أنك مسجّل الدخول كمالك البناء؛
  2. أعد فتح البناء نفسه بدلا من بطاقة محادثة أقدم؛
  3. تحقق من اكتمال إنهاء المخرج وأن ISO مدرج؛
  4. أعد المحاولة مرة واحدة؛
  5. أبلغ معرف البناء، والطابع الزمني، وحالات البناء/الاختبار/الإنهاء المعروضة، ونص الخطأ الحرفي.

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

6. اختبر ISO في سياقه المقصود

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

مسارات الاستعادة الشائعة

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

الخطوات التالية