تشغيل خط أنابيب Circleci

ملحوظة

لا يدعم إجراء GitHub هذا حتى الآن مشاريع CircleCI المدمجة مع تطبيق CircleCI GitHub. إذا كان عنوان URL لمشروع CircleCI الخاص بك يبدو كما يلي: https://app.circleci.com/projects/organizations/circleci% ، فأنت تقوم بالتكامل مع تطبيق CircleCI GitHub ولم يتم دعم إجراء GitHub هذا بعد. اتصل بـ [email protected] إذا كانت لديك أية أسئلة/تعليقات. إذا كان عنوان URL لمشروع CircleCI الخاص بك يبدو كما يلي: https://app.circleci.com/projects/project-dashboard/github/ ، فأنت تستخدم تكامل تطبيق OAuth الخاص بـ CircleCI ويتم دعم إجراء GitHub هذا.

خط أنابيب الزناد CircleCI

قم بتشغيل خطوط أنابيب CircleCI الخاصة بك من أي حدث على GitHub باستخدام GitHub Actions.

كيفية الاستخدام

1. قم بإنشاء سير عمل GitHub Action لخط أنابيب CircleCI المطلوب.

   قم بذلك عن طريق إضافة ملف YAML لسير العمل (سنستخدم main.yml ) إلى ./.github/workflows .

   يظهر مشغل release في هذا المثال. جرب أيًا من أحداث GitHub لبدء سير العمل: https://docs.github.com/en/actions/learn-github-actions/events-that-trigger-workflows

   حدد اسمًا ومعرفًا مخصصين لخطوة البيانات التعريفية السياقية الإضافية في مسار CircleCI الخاص بك

 على: الإصدار: الأنواع: [منشورة] الوظائف: مشغل الدوائر: يعمل على: أحدث خطوات أوبونتو:
      - الاسم: معرف <تخصيص الاسم>: يستخدم <تخصيص المعرف>: CircleCI-Public/[email protected] env: CCI_TOKEN: ${{ Secrets.CCI_TOKEN }}

2. قم بإنشاء سر مشفر باسم CCI_TOKEN يحتوي على رمز API الشخصي الذي سيتم استخدامه لتشغيل خطوط الأنابيب. يُقترح أن يكون هذا مستخدمًا للجهاز.

3. أضف تعريفات معلمات خط الأنابيب إلى تكوين CircleCI الخاص بك. سيتم إدخال هذه البيانات بواسطة GitHub Action عند تشغيلها.

   أضف ما يلي إلى أعلى ملف .circleci/config.yml الخاص بك. تأكد من تحديد الإصدار 2.1

    الإصدار: 2.1 المعلمات: GHA_Actor: النوع: السلسلة الافتراضية: "" GHA_Action: النوع: السلسلة الافتراضية: "" GHA_Event: النوع: السلسلة الافتراضية: "" GHA_Meta: النوع: السلسلة الافتراضية: ""

4. استخدم بيانات معلمة خط الأنابيب لتشغيل مهام سير العمل بشكل مشروط.

   انظر: أمثلة

المدخلات

معلمات الإدخال الاختيارية التي تسمح لك بتحديد بيانات التعريف الإضافية.

GHA_Meta

المطلوب: كاذب

الوصف : معلمة بيانات تعريف إضافية اختيارية. سيكون متاحًا على خط أنابيب CircleCI باسم GHA_Meta.

 الوظائف: مشغل الدوائر: التشغيل: أحدث خطوات أوبونتو:
      - الاسم: معرف <تخصيص الاسم>: يستخدم <تخصيص المعرف>: CircleCI-Public/[email protected] مع: GHA_Meta: "" env: CCI_TOKEN: ${{ Secrets.CCI_TOKEN }}

الهدف سبيكة

المطلوب: كاذب

الوصف : سبيكة مشروع CircleCI للمشروع المستهدف (على سبيل المثال: github// ). إذا لم يتم تحديده، فسيتم استخدام الارتباط الثابت لمستودع GitHub الحالي.

 الوظائف: مشغل الدوائر: التشغيل: أحدث خطوات أوبونتو:
      - الاسم: معرف <تخصيص الاسم>: يستخدم <تخصيص المعرف>: CircleCI-Public/[email protected] مع: target-slug: "gh//" # سيتم تشغيله خط الأنابيب لبيئة المشروع الخارجية: CCI_TOKEN: ${{ Secrets.CCI_TOKEN }}

النواتج

مجال	نوع البيانات	وصف
id	سلسلة (uuid)	المعرف الفريد لخط الأنابيب.
state	سلسلة (التعداد: "تم الإنشاء" "خطأ" "الإعداد معلق" "الإعداد" "معلق")	الوضع الحالي لخط الأنابيب.
number	عدد صحيح (int64)	عدد خط الانابيب.
created_at	سلسلة (التاريخ والوقت)	تاريخ ووقت إنشاء خط الأنابيب.

أشياء يجب معرفتها

تعمل GitHub Actions جنبًا إلى جنب مع تكامل CircleCI الأصلي.

افتراضيًا، عندما يكون المستودع متصلاً بـ CircleCI، إذا كانت مسارات العمل ضمن تكوين هذا المشروع لا تحدد أي شروط أو مرشحات من شأنها أن تمنع التنفيذ، فسيتم تنفيذ سير العمل في كل حدث push بشكل افتراضي.

قد يعني هذا أنه من الممكن تشغيل مهمة مرتين عن طريق الخطأ، مرة واحدة في حدث push من CircleCI، بالإضافة إلى الأحداث الأخرى التي يتم تشغيلها بواسطة إجراء GitHub.

لمنع التنفيذ المزدوج

إذا كنت تعتمد على GitHub Actions لتوفير جميع مشغلات واجهة برمجة التطبيقات الخاصة بك، فتأكد من أن كل سير عمل لتكوين CircleCI الخاص بك يحتوي على حد شرطي لتنفيذه على مشغل GitHub Action فقط.

مثال

 سير العمل: # تم تعيين سير العمل هذا ليتم تشغيله بشكل مشروط، # فقط عبر إجراء GitHub.  # مع عدم وجود مسارات عمل أخرى لم تتم تصفيتها، سيتم تجاهل أحداث الدفع العادية.  الاختبار: عندما: وظائف << Pipeline.parameters.GHA_Action >>:
      - امتحان