إجراءات GitHub المتوفرة لتطوير Microsoft Power Platform

تصف الأقسام التالية GitHub Actions for Microsoft Power Platform. تعرض الأقسام أيضًا نماذج لسير عمل GitHub. لمزيد من المعلومات حول GitHub Actions وكيفية تنزيلها، راجع GitHub Actions for Microsoft Power Platform.

تكوين بيانات الاعتماد لاستخدامها مع إجراءات GitHub باستخدام Microsoft Power Platform

هناك إجراءات كثيرة تتطلب منك الاتصال ببيئة Microsoft Dataverse. أضف بيانات اعتماد المستخدم أو كيان الخدمة كأسرار في مستودع GitHub ثم استخدمها في مهام سير العمل الخاصة بك.

• للحصول على تفاصيل حول كيفية إعداد الأسرار في GitHub، راجع الأسرار المشفرة.

• للحصول على تفاصيل حول كيفية إعداد مصادقة كيان الخدمة لـ Microsoft Power Platform، راجع أدوات DevOps Build.

بعد تكوين بيانات الاعتماد، يمكنك استدعاء الكيان الرئيسي للخدمة من داخل البرامج النصية للإجراء.

حدد المعلمات التالية ضمن البرنامج النصي لـ GitHub Action الخاص بك كمتغيرات البيئة:

• معرف التطبيق، مثل: WF_APPLICATION_ID:<your application id>
• معرف المستأجر، مثل: WF_TENANT_ID:<your tenant id>

أضف سر العميل كسرّ في GitHub. أشر إليها من داخل سير العمل باستخدام معلمة مثل: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

مهام المساعد

تتوفر مهمة المساعدة التالية.

إجراءات التثبيت

عندما يفرض سير عمل GitHub Actions تثبيت Power Platform CLI في سياق مشغل، ويحدث خطأ في المهلة، استخدم الإصدار 1 (@v1) مع إجراء إضافي (actions-install) كما هو موضح في المثال التالي.

مهم

• قد يؤدي استخدام الإصدار 1 (@v1) إلى تحديثات لإجراءات GitHub الحالية والتي يمكن أن تؤدي إلى تحديث مهام سير العمل الحالية.
• أضف مهمة تثبيت أدوات Power Platform كمهمة أولى في سير العمل قبل أي GitHub Actions أخرى ل Power Platform.

jobs:
    builds:
        runs-on: windows-latest   # alternate runner OS is: ubuntu-latest

    steps:
    - name: Install Power Platform Tools
        uses: microsoft/powerplatform-actions/actions-install@v1

    - name: Export Solution
         uses: microsoft/powerplatform-actions/export-solution@v1
      with:
         environment-url: 'https://myenv.crm.dynamics.com'
         user-name: 'me@myenv.onmicrosoft.com'
         password-secret: ${{ secrets.MYPASSWORD }}
         solution-name: aSolution
         solution-output-file: 'aSolution.zip'
         working-directory: 'out'

يمكنك العثور على المزيد من عينات GitHub Actions في Power Platform Actions.

whoAmI

يتحقق من اتصال الخدمة عن طريق الاتصال بالخدمة وإرسال طلب WhoAmI [SDK/واجهة API للويب‬]. يمكن أن تكون هذه المهمة مفيدة لتضمينها في وقت مبكر من سير عمل GitHub للتحقق من الاتصال قبل بدء المعالجة.

المعامل	الوصف
URL البيئة	عنوان URL للبيئة التي تتصل بها.
اسم-المستخدم	اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال به.
سر-كلمة المرور	كلمة المرور الخاصة بـ user-name. حدّد كلمات مرور GitHub في الإعدادات ضمن الأسرار. لا يمكنك استرداد سر بعد تعريفه وحفظه.
معرّف التطبيق	معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الكيان الرئيسي للخدمة.
السر الخاص بالعميل	يُستخدم السر الخاص بالعميل لمصادقة مسار عمل GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
معرِف المستأجر	معرف المستأجر عند المصادقة باستخدام app-id وclient-secret.

مهام الحلول

