הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
הסעיפים הבאים מתארים GitHub Actions עבור Microsoft Power Platform. הסעיפים מציגים גם זרימות עבודה לדוגמה ב-GitHub. לקבלת מידע נוסף על GitHub Actions וכיצד להוריד אותם, ראה GitHub Actions עבור Microsoft Power Platform.
קביעת תצורה של אישורים לשימוש עם 'פעולות GitHub' עם Microsoft Power Platform
פעולות רבות דורשות חיבור אל סביבה של Microsoft Dataverse. הוסף אישורי service principal או משתמש כסודות במאגר GitHub שלך ולאחר מכן השתמש בהם בזרימות העבודה שלך.
לקבלת פרטים על אופן הגדרת סודות ב- GitHub, ראה סודות מוצפנים.
לקבלת פרטים אודות אופן ההגדרה של אימות באמצעות ישות שירות עבור Microsoft Power Platform, ראה כלי Build של DevOps.
לאחר קביעת התצורה של האישורים, באפשרותך לקרוא ל-service principal מתוך קבצי ה-Script של הפעולה.
הגדר את הפרמטרים הבאים בתוך סקריפט 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 בהקשר של runner, ותתרחש שגיאת זמן קצוב, השתמש בגירסה 1 (@v1) עם פעולה נוספת (actions-install) כפי שמוצג בדוגמה הבאה.
חשוב
- שימוש בגרסה 1 (@v1) עשוי להוביל לעדכונים ב-GitHub Actions קיימים שיכולים לגרום לעדכון זרימות עבודה נוכחיות.
- הוסף את המשימה Install 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 Actions ב-Power Platform Actions.
whoAmI
אימות חיבור השירות על-ידי חיבור אל השירות ושליחת בקשת WhoAmI [SDK/Web API]. יכול להיות שימושי לכלול את המשימה הזו בשלב מוקדם בתהליך העבודה ב-GitHub כדי לאמת את הקישוריות לפני תחילת העיבוד.
| פרמטר | תיאור |
|---|---|
| environment-url | כתובת ה- URL של הסביבה שאליה אתה מתחבר. |
| user-name | שם המשתמש של החשבון שבו אתה משתמש כדי להתחבר. |
| password-secret | הסיסמה עבור user-name. הגדר סיסמאות GitHub ב-הגדרות תחת סודות. לא ניתן לאחזר סוד לאחר הגדרתו ושמירתו. |
| app-id | מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| client-secret | סוד הלקוח המשמש לאימות ה-pipeline של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| tenant-id | מזהה דייר בעת אימות עם app-id ו-client-secret. |
משימות בפתרון
משימות אלה מבצעות פעולות מול פתרונות וכוללות את הבאים.
import-solution
מייבא פתרון לסביבת יעד.
| פרמטר | תיאור |
|---|---|
| environment-url | (נדרש) כתובת ה- URL עבור סביבת היעד שאליה ברצונך לייבא את הפתרון (למשל, https://YourOrg.crm.dynamics.com). |
| user-name | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, שם המשתמש של החשבון שבו אתה משתמש כדי להתחבר. |
| password-secret | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, הסיסמה עבור החשבון שבו אתה משתמש כדי להתחבר. |
| solution-file | (נדרש) הנתיב והשם של קובץ הפתרון שברצונך לייבא. |
| app-id | מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| client-secret | סוד הלקוח המשמש לאימות ה-pipeline של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| tenant-id | מזהה הדייר בעת אימות עם app-id ו- client-secret. |
export-solution
מייצא פתרון מסביבת המקור.
| פרמטר | תיאור |
|---|---|
| environment-url | (נדרש) כתובת ה- URL עבור הסביבה שממנה ברצונך לייצא את הפתרון (למשל, https://YourOrg.crm.dynamics.com). |
| user-name | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, שם המשתמש של החשבון שבו אתה משתמש כדי להתחבר. |
| password-secret | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, זוהי הסיסמה עבור user-name. הגדר סיסמאות GitHub ב-הגדרות תחת סודות. לא ניתן לאחזר סוד לאחר שהוגדר ונשמר. |
| app-id | מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| client-secret | סוד הלקוח המשמש לאימות צינור עיבוד של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות. |
| tenant-id | מזהה דייר בעת אימות עם app-id ו-client-secret. |
| solution-name | (חובה) שם הפתרון שיש לייצא. השתמש תמיד ב-name של הפתרון, ולא בשם התצוגה שלו. |
| solution-output-file | (נדרש) הנתיב ושם הקובץ solution.zip שאליו יש לייצא את סביבת המקור. |
| מנוהל | (נדרש) הגדר כ- True כדי לייצא כפתרון מנוהל; ברירת המחדל (False) היא לייצא כפתרון לא מנוהל. |
unpack-solution
לוקח קובץ פתרון דחוס ומפרק אותו לקובצי XML מרובים. ניתן לקרוא ולנהל קבצים אלה ביתר קלות במערכת בקרת מקור.
| פרמטר | תיאור |
|---|---|
| solution-file | (חובה) ציין את הנתיב ואת שם הקובץ של הקובץ solution.zip שיש לפרק את אריזתו. |
| solution-folder | (נדרש) הנתיב ותיקיה היעד שבהם ברצונך לבטל את אריזת הפתרון. |
| solution-type | (חובה) סוג הפתרון שברצונך לחלץ. האפשרויות כוללות לא מנוהל (מומלץ), מנוהל, או שניהם. |
pack-solution
אורז פתרון המיוצג בבקרת מקור לקובץ solution.zip שניתן לייבא לסביבה אחרת.
| פרמטר | תיאור |
|---|---|
| solution-file | (נדרש) הנתיב ושם הקובץ של הקובץ solution.zip שאליו יארזו את הפתרון (לדוגמה, out/CI/ALMLab.zip). |
| solution-folder | (חובה) הנתיב ותיקיית המקור של הפתרון שיש לארוז. |
| solution-type | (אופציונלי) סוג התמיסה לאריזה. האפשרויות כוללות לא מנוהל (מומלץ), מנוהל, או שניהם. |
publish-solution
פרסם את ההתאמות האישיות של הפתרון.
| פרמטר | תיאור |
|---|---|
| environment-url | (נדרש) כתובת ה- URL עבור הסביבה שבה ברצונך לפרסם את הפתרון (למשל, https://YourOrg.crm.dynamics.com). |
| user-name | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, שם המשתמש של החשבון שבו אתה משתמש כדי להתחבר. |
| password-secret | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, הזן את הסיסמה של החשבון שבו אתה משתמש כדי להתחבר. |
| solution-file | (נדרש) הנתיב והשם של קובץ הפתרון שברצונך לייבא. |
| app-id | מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי ישות שירות. |
| client-secret | סוד הלקוח המשמש לאימות ה-pipeline של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| tenant-id | מזהה ה-tenant בעת אימות עם app-id ו-client-secret. |
clone-solution
משכפל את הפתרון עבור סביבה נתונה.
| פרמטר | תיאור |
|---|---|
| environment-url | (נדרש) כתובת ה- URL עבור הסביבה שממנה ברצונך לשכפל את הפתרון (למשל, https://YourOrg.crm.dynamics.com). |
| user-name | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, שם המשתמש של החשבון שבו אתה משתמש כדי להתחבר. |
| password-secret | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, הסיסמה של החשבון שבו אתה משתמש כדי להתחבר. |
| solution-file | (נדרש) הנתיב והשם של קובץ הפתרון שברצונך לייבא. |
| app-id | מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| client-secret | סוד הלקוח המשמש לאימות ה-pipeline של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות. |
| tenant-id | מזהה הדייר/הארגון בעת אימות עם app-id ו-client-secret. |
| solution-name | (נדרש) הנתיב והשם של קובץ solution.zip הנדרשים לצורך השכפול (למשל, out/CI/ALMLab.zip). |
| solution-version | גרסת הפתרון לשכפול. |
| target-folder | תיקיית יעד שבה יש להציב את הפתרון שחולץ. (לדוגמה, Git repository\target-solution-folder). |
| Working-directory | תיקיה זמנית לתוצרי ביניים הדרושים לשכפול הפתרון. ברירת מחדל: root of the repository |
check-solution
בודק את קובץ הפתרון כדי לזהות סתירות.
| פרמטר | תיאור |
|---|---|
| environment-url | (נדרש) כתובת ה- URL עבור הסביבה שממנה ברצונך לשכפל את הפתרון (למשל, https://YourOrg.crm.dynamics.com). |
| user-name | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, שם המשתמש של החשבון שבו אתה משתמש כדי להתחבר. |
| password-secret | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, הסיסמה של החשבון שבו אתה משתמש כדי להתחבר. |
| app-id | מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| client-secret | סוד הלקוח המשמש לאימות ה-Pipeline של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| tenant-id | מזהה Tenant בעת אימות עם app-id ו-client-secret. |
| נתיב | (נדרש) הנתיב והשם של קובץ הפתרון שברצונך לבדוק. |
| מרחב גיאוגרפי | באיזה מיקום גיאוגרפי של השירות 'בודק Microsoft Power Platform' יש להשתמש. ערך ברירת המחדל הוא 'ארצות הברית'. |
| rule-level-override | נתיב לקובץ המכיל מערך JSON של כללים והרמות שלהם. הערכים המקובלים הם: 'קריטי', 'גבוה', 'נמוך' ו'לצורך מידע'. דוגמה: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| checker-logs-artifact-name | שם תיקיית התוצר שעבורה יועלו יומני בודק של Microsoft Power Platform. ערך ברירת המחדל הוא 'CheckSolutionLogs'. |
upgrade-solution
משדרג את הפתרון.
| פרמטר | תיאור |
|---|---|
| environment-url | (נדרש) כתובת ה- URL עבור הסביבה שממנה ברצונך לשכפל את הפתרון (למשל, https://YourOrg.crm.dynamics.com). |
| user-name | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, שם המשתמש של החשבון שבו אתה משתמש כדי להתחבר. |
| password-secret | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, הסיסמה של החשבון שבו אתה משתמש כדי להתחבר. |
| solution-file | (נדרש) הנתיב והשם של קובץ הפתרון שברצונך לייבא. |
| app-id | מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| client-secret | סוד הלקוח המשמש לאימות ה-pipeline של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| tenant-id | מזהה דייר בעת אימות עם app-id ו-client-secret. |
| solution-name | (נדרש) שם הפתרון לשדרוג. |
| אסינכרוני | משדרג את הפתרון באופן אסינכרוני. |
| max-async-wait-time | זמן המתנה אסינכרוני מרבי בדקות. ערך ברירת המחדל הוא 60 דקות. |
משימות חבילות
משימות אלה מבצעות פעולות על חבילות.
deploy-package
פורס קובץ DLL של חבילה או קובץ ZIP עם חבילה.
הערה
פעולה זו נתמכת ב-Windows בלבד.
| פרמטר | תיאור |
|---|---|
| environment-url | (נדרש) כתובת ה- URL עבור הסביבה שממנה ברצונך לשכפל את הפתרון (למשל, https://YourOrg.crm.dynamics.com). |
| user-name | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, שם המשתמש של החשבון שבו אתה משתמש כדי להתחבר. |
| password-secret | (נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, הסיסמה של החשבון שבו אתה משתמש כדי להתחבר. |
| app-id | מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| client-secret | סוד לקוח המשמש לאימות ה-pipeline של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| tenant-id | מזהה ה-tenant בעת אימות עם app-id ו-client-secret. |
| חבילה | (נדרש) הנתיב לקובץ ה-DLL או ה-ZIP המכיל חבילה. |
משימות פורטל
משימות אלה מבצעות את הפעולות הבאות כנגד Power Pages.
upload-paportal
מעלה נתונים אל Power Pages.
| פרמטר | תיאור |
|---|---|
| environment-url | (נדרש) כתובת ה- URL עבור הסביבה שבה ברצונך לייבא את הפתרון (למשל, https://YourOrg.crm.dynamics.com). |
| app-id | מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| client-secret | סוד לקוח המשמש לאימות ה-pipeline של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי Service Principal. |
| tenant-id | מזהה הלקוח בעת אימות עם app-id ו-client-secret. |
| upload-path | נתיב שבו מאוחסן תוכן אתר האינטרנט (כינוי: -p). |
| deployment-profile | העלה נתוני פורטל עם פרטי סביבה המוגדרים דרך משתני פרופיל בקובץ deployment-profiles/[profile-name].deployment.yaml. |
| מודל-גרסה | מציין אם נתוני האתר שיש להעלות משתמשים במודל הנתונים הסטנדרטי (1) או המשופר (2). ערך ברירת המחדל הוא 1. |
מידע נוסף: תמיכת Microsoft Power Platform CLI עבור Power Pages.
משימות קיטלוג (תצוגה מקדימה)
משימות אלה מבצעות פעולות מול הקטלוג ב- Power Platform.
הערה
בשלב זה, משימות קטלוג עבור Power Platform נמצאות בתצוגה מקדימה.
התקן
התקן פריט Catalog עבור סביבת היעד.
| פרמטר | תיאור |
|---|---|
| מזהה פריט קטלוג | (נדרש) פריט קטלוג להתקנה בסביבת היעד. |
| target-url | (נדרש) כתובת ה- URL של סביבת היעד עבור התקנת פריט הקטלוג (לדוגמה, https://YourOrg.crm.dynamics.com). |
| הגדרות | (חובה) הגדרות חבילת סביבת זמן ריצה להפעלת תשתית ההתקנה. תבנית המחרוזת חייבת להיות key=value|key=value. |
| גרסת יעד | גרסת יעד להתקנה. אם לא תציין גירסה, הגירסה שפ פורסמה תיבחר. |
| מצב הדגימה | תשאול לבדיקת מצב הבקשה שלך. |
אישור
רשום את כל פריטי הקטלוג שפורסמו מסביבת Dataverse הנוכחית (הארגון).
| פרמטר | תיאור |
|---|---|
| נתיב | (חובה) נתיב למסמך הגשת הקטלוג. |
| package-zip | נתיב לקובץ ה- ZIP של החבילה. |
| solution-zip | נתיב לקובץ ה-ZIP של הפתרון. |
| מצב הסקר | בדיקה של מצב הבקשה שלך. |
מצב
קבל את מצב התקנת הקטלוג או בקשת ההגשה.
| פרמטר | תיאור |
|---|---|
| tracking-id | (חובה) מזהה מעקב אחר בקשה. |
| סוג נתונים | (נדרש) סוג בקשה. ערכים חוקיים הם Install ו- Submit. |
יצירת זרימת עבודה ב-GitHub
לקבלת מידע נוסף על יצירת זרימות עבודה של GitHub באמצעות GitHub Actions, השלם את המעבדות של GitHub Actions עבור Microsoft Power Platform.
לקבלת מידע נוסף, ראה אודות GitHub Actions.