التكاملات

اربط أنابيب CI حتى يتمكن تشغيل وإعادة تشغيل من بدء البناءات لدى مزوّديك من Tracera.

قبل البدء

1. افتح إعدادات المشروع → التكاملات (تحتاج صلاحية إعدادات المشروع).
2. خزّن رمز Autotest الخاص بالمشروع في أسرار CI — انظر الرموز. لا ترسل Tracera هذا الرمز عند بدء الأنبوب.
3. استخدم محوّلاً يبلّغ النتائج مع تعيين TRACERA_TEST_RUN_ID — انظر المحوّلات.

كيف يعمل

1. ضمن التكاملات اختر إضافة وحدد المزوّد.
2. املأ علامات التبويب المسار والاتصال والمعلمات الاختيارية ثم احفظ.

3. عند تشغيل أو إعادة تشغيل وإذا كان للمشروع أنابيب، تفتح Tracera نافذة التشغيل في CI. اختر حتى 10 أنابيب (المحدّدة مسبقًا تتبع افتراضي).

4. تنشئ Tracera التشغيل ثم تشغّل الأنابيب المحددة. ترسل دائمًا TRACERA_TEST_RUN_ID وTRACERA_BASE_URL وTRACERA_PROJECT_ID (تُتجاهل تجاوزات واجهة المستخدم لهذه المفاتيح). تُضمَّن المعلمات المخصّصة للأنبوب. لا يُرسل Bearer الخاص بـ Autotest.
5. في CI عيّن هذه القيم في بيئة المهمة، واحفظ رمز Autotest في الأسرار، وأبلغ عبر المحوّل مع تعيين TRACERA_TEST_RUN_ID.

يمكن للأنابيب مشاركة اتصال واحد. تحديث الرمز على ذلك الاتصال يحدّث كل أنبوب يستخدمه.

المزوّدون

GitHub Actions

المسار: المستودع (owner/repo)، ملف سير العمل (مثلًا e2e.yml)، المرجع. عنوان URL للخادم اختياري (فارغ = api.github.com).

أعلن TRACERA_TEST_RUN_ID وTRACERA_BASE_URL وTRACERA_PROJECT_ID وأي معلمات مخصّصة كـ inputs في workflow_dispatch داخل ملف workflow. وإلا يرفض GitHub المدخلات غير المتوقعة.

Jenkins

المسار: عنوان URL للمهمة (يجب أن يتضمن مقاطع /job/…). الاتصال: اسم المستخدم ورمز API، والخادم من عنوان URL للمهمة.

GitLab CI

المسار: مشروع GitLab (مسار group/project أو معرّف رقمي) والمرجع. عنوان URL للخادم اختياري (فارغ = gitlab.com).

TeamCity

المسار: معرّف نوع البناء. الاتصال: عنوان URL للخادم (مطلوب) والرمز.

Azure Pipelines

المسار: المؤسسة، مشروع Azure، معرّف المسار، والفرع. عنوان URL للخادم اختياري (فارغ = dev.azure.com).

ذات صلة: إعدادات المشروع، الرموز، المحوّلات.