تخطَّ إلى المحتوى
CHAMPREPCHAMPREPCHAMPREP Docs

CLI استكشاف الأخطاء وإصلاحها

ابدأ بمجموعة صغيرة من الفحوصات المحلية والمتعلقة بالمصادقة:

Terminal window
champrep version
champrep config path
champrep config env
champrep auth whoami
champrep auth status

لا تقم بلصق APIالمفاتيح أو رموز المتصفح أو أسرار webhook أو مخرجات التصحيح غير المحجوبة في طلب الدعم.

الأمر غير موجود

Section titled “الأمر غير موجود”

تأكد من وجود الملف الثنائي ومن أنه في PATH:

Terminal window
command -v champrep
echo "$PATH"

يستخدم المثبت المباشر عادةً $HOME/.local/bin لمستخدم غير root. أضف هذا الدليل إلى ملف بدء تشغيل shell وافتح محطة طرفية جديدة. إذا كانت هناك نسخ متعددة مثبتة، فقم بإزالة النسخة الأقدم أو ضع الدليل المقصود أولاً في PATH.

لا يفتح تسجيل الدخول عبر المتصفح

Section titled “لا يفتح تسجيل الدخول عبر المتصفح”

استخدم الموافقة بدون واجهة مستخدم:

Terminal window
champrep auth login --no-browser

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

المصادقة مطلوبة أو غير صالحة

Section titled “المصادقة مطلوبة أو غير صالحة”
Terminal window
champrep auth list
champrep auth whoami

تحقق مما إذا كان CHAMPREP_TOKEN تم تعيينه. وهو يتجاوز سلسلة المفاتيح الخاصة بالعملية الحالية ويمكن أن يجعل CLIيستخدم بيانات اعتماد مختلفة عما هو متوقع.

Terminal window
test -n "$CHAMPREP_TOKEN" && echo "ephemeral token override is active"

لا تقم بطباعة القيمة. قم بتجديد تسجيل الدخول إلى المتصفح أو استبدال مفتاح الأتمتة الملغى حسب الاقتضاء.

حساب أو ملف تعريف أو بيئة خاطئة

Section titled “حساب أو ملف تعريف أو بيئة خاطئة”
Terminal window
champrep auth list
champrep auth switch PROFILE
champrep config env
champrep --env production auth whoami

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

نطاق غير كافٍ أو رفض الوصول

Section titled “نطاق غير كافٍ أو رفض الوصول”

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

  1. تشغيل champrep auth status.
  2. حدد نطاق الخدمة المطلوب للأمر.
  3. راجع المفتاح في لوحة معلومات المفاتيحAPI.
  4. تأكد من أن الملف الشخصي النشط يمكنه تنفيذ نفس الإجراء في واجهة مستخدم الخدمة.
  5. قم بإنشاء مفتاح أو التبديل إلى مفتاح ذي أقل الامتيازات مع النطاق المفقود عندما يكون عبء العمل مخولًا بالحصول عليه.

محدود السرعة

Section titled “محدود السرعة”

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

فشل الشبكة أو الخدمة

Section titled “فشل الشبكة أو الخدمة”

استخدم أولاً الإخراج التفصيلي للبيانات الوصفية فقط:

Terminal window
champrep --verbose auth whoami

--debug يمكن أن يتضمن نصوص الطلبات أو الاستجابات. استخدمه فقط في جهاز طرفي خاضع للرقابة وراجع المخرجات قبل مشاركتها.

تحقق من إعدادات DNS والوكيل وجدار الحماية وفحص TLS. يجبCLI أن يصل إلى CHAMPREP عبرAPI Gateway HTTPS. CHAMPREP_API_URL، عند استخدامه لأغراض التطوير، يجب أن يحدد نقطة نهاية متوافقة مع البوابة وليس خدمة فرديةAPI.

بالنسبة إلى 502, 503، أو 504، أعد محاولة القراءة الآمنة مع تأخير محدود. لا تكرر عمليات الإنشاء أو التحديث أو الإرسال أو الحذف حتى تتأكد من أن الطلب الأول قد أحدث تأثيرًا.

قم بجمع تقرير دعم آمن

Section titled “قم بجمع تقرير دعم آمن”

يرجى تضمين:

  • champrep version الإخراج؛
  • نظام التشغيل والبنية؛
  • اسم الأمر بعد إزالة الحجج الحساسة؛
  • اسم البيئة المحددة؛
  • رمز الخروج؛
  • حالة HTTP ورمز الخطأ الثابت؛
  • الوقت التقريبي والمنطقة الزمنية لحدوث الفشل.

استبعد بيانات الاعتماد والمحتوى الحساس. ثم اتصل بـ CHAMPREP الدعم.