برنامج تعليمي: نشر الحل التلقائي باستخدام إجراءات GitHub لـ Microsoft Power Platform

في هذا البرنامج التعليمي، سوف تتعلم كيفية:

بإمكان عمليات سير العمل تصدير تطبيقك تلقائيًا (كحل غير مدار) من بيئة تطوير، وإنشاء مصطنع بنية (حل مُدار)، ونشر التطبيق في بيئة الإنتاج. يستخدم هذا البرنامج التعليمي حل ALMLab الذي قمت بإنشائه والبيئات التي قمت بإعدادها في البرامج التعليمية السابقة.

البرامج التعليمية ذات الصلة: الشروع في العمل، وإنشاء تطبيق يستند إلى النموذج.

إنشاء حساب GitHub

1. انتقل إلى https://github.com، وانقر فوق تسجيل أو بدء إصدار تجريبي مجاني (أو سجل دخولك ذا كان لديك حساب موجود).

   

2. بعد إنشاء حسابك، أنشئ مستودعًا من خلال تحديد إنشاء مستودع أو جديد.

   

   قد ترى الشاشة المقصودة البديلة التالية:

   

3. أنشئ مستودعك الجديد وقم بتسميته باسم 'poweractionslab'. تأكد من تحديد إضافة ملف تمهيدي لبدء المستودع واختر إنشاء مستودع.

   

إنشاء سر جديد لمصادقة مدير الخدمة

1. انتقل إلى المستودع الخاص بك وانقر فوق إعدادات، ثم قم بتوسيع الأسرار، ثم انقر فوق إجراءات.

2. في صفحة الأسرار، قم بتسمية السر باسم 'PowerPlatformSPN'. استخدم سر العميل من تسجيل التطبيق الذي تم إنشاؤه في Microsoft Entra وأدخله في حقل القيمة، ثم حدد إضافة سر. ستتم الإشارة إلى سر العميل في ملفات YML المستخدمة لتحديد مهام سير عمل GitHub لاحقًا في هذا المعمل.

   

   يتم الآن تخزين سر العميل بأمان كسر GitHub.

إنشاء سير عمل لتصدير وفك حزمة ملف الحل إلى فرع جديد

1. انقر فوق إجراءات وانقر فوق إعداد سير عمل بنفسك أو انقر فوق تكوين في مربع سير عمل بسيط ضمن قسم المقترح لهذا المستودع.

   

2. سيؤدي هذا إلى بدء ملف YAML جديد مع سير عمل أساسي لمساعدتك على الشروع في العمل مع إجراءات GitHub.

   

3. احذف المحتوى الذي تم إنشاؤه في وقت سابق، والصق المحتوى من الملف export-and-branch-solution-with-spn-auth.yml، ثم غيّر اسم الملف إلى 'export-and-branch-solution'.yml.

   

