لا ينبغي أن يكون فشل تشغيل CI أول دليل لك على وجود خلل في الإعداد.
قبل أن تُدرج TestSprite في CI، شغّل testsprite doctor. يتحقق من أن مفتاح API لديك، والوصول إلى الشبكة، وإصدار الـ CLI مُعدّة جميعها بشكل صحيح — بحيث لا تتنكر مشكلة إعداد تافهة في هيئة فشل اختبار حقيقي.
مدمج في نفس الـ CLI الذي تستخدمه بالفعل
تحقق من مفتاح API الخاص بك
يتأكد testsprite doctor من أن TESTSPRITE_API_KEY مضبوط وصالح قبل أن تُهدر مهمة CI أول تشغيل لها على خطأ مصادقة.
تحقق من الوصول إلى الشبكة والبروكسي
يمكن لبروكسيات الشركات ومُشغّلات CI المُقفلة أن تحجب الطلبات الصادرة بصمت. يتأكد Doctor من أن الـ CLI يمكنه فعليًا الوصول إلى TestSprite قبل أن تكتشف ذلك في منتصف خط الأنابيب.
تأكد من إصدار الـ CLI
يمكن أن يفشل عدم تطابق الإصدار بين ما هو مثبّت وما يتوقعه خط الأنابيب بطرق تبدو كأنها خطأ في المنتج. يُشير Doctor إلى ذلك قبل أن يحدث.
شغّله في أي مكان
نفس الفحص سواء كنت تُعدّ الإعداد محليًا، أو تُدرج مهمة CI جديدة، أو تُصحّح سبب عدم مصادقة خط أنابيب زميل في الفريق.
$ testsprite doctor Checking environment... ✓ API key found and valid ✓ Network access to TestSprite confirmed ✓ CLI version up to date → environment looks good, ready to run tests $ testsprite doctor Checking environment... ✗ TESTSPRITE_API_KEY not set ✗ Network request blocked — check proxy configuration → fix these before running testsprite test run
لا تدع CI يُصحّح إعدادك نيابة عنك
خط أنابيب يفشل قبل أن يصل حتى إلى اختباراتك لا يختبر شيئًا — إنه يفشل بصوت عالٍ فحسب. تشغيل testsprite doctor أولًا يحوّل «لماذا فشل CI للتو» إلى إجابة تستغرق ثانيتين.
مصمم لإدراج TestSprite في CI
شغّله قبل إدراج CI
أضِف testsprite doctor كأول خطوة في خط الأنابيب لديك — مباشرة بعد التثبيت، وقبل testsprite setup وأي تشغيل اختبار حقيقي.
يقترن بـ testsprite setup
استخدم testsprite setup --from-env --yes --agent <name> لتكوين بيانات الاعتماد بشكل غير تفاعلي، ثم شغّل doctor للتأكد من أنها تعمل فعليًا.
مجاني ومفتوح المصدر
يمنحك npm install -g @testsprite/testsprite-cli الـ CLI. وهو مرخّص بموجب Apache-2.0، لذا لا شيء يمنع فحصًا أوليًا.
مخرجات قابلة للقراءة آليًا
مرّر --output json للحصول على النتائج بصيغة يمكن لخط الأنابيب لديك تحليلها والتصرف بناءً عليها تلقائيًا.
موثوق به من قبل الشركات حول العالم
"يقدم TestSprite إنشاء حالات اختبار غنية، وهيكلًا واضحًا، وكودًا سهل القراءة. كما يدعم تصحيح الأخطاء البسيط عبر الإنترنت مع القدرة على التوسع بسرعة عن طريق إنشاء حالات اختبار جديدة."
"تساعد أتمتة TestSprite في تقليل الكثير من العمل اليدوي. يمكن للمطورين بسهولة اكتشاف الأخطاء وحلها في وقت مبكر من عملية التطوير."
الأسئلة الشائعة
ما الذي يتحقق منه testsprite doctor فعليًا؟
يتحقق من أن مفتاح API لديك مضبوط وصالح، وأن الـ CLI يمكنه الوصول إلى TestSprite عبر شبكتك — بما في ذلك عبر بروكسي — وأن إصدار الـ CLI المثبّت لديك محدّث.
متى ينبغي أن أُشغّله؟
مباشرة بعد تثبيت الـ CLI، ومرة أخرى كأول خطوة في أي خط أنابيب CI جديد — قبل testsprite setup أو تشغيل اختبار حقيقي، بحيث تفشل مشكلة الإعداد بسرعة بدلًا من منتصف خط الأنابيب.
كيف يختلف هذا عن مجرد تشغيل اختبار ورؤية ما ينكسر؟
يبدو تشغيل اختبار فاشل بسبب مفتاح API مفقود أو طلب شبكة محجوب مطابقًا تمامًا لفشل حقيقي في المنتج إلى أن تتعمق في التحقيق. يفصل Doctor بين «إعدادك معطّل» و«منتجك معطّل» قبل أن تُهدر تشغيلًا على السبب الخاطئ.
هل يعمل في CI، أم محليًا فقط؟
كلاهما — إنه نفس الأمر في الحالتين. شغّله محليًا أثناء الإعداد، ثم مرة أخرى كخطوة CI حتى لا تفوتك مشكلة بروكسي أو بيانات اعتماد في بيئة خط الأنابيب.
ماذا لو أشار إلى مشكلة؟
يُشير إلى ما هو خاطئ — TESTSPRITE_API_KEY مفقود، أو مسار شبكة محجوب، أو إصدار CLI قديم — بحيث يمكنك إصلاح ذلك الشيء الواحد بدلًا من تصحيح تشغيل اختبار لم تُتح له فرصة البدء أصلًا.