تنفذ هذه المهام الإجراءات على الحلول وتتضمن ما يلي:

استيراد-الحل

يستورد حلاً إلى البيئة الهدف.

معلَمة	الوصف
URL البيئة	(مطلوب) عنوان URL للبيئة الهدف التي تريد استيراد الحل إليها (على سبيل المثال، https://YourOrg.crm.dynamics.com).
اسم-المستخدم	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال.
كلمة-المرور-السرية	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، كلمة المرور الخاصة بالحساب الذي تستخدمه للاتصال.
ملف الحلول	(مطلوب) مسار واسم ملف الحل الذي تريد استيراده.
معرّف التطبيق	معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
client-secret	يُستخدم سر العميل لمصادقة خط أنابيب GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
معرِف المستأجر	معرف المستأجر عند المصادقة باستخدام app-id وclient-secret.

export-solution

يُصدِّر حلاً من البيئة المصدر.

المعامل	الوصف
رابط البيئة	(مطلوب) عنوان URL للبيئة التي تريد تصدير الحل منها (على سبيل المثال، https://YourOrg.crm.dynamics.com).
اسم المستخدم	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال.
مفتاح كلمة المرور	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمة المرور، فكلمة المرور الخاصة بـ user-name. حدّد كلمات مرور GitHub في الإعدادات ضمن الأسرار. لا يمكنك استرداد سر بعد تعريفه وحفظه.
معرّف التطبيق	معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
السر الخاص بالعميل	هو سر العميل المستخدم لمصادقة خط أنابيب GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
معرِف المستأجر	معرف المستأجر عند المصادقة باستخدام app-id وclient-secret.
solution-name	(مطلوب) اسم الحل الذي سيتم تصديره. استخدم دائمًا اسم الحل، وليس اسمه المعروض.
ملف إخراج الحل	(مطلوب) المسار واسم ملف solution.zip الذي تُصدَّر إليه البيئة المصدر.
مُدار	(مطلوب) عيّن هذا الخيار إلى صواب للتصدير كحل مُدار؛ الإعداد الافتراضي (خطأ) هو للتصدير كحل غير مُدار.

استخراج الحل

يأخذ ملف حل مضغوط ويفككه إلى ملفات XML متعددة. يمكنك قراءة هذه الملفات وإدارتها بسهولة أكبر في نظام التحكم بالمصادر.

معلمة	الوصف
ملف الحلول	(مطلوب) المسار واسم الملف لملف solution.zip الذي سيتم فك حزمته.
مجلد الحلول	(مطلوب) المسار والمجلد الهدف حيث تريد فك حزمة الحل.
نوع الحل	(مطلوب) ‬‏‫نوع الحل الذي تريد فك حزمته. تتضمن الخيارات غير مُدار (موصى به)، ومُدار وكلاهما.

pack-solution

يقوم بحزم حل ممثل في التحكم بالمصادر في ملف solution.zip بحيث يمكنك استيراده إلى بيئة أخرى.

معامل	الوصف
ملف الحل (Solution)	(مطلوب) المسار واسم الملف لملف solution.zip لضغط الحل داخله (على سبيل المثال، out/CI/ALMLab.zip).
solution-folder	(مطلوب) المسار والمجلد المصدر للحل الذي سيتم حزمه.
نوع الحل	(اختياري) نوع الحل المراد حزمه. تتضمن الخيارات: غير مُدار (مستحسن)، ومُدار وكلاهما.

نشر الحل

ينشر تخصيصات الحل.

المعامل	الوصف
URL البيئة	(مطلوب) عنوان URL للبيئة التي تريد نشر الحل فيها (على سبيل المثال، https://YourOrg.crm.dynamics.com).
user-name	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال.
كلمة مرور سرية	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، كلمة المرور الخاصة بالحساب الذي تستخدمه للاتصال.
ملف الحل (Solution)	(مطلوب) مسار واسم ملف الحل الذي تريد استيراده.
معرّف التطبيق	معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
السرّ الخاص بالعميل	يُستخدم سر العميل لمصادقة خط أنابيب GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
معرِف المستأجر	معرف المستأجر عند المصادقة باستخدام app-id وclient-secret.

نسخ الحل

استنسخ الحل لبيئة معينة.

معلمة	الوصف
عنوان URL للبيئة	(مطلوب) عنوان URL للبيئة التي تريد استنساخ الحل منها (على سبيل المثال، https://YourOrg.crm.dynamics.com).
اسم المستخدم	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال.
سرّ كلمة المرور	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، كلمة المرور الخاصة بالحساب الذي تستخدمه للاتصال.
ملف الحل	(مطلوب) مسار واسم ملف الحل الذي تريد استيراده.
معرّف التطبيق	معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
سرّ العميل	سر العميل المستخدم لمصادقة خط أنابيب GitHub هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
معرِف المستأجر	معرف المستأجر عند المصادقة باستخدام app-id وclient-secret.
solution-name	(مطلوب) مسار واسم ملف solution.zip اللازم لعملية الاستنساخ (على سبيل المثال، out/CI/ALMLab.zip).
إصدار الحل	إصدار الحل المراد استنساخه.
المجلد الوجهة	المجلد الهدف المراد وضع الحل المستخرج فيه. (على سبيل المثال، مستودع Git\target-solution-folder).
مجلد العمل	مجلد مؤقت للعمل في المخرجات البرمجية قيد العمل اللازمة لاستنساخ الحل. الإعداد الافتراضي: root of the repository

التحقق من صحة الحل

يقوم بالتحقق من ملف الحل لاكتشاف حالات عدم الاتساق.

معلمة	الوصف
عنوان URL للبيئة	(مطلوب) عنوان URL للبيئة التي تريد استنساخ الحل منها (على سبيل المثال، https://YourOrg.crm.dynamics.com).
اسم-المستخدم	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال.
سرّ كلمة المرور	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمة المرور، كلمة مرور الحساب الذي تستخدمه للاتصال به.
معرّف التطبيق	معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد كيان الخدمة.
المفتاح السري للعميل	يُستخدم سر العميل لمصادقة خط أنابيب GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
معرِف المستأجر	معرف المستأجر عند المصادقة باستخدام app-id وclient-secret.
المسار	(مطلوب) مسار واسم ملف الحل الذي تريد التحقق منه.
geo	أي موقع جغرافي لخدمة Microsoft Power Platform Checker يجب استخدامه. القيمة الافتراضية هي 'united states'.
تجاوز على مستوى القاعدة	مسار إلى ملف a يحتوي على صفيف JSON من القواعد ومستوياتها. القيم المقبولة هي: حرجة، عالية، منخفضة، ومعلوماتي. مثال: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
checker-logs-artifact-name	اسم مجلد العناصر الناتجة الذي سيتم تحميل سجلات مدقق Microsoft Power Platform له. القيمة الافتراضية هي "CheckSolutionLogs".

ترقية الحلّ

يرقي الحل.

المعامل	الوصف
عنوان URL للبيئة	(مطلوب) عنوان URL للبيئة التي تريد استنساخ الحل منها (على سبيل المثال، https://YourOrg.crm.dynamics.com).
اسم-المستخدم	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال.
سرّ كلمة المرور	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، كلمة المرور الخاصة بالحساب الذي تستخدمه للاتصال.
ملف Solution	(مطلوب) مسار واسم ملف الحل الذي تريد استيراده.
معرّف التطبيق	معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد كيان الخدمة.
client-secret	سر العميل المستخدم لمصادقة خط أنابيب GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
معرِف المستأجر	معرف المستأجر عند المصادقة باستخدام app-id وclient-secret.
solution-name	(مطلوب) اسم الحل المراد ترقيته.
غير متزامن	يُرقّي الحل بشكل غير متزامن.
max-async-wait-time	أقصى وقت انتظار غير متزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة.

مهام التعبئة

تنفذ هذه المهام إجراءات على الحزم.

توزيع الحزمة

ينشر حزمة DLL أو ملف ZIP مع حزمة.

‏‫ملاحظة‬

يتم دعم هذا الإجراء فقط على Windows.

المعامل	الوصف
رابط البيئة	(مطلوب) عنوان URL للبيئة التي تريد استنساخ الحل منها (على سبيل المثال، https://YourOrg.crm.dynamics.com).
اسم-المستخدم	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال.
سر-كلمة-المرور	(مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، كلمة المرور الخاصة بالحساب الذي تستخدمه للاتصال.
معرّف التطبيق	معرّف التطبيق المستخدم للمصادقة. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
السر الخاص بالعميل	يُستخدم سر العميل لمصادقة خط أنابيب GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
tenant-id	معرف المستأجر عند المصادقة باستخدام app-id وclient-secret.
الحزمة	(مطلوب) المسار إلى ملف DLL أو ZIP الذي يحتوي على حزمة.

مهام البوابة

تقوم هذه المهام بتنفيذ الإجراءات التالية على Power Pages.

upload-paportal

يحمّل البيانات إلى Power Pages.

مَعلمة	الوصف
رابط البيئة	(مطلوب) عنوان URL للبيئة التي تريد استيراد الحل إليها (على سبيل المثال، https://YourOrg.crm.dynamics.com).
معرّف التطبيق	معرّف التطبيق المستخدم للمصادقة. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد كيان الخدمة.
السر الخاص بالعميل	سر العميل المستخدم لمصادقة خط أنابيب GitHub هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد Service Principal.
معرِف المستأجر	معرف المستأجر عند المصادقة باستخدام app-id وclient-secret.
upload-path	المسار حيث يتم تخزين محتوى موقع الويب (الاسم المستعار: -p).
deployment-profile	تحميل بيانات البوابة مع تفاصيل البيئة المحددة عبر متغيرات ملف التعريفs في الملف deployment-profiles/[profile-name].deployment.yaml.
إصدار النموذج	يشير إلى ما إذا كانت بيانات الموقع المراد تحميلها تستخدم نموذج البيانات القياسي () أو 1 (2). القيمة الافتراضية هي 1.

اعرف المزيد حول دعم Microsoft Power Platform CLI لـ Power Pages.

مهام الكتالوج (معاينة)

تنفذ هذه المهام إجراءات مقابل الكتالوج في Power Platform.

‏‫ملاحظة‬

حاليا، مهام الكتالوج ل Power Platform قيد المعاينة.

تثبيت

قم بتثبيت عنصر Catalog في البيئة الهدف.

معامل	الوصف
catalog-item-id	(مطلوب) عنصر الكتالوج المراد تثبيته على البيئة الهدف.
target-url	(مطلوب) عنوان URL للبيئة الهدف لتثبيت عنصر الكتالوج (على سبيل المثال، https://YourOrg.crm.dynamics.com).
إعدادات	(مطلوب) إعدادات حزمة وقت التشغيل ليتمكن إطار عمل التثبيت من التنفيذ. يجب أن يكون تنسيق السلسلة بالتنسيق key=value|key=value.
target-version	الإصدار الهدف الذي يجب تثبيته. إذا لم تحدد إصدارا، يتم تحديد الإصدار المنشور.
poll-status	التحقق من حالة طلبك.

تقديم

اعرض جميع عناصر الكتالوج المنشورة من بيئة Dataverse الحالية (المؤسسة).

معلمة	الوصف
المسار	(مطلوب) مسار إلى مستند إرسال الكتالوج.
package-zip	المسار إلى الملف المضغوط للحزمة.
solution-zip	المسار إلى الملف المضغوط للحل.
poll-status	التحقق الدوري من حالة طلبك.

الحالة

احصل على حالة تثبيت الكتالوج أو طلب الإرسال.

معلمة	الوصف
tracking-id	(مطلوب) معرف تعقب الطلب.
النوع	(مطلوب) نوع الطلب. القيم الصالحة هي Install و Submit.

إنشاء سير عمل GitHub

لمعرفة المزيد حول إنشاء مهام سير عمل GitHub باستخدام GitHub Actions، أكمل مختبرات Microsoft Power Platform الخاصة بـ GitHub Actions.

لمزيد من المعلومات، راجع حول GitHub Actions.

راجع أيضًا

GitHub Actions لـ Microsoft Power Platform