4. حدّث <ENVIRONMENTURL> بواسطة عنوان URL لبيئة التطوير التي تريد التصدير منها (على سبيل المثال: https://poweractionsdev.crm.dynamics.com).

5. حدّث <APPID> و<TENANT ID> بواسطة قيمك.

   • إذا كنت تستخدم بيانات اعتماد، فالصق ملف export-and-branch-solution.yml بدلاً من محتويات ملف export-and-branch-solution-with-spn-auth.yml. حدّث <USERNAME> بواسطة اسم المستخدم الذي تستخدمه للاتصال بالبيئة.

     

   تلميح

   إذا لم تكن معتادًا على إجراءات GitHub وتريد معرفة المزيد، فراجع الوثائق الرسمية على https://docs.github.com/en/actions.

6. أنت الآن جاهز للالتزام بتغييراتك. حدد بدء الالتزام، واكتب إنشاء yml‏‎ التصدير في حقل العنوان، ثم أضف وصفًا (اختياري). بعد ذلك، انقر فوق الالتزام بملف جديد.

   

تهانينا، لقد انتهيت الآن من إنشاء أول سير عمل لك في GitHub باستخدام الإجراءات التالية:

• من أنا: يضمن أنه يمكنك الاتصال بنجاح بالبيئة التي تقوم بالتصدير منها.
• تصدير الحل: تصدير ملف الحل من بيئة التطوير الخاصة بك.
• فك الحزم: ملف الحل الذي يتم تصديره من الخادم هو ملف مضغوط (مضغوط) مع ملفات تكوين مدمجة. هذه الملفات الأولية غير مناسبة لإدارة التعليمات البرمجية المصدر نظرًا لعدم بنائها لتمكين أنظمة إدارة التعليمات البرمجية المصدر من إجراء التمييز بطريقة صحيحة على الملفات وتسجيل التغييرات التي تريدها للالتزام بعنصر تحكم المصدر. تحتاج إلى "فك حزمة" ملفات الحلول لجعلها مناسبة لتخزين ومعالجة عنصر تحكم المصدر.
• حل الفرع: إنشاء فرع جديد لتخزين الحل المصدر.

اختبار التصدير وفك حزمة سير العمل

1. بعد ذلك، اختبر تشغيل سير العمل. انتقل إلى الإجراءات، تشغيل سير العمل، واختر تشغيل سير العمل. إذا كان لديك اسم حل مختلف عن "ALMLab"، فقم بتغيير القيمة هنا ولكن اترك القيم الأخرى كما هي.

   

2. سيبدأ سير العمل بعد مرور 5 إلى 10 ثوان، ويمكنك تحديد سير العمل قيد التشغيل لمراقبة التقدم.

   

   

3. بعد اكتمال سير العمل، تأكد من إنشاء فرع جديد مع فك الحل إلى المجلد solutions/ALMLab. انتقل إلى علامة التبويب Code وقم بتوسيع القائمة المنسدلة للفروع.

4. حدد الفرع الذي تم إنشاؤه بواسطة الإجراء.

5. تحقق من إنشاء المجلد solutions/ALMLab في الفرع الجديد ثم إنشاء طلب سحب لدمج التغييرات في الفرع الرئيسي. انقر فوق مساهمة وفي القائمة المنبثقة انقر فوق فتح طلب السحب.

6. في شاشة فتح طلب سحب، أضف عنوانا ووصفا، حسب رغبتك، ثم انقر فوق إنشاء طلب سحب.

7. سيتم تحديث الشاشة التي تظهر طلب السحب الذي تم إنشاؤه حديثا. سيتم تقديم تأكيد عند إنشاء طلب السحب يوضح أن فرعنا لا يوجد تعارض مع فرعنا الرئيسي. يعني هذا التأكيد أنه يمكن دمج التغييرات في الفرع الرئيسي تلقائيًا. انقر فوق دمج طلب السحب ثم انقر فوق تأكيد الدمج . بشكل اختياري، انقر فوق حذف فرع لتنظيف الفرع الذي تم حذفه الآن.

   

8. انتقل مرة أخرى إلى الفرع الافتراضي (الرئيسي) وتحقق من صحة الحل متاح الآن هناك أيضًا.

إنشاء سير عمل قابل لإعادة للاستخدام لإنشاء بيانات اصطناعية واستيرادها للإنتاج

في هذا القسم، سننشئ سير عمل إضافيًا يقوم بما يلي:

• إنشاء حل مُدار ونشره كمصطنع GitHub
• استيراد مصطنع البنية إلى بيئة الإنتاج

1. انتقل إلى الإجراءات وحدد سير عمل جديد.

   

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

   

3. أعد تسمية عنوان سير العمل إلى 'release-solution-to-prod-with-inputs' وانسخ المحتوى من الملف release-solution-to-prod-with-inputs.yml والصقه في الشاشة تحرير الملف الجديد.

   

4. التزم بالتغييرات. اختر بدء الالتزام، ثم أضف عنوانًا ووصفًا (اختياري). بعد ذلك، حدد الالتزام بملف جديد.

   

استدعاء سير العمل القابل لإعادة الاستخدام في حدث الإصدار

في هذا القسم، سنستدعي سير العمل القابل لإعادة للاستخدام على حدث الإصدار.

1. انتقل إلى الإجراءات وحدد سير عمل جديد.

   

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

   

3. أعد تسمية عنوان سير العمل إلى 'release-action-call' وانسخ المحتوى من الملف release-action-call.yml والصقه في الشاشة تحرير الملف الجديد.

   

4. حدّث المتغيرات التالية في ملف سير العمل الجديد:

   • حدّث <BUILD_ENVIRONMENT> بواسطة عنوان URL لبيئة البناء التي تستخدمها لإنشاء الحل مُدار. على سبيل المثال: https://poweractionsbuild.crm.dynamics.com.
   • حدّث <PROD_ENVIRONMENT> بواسطة عنوان URL لبيئة الإنتاج التي تقوم بالنشر اليها. على سبيل المثال: https://poweractionsprod.crm.dynamics.com.
   • قم بتحديث <APP_ID> باستخدام معرف التطبيق (العميل) الذي يمكن العثور عليه في شفرة تسجيلات التطبيق في مدخل Microsoft Azure بالنقر فوق التسجيل الذي تم إنشاؤه مسبقًا في هذا البرنامج التعليمي.
   • قم بتحديث <TENANT_ID> باستخدام معرف الدليل (المستأجر) الذي يمكن العثور عليه في شفرة تسجيلات التطبيق في مدخل Microsoft Azure بالنقر فوق التسجيل الذي تم إنشاؤه مسبقًا في هذا البرنامج التعليمي.

5. التزم بالتغييرات. اختر بدء الالتزام، ثم أضف عنوانًا (اختياري) ووصفًا (اختياري). بعد ذلك، حدد الالتزام بملف جديد.

   

اختبار الإصدار إلى سير عمل الإنتاج

أنت الآن جاهز لاختبار سير العمل الأخير. يتم تشغيل سير العمل هذا عندما يتم نشر إصدار جديد إلى الإنتاج.

1. انتقل إلى الإصدارات.

   

2. حدد إنشاء مسودة إصدار جديد.

3. أضف علامة إصدار وعنوانًا واختر نشر الإصدار.

4. حدد الإجراءات لعرض سير العمل قيد التشغيل.

   

5. اختر سير العمل قيد التشغيل لعرض الإجراءات أثناء تشغيلها.

   

6. انتظر حتى اكتمال كل إجراء.

   

7. بعد اكتمال سير العمل، عمل بتسجيل الدخول إلى بيئة الإنتاج وتحقق من نشر الحل كحل مُدار.

نشر التحديث ومراجعة التغييرات قبل إصدار الإنتاج

سنقوم الآن باختبار العملية الشاملة، ثم الاطلاع على كيفية عرض التغييرات التي تم إدخالها على أحد التطبيقات والتحقق من صحتها قبل نشرها في بيئة الإنتاج.

1. انتقل إلى حل ALMLab في بيئة التطوير الخاصة بك واختر تحرير أو انقر فوق اسم عرض الحلول.

   

2. حدد جدول طلب الإجازة واعرضه.

   

3. انقر فوق + إضافة عمود وأنشئ العمود الجديد كما هو موضح في الشكل أدناه.

   

   قيم الحقول المحدثة:**

   • اسم العرض: تمت الموافقة عليه
   • نوع البيانات: نعم / لا

4. انقر فوق تم .

5. انقر فوق حفظ الجدول

6. انتقل مرة أخرى إلى علامة التبويب إجراءات في مستودعات GitHub الخاصة بك، واختر تشغيل سير العمل، وحدد الزر تشغيل سير العمل.

   

7. سيبدأ سير العمل بعد مرور 5 إلى 10 ثوان، ويمكنك النقر على سير العمل قيد التشغيل لمراقبة تقدمه.

   

   

8. بعد اكتمال سير العمل، انتقل إلى الفرع الجديد بتحديد تعليمات برمجية ثم الفروع.

   

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

10. أضف عنوانا (اختياريا) ثم انقر فوق إنشاء طلب سحب.

11. بعد تحديث المحتوى، انقر فوق علامة التبويب الملفات التي تم تغييرها.

12. لاحظ تمييز التغييرات التي تم إدخالها علي الحل باللون الأخضر للإشارة إلى إضافة هذا القسم من الملف عند المقارنة بالملف نفسه في الفرع الرئيسي.

13. انتقل للخلف إلى علامة التبويب المحادثة. حدد طلبات السحب ثم حدد طلب السحب الذي تم إنشاؤه مسبقا.

14. في صفحة طلب السحب، حدد سكواش ودمج لدمج ملف الحل المحدث في فرعك الرئيسي، وحذف اختياريا الطلب الذي تم دمجه الآن في الملف الرئيسي.

    

15. اتبع الخطوات الواردة في القسم اختبار الإصدار إلى سير عمل الإنتاج‬ لإنشاء إصدار جديد والتحقق من نشر الحل المحدث إلى بيئة الإنتاج.

تهانينا، لقد نجحت في إعداد عينة سير عمل CI/CD باستخدام إجراءات GitHub!

راجع أيضًا:

أتمتة سير عملك من فكرة إلى الإنتاج