إجراءات GitHub المتوفرة لتطوير Microsoft Power Platform
يتم وصف إجراءات GitHub ل Microsoft Power Platform في الأقسام التالية. بالإضافة إلى ذلك، عينة مهام سير عمل GitHub معروضة أيضًا. لمزيد من المعلومات حول إجراءات GitHub وكيفية تنزيلها، انتقل إلى إجراءات GitHub لـ Microsoft Power Platform.
تكوين بيانات الاعتماد لاستخدامها مع إجراءات GitHub باستخدام Microsoft Power Platform
هناك إجراءات كثيرة تتطلب منك الاتصال ببيئة Microsoft Dataverse. يمكنك إضافة أصل الخدمة أو بيانات اعتماد المستخدم كأسرار في مستودع GitHub الخاص بك ثم استخدامها في مهام سير العمل.
للحصول على تفاصيل حول كيفية إعداد الأسرار في GitHub، راجع الأسرار المشفرة
للحصول على تفاصيل حول كيفية إعداد مصادقة الخدمة الأساسية لـ Microsoft Power Platform، راجع أدوات بناء DevOps
بمجرد التكوين، يمكنك الاتصال بمدير الخدمة من خلال البرامج النصية للإجراء.
معلمات يتم تعريفها داخل برنامج GitHub Action Script على أنها متغيرات بيئة:
- معرف التطبيق مثل:
WF_APPLICATION_ID:<your application id> - معرف المستاجر، مثل:
WF_TENANT_ID:<your tenant id>
يجب إضافة سر العميل وتخزينه باعتباره GitHub Secret، وسيتم الرجوع إليه من داخل سير العمل باستخدام معلمة مثل: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
مهام المساعد
تم وصف مهمة المساعد المتاحة أدناه.
إجراءات-تثبيت
عندما يحدث خطأ في سير عمل إجراءات GitHub يحدث تثبيت لسطر أوامر Power Platform CLI في سياق برنامج التشغيل، وحدث خطأ انتهاء المهلة، فيجب عليك استخدام الإصدار 1 (@v1) مع إجراء إضافي (actions-install) على النحو التالي.
مهم
- قد يؤدي استخدام الإصدار 1 (@v1) إلى تحديثات لإجراءات GitHub الحالية والتي يمكن أن تؤدي إلى تحديث سير العمل الحالي.
- يجب عليك إضافة مهمة تثبيت Power Platform Tools كمهمة أولى في سير عملك قبل أي إجراءات GitHub أخرى لـ 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 في إجراءات Power Platform.
whoAmI
يتحقق من اتصال الخدمة عن طريق الاتصال بالخدمة وإرسال طلب WhoAmI [SDK/واجهة API للويب]. يمكن أن تكون هذه المهمة مفيدة لتضمينها مبكرًا في سير عمل GitHub، للتحقق من الاتصال قبل بدء المعالجة.
| المعلمة | الوصف |
|---|---|
| عنوان URL البيئة | عنوان URL للبيئة التي تتصل بها. |
| اسم المستخدم | اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال. |
| سر كلمة المرور | كلمة مرور user-name. يتم تعريف كلمات مرور GitHub في الإعدادات ضمن الأسرار. لا يمكنك استرداد أي أسرار بعد تحديدها وحفظها. |
| معرّف التطبيق | معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| سر العميل | يُستخدم سر العميل لمصادقة مسار GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| معرِف المستأجر | معرف المستأجر عند المصادقة باستخدام app-id وclient-secret. |
مهام الحل
تنفذ هذه المهام الإجراءات مقابل الحلول وتتضمن ما يلي:
استيراد الحل
استيراد حل إلى بيئة هدف.
| المعلمة | الوصف |
|---|---|
| عنوان URL البيئة | (مطلوب) عنوان URL للبيئة الهدف التي تريد استيراد الحل إليها (على سبيل المثال، https://YourOrg.crm.dynamics.com). |
| اسم المستخدم | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال. |
| سر كلمة المرور | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، كلمة المرور الخاصة بالحساب الذي تستخدمه للاتصال. |
| ملف الحل | (مطلوب) مسار واسم ملف الحل الذي تريد استيراده. |
| معرّف التطبيق | معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| سر العميل | يُستخدم سر العميل لمصادقة مسار GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| معرِف المستأجر | معرف المستأجر عند المصادقة باستخدام app-id وclient-secret. |
تصدير الحل
تصدير حل من البيئة المصدر.
| المعلمة | الوصف |
|---|---|
| عنوان URL البيئة | (مطلوب) عنوان URL للبيئة الهدف التي تريد تصدير الحل منها (على سبيل المثال، https://YourOrg.crm.dynamics.com). |
| اسم المستخدم | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال. |
| سر كلمة المرور | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمة المرور، كلمة مرور user-name. يتم تعريف كلمات مرور GitHub في الإعدادات ضمن الأسرار. لا يمكنك استرداد أي أسرار بعد تحديدها وحفظها. |
| معرّف التطبيق | معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| سر العميل | يُستخدم سر العميل لمصادقة مسار GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| معرِف المستأجر | معرف المستأجر عند المصادقة باستخدام app-id وclient-secret. |
| اسم الحل | (مطلوب) اسم الحل الذي سيتم تصديره. استخدم دائمًا اسم الحل، وليس اسمه المعروض. |
| ملف إخراج الحل | (مطلوب) المسار واسم ملف solution.zip لتصدير البيئة المصدر إليه. |
| مُدار | (مطلوب) عيّن هذا الخيار إلى صواب للتصدير كحل مُدار؛ الإعداد الافتراضي (خطأ) هو للتصدير كحل غير مُدار. |
فك حزمة الحل
يأخذ ملف حل مضغوط ويفككه إلى ملفات XML متعددة بحيث تصبح إدارة هذه الملفات وقراءتها أكثر سهوله بواسطة نظام التحكم في المصدر.
| المعلمة | الوصف |
|---|---|
| ملف الحل | (مطلوب) المسار واسم الملف لملف solution.zip الذي سيتم فك حزمته. |
| مجلد الحل | (مطلوب) المسار والمجلد الهدف الذي تريد فك حزمة الحل فيه. |
| نوع الحل | (مطلوب) نوع الحل الذي تريد فك حزمته. تتضمن الخيارات: غير مُدار (مستحسن)، ومُدار وكلاهما. |
حزم الحل
تقوم هذه المهمة بحزم حل ممثل في التحكم في المصدر في ملف solution.zip يمكن استيراده إلى بيئة أخرى.
| المعلمة | الوصف |
|---|---|
| ملف الحل | (مطلوب) المسار واسم الملف لملف .solution.zip لحزم الحل إليه (علي سبيل المثال، out/CI/ALMLab.zip). |
| مجلد الحل | (مطلوب) المسار والمجلد المصدر للحل الذي سيتم حزمه. |
| نوع الحل | (اختياري) نوع الحل المراد حزمه. تتضمن الخيارات: غير مُدار (مستحسن)، ومُدار وكلاهما. |
نشر حل
نشر تخصيصات الحل.
| المعلمة | الوصف |
|---|---|
| عنوان URL البيئة | (مطلوب) عنوان URL للبيئة التي تريد نشر الحل فيها (على سبيل المثال، https://YourOrg.crm.dynamics.com). |
| اسم المستخدم | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال. |
| سر كلمة المرور | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، كلمة المرور الخاصة بالحساب الذي تستخدمه للاتصال. |
| ملف الحل | (مطلوب) مسار واسم ملف الحل الذي تريد استيراده. |
| معرّف التطبيق | معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| سر العميل | يُستخدم سر العميل لمصادقة مسار GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| معرِف المستأجر | معرف المستأجر عند المصادقة باستخدام app-id وclient-secret. |
استنساخ الحل
استنساخ الحل لبيئة معينة.
| المعلمة | الوصف |
|---|---|
| عنوان URL البيئة | (مطلوب) عنوان URL للبيئة الهدف التي تريد استنساخ الحل منها (على سبيل المثال، https://YourOrg.crm.dynamics.com). |
| اسم المستخدم | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال. |
| سر كلمة المرور | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، كلمة المرور الخاصة بالحساب الذي تستخدمه للاتصال. |
| ملف الحل | (مطلوب) مسار واسم ملف الحل الذي تريد استيراده. |
| معرّف التطبيق | معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| سر العميل | يُستخدم سر العميل لمصادقة مسار GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| معرِف المستأجر | معرف المستأجر عند المصادقة باستخدام app-id وclient-secret. |
| اسم الحل | (مطلوب) مسار واسم ملف solution.zip المطلوب استنساخه (على سبيل المثال، out/CI/ALMLab.zip). |
| إصدار حل | إصدار الحل المراد استنساخه. |
| المجلد الهدف | المجلد الهدف المراد وضع الحل المستخرج فيه. (على سبيل المثال، مستودع Git\target-solution-folder). |
| دليل العمل | مجلد مؤقت للعمل في العناصر قيد التقدم اللازمة لاستنساخ الحل. الإعداد الافتراضي: root of the repository |
التحقق من الحل
يقوم بالتحقق من ملف الحل لاكتشاف حالات عدم الاتساق.
| المعلمة | الوصف |
|---|---|
| عنوان URL البيئة | (مطلوب) عنوان URL للبيئة الهدف التي تريد استنساخ الحل منها (على سبيل المثال، https://YourOrg.crm.dynamics.com). |
| اسم المستخدم | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال. |
| سر كلمة المرور | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، كلمة المرور الخاصة بالحساب الذي تستخدمه للاتصال. |
| معرّف التطبيق | معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| سر العميل | يُستخدم سر العميل لمصادقة مسار GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| معرِف المستأجر | معرف المستأجر عند المصادقة باستخدام app-id وclient-secret. |
| path | (مطلوب) مسار واسم ملف الحل الذي تريد التحقق منه. |
| جغرافي | الموقع الجغرافي لخدمة مدقق Microsoft Power Platform المراد استخدامها. القيمة الافتراضية هي "الولايات المتحدة". |
| تجاوز مستوى القاعدة | مسار إلى ملف يحتوي على صفيف قواعد 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). |
| اسم المستخدم | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال. |
| سر كلمة المرور | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، كلمة المرور الخاصة بالحساب الذي تستخدمه للاتصال. |
| ملف الحل | (مطلوب) مسار واسم ملف الحل الذي تريد استيراده. |
| معرّف التطبيق | معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| سر العميل | يُستخدم سر العميل لمصادقة مسار GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| معرِف المستأجر | معرف المستأجر عند المصادقة باستخدام app-id وclient-secret. |
| اسم الحل | (مطلوب) اسم الحل المراد ترقيته. |
| غير متزامن | ترقية الحل بشكل غير متزامن. |
| max-async-wait-time | أقصى وقت انتظار غير متزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة. |
حزم المهام
تقوم هذه المهام بتنفيذ إجراءات مقابل الحزم وتتضمن ما يلي.
نشر الحزمة
توفير القدرة على نشر حزمة dll أو ملف مضغوط مع حزمة.
ملاحظة
هذا الإجراء مدعوم فقط على Windows.
| المعلمة | الوصف |
|---|---|
| عنوان URL البيئة | (مطلوب) عنوان URL للبيئة الهدف التي تريد استنساخ الحل منها (على سبيل المثال، https://YourOrg.crm.dynamics.com). |
| اسم المستخدم | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، اسم المستخدم الخاص بالحساب الذي تستخدمه للاتصال. |
| سر كلمة المرور | (مطلوب) إذا كنت تستخدم مصادقة اسم المستخدم/كلمه المرور، كلمة المرور الخاصة بالحساب الذي تستخدمه للاتصال. |
| معرّف التطبيق | معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| سر العميل | يُستخدم سر العميل لمصادقة مسار GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| معرِف المستأجر | معرف المستأجر عند المصادقة باستخدام app-id وclient-secret. |
| الحزمة | (مطلوب) المسار إلى ملف dll للحزمة أو ملف مضغوط مع حزمة. |
مهام المدخل
تقوم هذه المهام بتنفيذ الإجراءات التالية في مقابل Power Pages.
upload-paportal
تحميل البيانات إلى Power Pages.
| المعلمة | الوصف |
|---|---|
| عنوان URL البيئة | (مطلوب) عنوان URL للبيئة التي تريد استيراد الحل إليها (على سبيل المثال، https://YourOrg.crm.dynamics.com). |
| معرّف التطبيق | معرّف التطبيق المراد المصادقة به. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| سر العميل | يُستخدم سر العميل لمصادقة مسار GitHub. هذه المعلمة مطلوبة عند المصادقة باستخدام بيانات اعتماد الخدمة الأساسية. |
| معرِف المستأجر | معرف المستأجر عند المصادقة باستخدام 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 | (مطلوب) عنصر الكتالوج الذي سيتم تثبيته في البيئة الهدف. |
| عنوان url الهدف | (مطلوب) عنوان URL للبيئة الهدف لتثبيت عنصر الكتالوج فيها (على سبيل المثال، "https://YourOrg.crm.dynamics.com"؛). |
| إعدادات | (مطلوب) إعدادات حزمة وقت التشغيل لإطار عمل التثبيت المراد تنفيذه. يجب أن يكون تنسيق السلسلة key=value|key=value. |
| target-version | الإصدار الهدف الذي يجب تثبيته. يتم تحديد الإصدار المنشور، في حالة كان هذا الخيار فارغًا. |
| poll-status | استقصاء للتحقق من حالة طلبك. |
إرسال
قائمة بجميع عناصر الكتالوج المنشورة من بيئة Dataverse الحالية (المؤسسة).
| المعلمة | الوصف |
|---|---|
| path | (مطلوب) مسار إلى مستند إرسال الكتالوج. |
| package-zip | المسار إلى الملف المضغوط للحزمة. |
| solution-zip | المسار إلى الملف المضغوط للحل. |
| poll-status | استقصاء للتحقق من حالة طلبك. |
الحالة
احصل على حالة طلب تثبيت/إرسال Catalog.
| المعلمة | الوصف |
|---|---|
| tracking-id | (مطلوب) معرف تعقب الطلب. |
| النوع | (مطلوب) نوع الطلب (القيم: تثبيت، إرسال) |
تأليف سير عمل GitHub
لمعرفة المزيد حول إنشاء مهام سير عمل GitHub باستخدام إجراءات GitHub، أكمل إجراءات GitHub لمعامل Microsoft Power Platform.
مزيد من المعلومات: حول إجراءات GitHub.