مراقبة الحزمة
فحوص دورة الحياة هذه هي الطريقة المدعومة لتقييم الحزمة نفسها. تحتفظ StackKits بأدلة الرصد والتحقق محليًا ولا تحتاج إلى خدمة مراقبة مستضافة. وحدة Uptime Kuma المنشورة لا يختارها StackSpec الأصلي الأولي v2، لذا لا يملك Basement أو Cloud Kit جديد عنوان مراقبة مولَّدًا. إذا شغّلت مراقبًا منفصلًا، فأضف فحوصًا فقط للمسارات المصرّح لك بمراقبتها. تحتاج المسارات المحمية إلى نقطة فحص صحة مقصودة أو استجابة مصادقة متوقعة؛ وإضعاف حماية المسار للحصول على HTTP 200 ليس إعداد مراقبة صالحًا.قبل التغيير
- حدّث StackSpec، لا الملفات المولَّدة.
- شغّل
stackkit validateوstackkit generate. - افحص
stackkit plan --jsonوتوقف عند أي عائق جاهزية. - راجع المخرجات واحصل على موافقة المالك المحلي قبل أي أمر يغيّر الحالة.
- شغّل
stackkit verify --http --jsonبعد التغيير.
إضافة حمل عمل إلى مساحة عمل قائمة
لا يتطلب اختيار حمل عمل جديد إعادة تشغيلstackkit init ولا استبدال StackSpec الأولي. حرّر كتلة workloads في StackSpec القائم، ثم أنشئ حفظ الأسرار قبل إعادة التوليد:
stackkit secrets materialize كخطوة صريحة بين اختيار حمل العمل وتشغيل generate. أنشئ الحفظ، ثم ولّد وطبّق؛ ولا تخترع قيم أسرار.
إزالة حمل عمل مطبَّق
يزيلstackkit remove حمل عمل مطبَّقًا واحدًا محددًا بموافقة المالك المحلي:
absent للمتطلب المحدد والنسخة والبصمة المحددة للملف المطبَّق. تُحفظ الطلبات والنتائج والأدلة النهائية المحدودة تحت .stackkit/evidence/removal/.
استهداف توزيع واحد في نتيجة متعددة العقد
يعرض ملخص التطبيق الذي جرى التحقق منهplanHash وappliedRequestDigest وقائمة appliedWorkloads الخالية من الأسرار. كل مدخل هو هوية حتمية مرتبطة بالتجزئة (hash) تربط حمل العمل ومالك وقت التشغيل والتوزيعات وقناة التنفيذ وبصمات الملفات المشار إليها. استخدمها لتحديد ما ينبغي أن تستهدفه إزالة لاحقة؛ فهي ليست تفويضًا بالإزالة ولا دليلًا على الغياب بمفردها.
منذ v0.21.12، عندما تضع نتيجة التطبيق حمل عمل على أكثر من موقع أو عقدة، سمِّ التوزيع الواحد المحدد الذي تملكه هذه الإزالة. خذ القيم من مدخل appliedWorkloads:
appliedRequestDigest المشترك.
أضف --terminal-evidence-json عندما تحتاج إلى سجل إزالة مقروء آليًا على stdout.
سير العمل الشائعة
تغيير نية StackSpec
حرّر النية المنشورة وأعد توليد المخرجات المحكومة.
النسخ الاحتياطي والاستعادة
أنشئ لقطة idempotent وتمرّن على استرداد مرحلي.
stackkit --help ومساعدة الأمر المحدد للإصدار المثبَّت قبل تنفيذ نسخ احتياطي أو استعادة أو ترقية أو إزالة.
لسير عمل متصل بوكيل، راجع موصّل MCP.