اختر نقطة البداية
شغّل تمهيد Basement فقط على المضيف الذي تنوي إعداده. وللاطلاع الأول على CLI دون تثبيت خدمات، اختر مسار أدوات التشغيل. يمكن لمستخدمي Windows الحصول على CLI من ملف ZIP للإصدار العام؛ لكن هذا لا يجعل Windows هدف تشغيل أصلياً مدعوماً لـ Basement. راجع مرجع توافق أنظمة التشغيل لمعرفة هدف التثبيت.
1. افحص CLI وأنشئ مساحة عمل
بعد تثبيت أدوات التشغيل، افتح الطرفية:2. احفظ خياراتك
لـ Basement Kit بإعداداته الافتراضية في الكتالوج:init الملف stack-spec.yaml وحيازة المالك المحلية. ويطبع مسار الإعداد المحفوظ وأمري validate وgenerate التاليين. لم يثبّت أي خدمات.
تُسجَّل الإعدادات الافتراضية للكتالوج كخيارات صريحة. ويُطلب الإدخال المطلوب عندما يحتاجه kit المختار. ولإدراج workload الصور الخاص بالـ kit في مساحة عمل جديدة، استخدم الأمر التالي بدلاً من أمر init السابق:
--non-interactive إلى init. عندها يفشل الإدخال المطلوب المفقود بدلاً من طلبه. ولا يوافق هذا الخيار على إجراءات النشر اللاحقة. يوثّق stackkit init --help الخيارات المتاحة؛ أما الخيارات الموسومة بأنها للتوافق القديم فهي خارج هذه الجولة الأصلية.
3. تحقق وولّد وراجع
readiness.generation.status وreadiness.apply.status، واقرأ أي عوائق. صحّح الإعداد وولّد مجدداً عند الحاجة. الخطة الجاهزة لا تعني أن التطبيقات تعمل بالفعل.
4. افحص الهدف وطبّق
على المضيف الهدف المدعوم، ومع مساحة العمل نفسها:prepare متطلبات المضيف المسبقة مثل Docker وCompose والتخزين والمنافذ. ولا يثبّت حزم المضيف الناقصة. عالج المتطلبات المُبلَّغ عنها قبل التطبيق.
يغيّر apply المضيف. راجع مطالبة الموافقة فيه والتغييرات المقصودة. اتبع المراجعة والتطبيق والتحقق لفحوص دورة الحياة التفصيلية. وإذا استخدمت تمهيد Basement، فقد تم التطبيق الأولي بالفعل؛ فلا تكرره لمجرد إتمام الجولة.
5. اكتشف ما هو قابل للاستخدام
verify مواصفة الـ stack، وحالة النشر، وخدمة Docker، وحاويات StackKit وصحتها، ومع --http المسارات من ملخص الوصول المولّد. يحمل كل فحص فاشل سببه. العنوان المُعدّ وحده لا يثبت أن التطبيق يمكن الوصول إليه؛ أما فحص HTTP الناجح فيثبت ذلك.
اتبع دليل إعداد التطبيق عندما يبقى حساب يحتاج إلى ضبط. استخدم stackkit setup --help لمعرفة إجراءات الإعداد المدعومة. واختم بفتح التطبيق وتنفيذ مهمة حقيقية صغيرة، مثل إضافة صورة اختبار إلى مكتبة صورك. نجاح تثبيت CLI وحده لا يثبت أن هذه المهمة تعمل.
6. الاستئناف وحل المشكلات
عد إلى مجلد النشر نفسه:drift detect بيئة Compose الحية مقابل الخطة المحلولة والملفات المولّدة وأدلة التطبيق الموقّعة دون تغيير أي شيء، ويقرأ logs get السجل المهيكل لتشغيل واحد من logs list. استخدم السبب المُبلَّغ عنه والإجراء التالي للمتابعة. احتفظ بمساحة العمل عند فشل عملية؛ ولا تبدأ من جديد بـ init ولا تعدّل الملفات المولّدة لتجاوز عائق. أبقِ مفاتيح المالك وسجلات الوصول خاصة، وراجع ناتج التشخيص قبل مشاركته.
للعناية المستمرة، استخدم عمليات اليوم الثاني والنسخ الاحتياطي والاستعادة. واختيار الـ kit وتجربة الإعداد الموجَّهة في Techstack استمرار اختياري؛ ولا يلزمان لسير عمل CLI المحلي هذا.