أمر CI

npx intlayer ci <command...>

تم تصميم أمر CI للأتمتة وخطوط أنابيب CI/CD. يقوم بحقن بيانات الاعتماد تلقائياً من متغير البيئة INTLAYER_PROJECT_CREDENTIALS ويمكنه تشغيل أوامر Intlayer عبر مشاريع متعددة في مستودع أحادي.

كيفية العمل

يعمل أمر CI في وضعين:

1. وضع المشروع الواحد: إذا كان الدليل الحالي يطابق أحد مسارات المشاريع في INTLAYER_PROJECT_CREDENTIALS، فإنه يشغل الأمر فقط لهذا المشروع المحدد.

2. وضع التكرار: إذا لم يتم اكتشاف سياق مشروع محدد، فإنه يتكرر عبر جميع المشاريع المُكوّنة ويشغل الأمر لكل واحد منها.

متغير البيئة

يتطلب الأمر تعيين متغير البيئة INTLAYER_PROJECT_CREDENTIALS. يجب أن يحتوي هذا المتغير على كائن JSON يقوم بتعيين مسارات المشاريع إلى بيانات اعتمادها:

{  "packages/app": {    "clientId": "your-client-id-1",    "clientSecret": "your-client-secret-1"  },  "packages/admin": {    "clientId": "your-client-id-2",    "clientSecret": "your-client-secret-2"  }}

اكتشاف مدير الحزم

يكتشف أمر CI تلقائياً مدير الحزم المستخدم (npm أو yarn أو pnpm أو bun) بناءً على متغير البيئة npm_config_user_agent ويستخدم الأمر المناسب لتنفيذ Intlayer.

الوسائط

• <command...>: أمر Intlayer المراد تنفيذه (على سبيل المثال، fill أو push أو build). يمكنك تمرير أي أمر Intlayer ووسائطه.

  مثال: npx intlayer ci fill --verbose

  مثال: npx intlayer ci push

  مثال: npx intlayer ci build

أمثلة

تشغيل أمر في وضع المشروع الواحد

إذا كنت في دليل مشروع يطابق أحد المسارات في INTLAYER_PROJECT_CREDENTIALS:

cd packages/appnpx intlayer ci fill

سيقوم هذا بتشغيل أمر fill مع حقن بيانات الاعتماد تلقائياً لمشروع packages/app.

تشغيل أمر عبر جميع المشاريع

إذا كنت في دليل لا يطابق أي مسار مشروع، سيتكرر الأمر عبر جميع المشاريع المُكوّنة:

cd /path/to/monoreponpx intlayer ci push

سيقوم هذا بتشغيل أمر push لكل مشروع مُكوّن في INTLAYER_PROJECT_CREDENTIALS.

تمرير علامات إضافية

يمكنك تمرير أي علامات إلى أمر Intlayer الأساسي:

npx intlayer ci fill --verbose --mode complete

الاستخدام في خطوط أنابيب CI/CD

في تكوين CI/CD الخاص بك (على سبيل المثال، GitHub Actions أو GitLab CI)، قم بتعيين INTLAYER_PROJECT_CREDENTIALS كسر:

# مثال GitHub Actionsenv:  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}steps:  - name: ملء القواميس    run: npx intlayer ci fill

معالجة الأخطاء

• إذا لم يتم تعيين INTLAYER_PROJECT_CREDENTIALS، فسيخرج الأمر مع خطأ.
• إذا لم يكن INTLAYER_PROJECT_CREDENTIALS JSON صالحاً، فسيخرج الأمر مع خطأ.
• إذا لم يكن مسار المشروع موجوداً، فسيتم تخطيه مع تحذير.
• إذا فشل أي مشروع، فسيخرج الأمر برمز حالة غير صفري.

حالات الاستخدام

• أتمتة المستودع الأحادي: تشغيل أوامر Intlayer عبر مشاريع متعددة في مستودع أحادي
• خطوط أنابيب CI/CD: أتمتة إدارة القواميس في سير عمل التكامل المستمر
• العمليات المجمعة: تنفيذ نفس العملية على مشاريع Intlayer متعددة في وقت واحد
• إدارة الأسرار: إدارة بيانات الاعتماد بشكل آمن لعدة مشاريع باستخدام متغيرات البيئة

أفضل ممارسات الأمان

• قم بتخزين INTLAYER_PROJECT_CREDENTIALS كأسرار مشفرة في منصة CI/CD الخاصة بك
• لا تقم أبداً بإيداع بيانات الاعتماد في التحكم بالإصدارات
• استخدم بيانات اعتماد خاصة بالبيئة لبيئات النشر المختلفة
• قم بتدوير بيانات الاعتماد بانتظام