وثائق أصول Core

توثيق محرك حالة العالم الحتمي ومراجع API.

وثائق بوابة القرار

دليل مشغل ACCTL

ACCTL هو واجهة المشغل المعتمدة لـ Asset Core. تم تصميمه للتشخيص، والتحقيق، والاسترداد عندما تفشل الأتمتة أو التكاملات. استخدمه للتحقق من الثوابت، وفحص الحالة، واستعادة السيطرة أثناء الحوادث.

هذا الدليل موجه نحو المهام. يفترض أنك تعرف بالفعل كيفية تثبيت ACCTL؛ للحصول على كتالوج الأوامر، راجع مرجع CLI.

تشخيص البيئة

قبل التعمق في تصحيح الأخطاء، تحقق من تكوين الاتصال وموصل الخدمة:

acctl diag --print-config

هذا يتحقق من مسارات التكوين، والوصول إلى سجل الالتزام، وإشارات الجاهزية الأساسية.

تحقق من التفويض والأذونات

أكد الأذونات الحالية والرئيسية الفعالة:

acctl auth whoami
acctl auth permissions --namespace-id 5001

استخدم هذه الأوامر قبل محاولة تنفيذ عمليات ذات امتيازات أو تغييرات في الحوكمة.

تدقيق الالتزامات الأخيرة

افحص تاريخ الالتزامات الأخيرة لفهم ما الذي تغير ومتى:

acctl query-commits --namespace 5001 --limit 20

للحاوية الواحدة:

acctl query-container-commits --namespace 5001 --container-id 1001 --limit 20

تتبع سجل الظرف

عندما تحتاج إلى تفاصيل جنائية منخفضة المستوى، تابع سجل الظرف مباشرة:

acctl tail --envelope-log /path/to/envelope.log --follow

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

إعادة التشغيل للتحقق من الصحة

إعادة تشغيل مجموعة من الحزم في وضع عدم الاتصال للتحقق من الحتمية وتأكيد أن الفشل يمكن تكراره:

acctl replay --envelope-log /path/to/envelope.log --from 0 --to 2000

إعادة التشغيل لا تتطلب وجود دايمون ويجب أن تكون جزءًا من سير العمل بعد الحادث.

تجميد أو تصريف مساحة الاسم

إذا كنت بحاجة إلى إيقاف الكتابة أثناء حادث، قم بضبط الحالة التشغيلية أو دورة الحياة:

acctl namespaces operational --namespace-id 5001 --write-mode read-only --reason "incident freeze"

قم دائمًا بتوثيق السبب وتأكد من أن المشغلين المتاحين على مدار الساعة يعرفون إجراء التراجع.

إنشاء حزمة تصحيح الأخطاء

عندما تكون هناك حاجة للتصعيد، قم بالتقاط حزمة قابلة للمشاركة من السجلات والقطع الأثرية:

acctl bundle-debug --config /path/to/write.toml --output debug-bundle.tar.gz

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