פעולות GitHub Actions זמינות לפריסת 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

לאחר קביעת התצורה, באפשרותך לקרוא למנהל השירות מתוך קבצי ה- Script של הפעולה שלך.

פרמטרים להגדרה בתוך קובץ ה- Script של פעולת GitHub שלך כמשתני סביבה:

• מזהה יישום כגון: 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 קיימות שיכולות לגרום לעדכון זרימות עבודה נוכחיות.
• עליך להוסיף את המשימה 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 תחת פעולות Power Platform.

whoAmI

אימות חיבור השירות על-ידי חיבור השירות ושליחת בקשת WhoAmI [SDK/Web API]. הכללת משימה זו בשלב מוקדם בזרימת העבודה של GitHub שלך עשויה להיות שימושית כדי לאמת קישוריות לפני תחילת העיבוד.

פרמטר	תיאור
environment-url	כתובת ה- URL של הסביבה שאליה אתה מתחבר.
user-name	שם המשתמש של החשבון שבו אתה משתמש כדי להתחבר.
password-secret	הסיסמה עבור שם המשתמש. הסיסמאות של GitHub מוגדרות בהגדרות תחת סודות. אין באפשרותך לאחזר סוד לאחר שהוגדר ונשמר.
app-id	מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
client-secret	סוד הלקוח המשמש לאימות קו צינור של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
tenant-id	מזהה הדייר בעת אימות עם app-id ו- client-secret.

משימות פתרון

משימות אלה מבצעות פעולות מול פתרונות וכוללות את הבאים.

import-solution

מייבא פתרון לסביבת יעד.

פרמטר	תיאור
environment-url	(נדרש) כתובת ה- URL עבור סביבת היעד שאליה ברצונך לייבא את הפתרון (למשל, https://YourOrg.crm.dynamics.com).
user-name	(נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, שם המשתמש של החשבון שבו אתה משתמש כדי להתחבר.
password-secret	(נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, הסיסמה של החשבון שבו אתה משתמש כדי להתחבר.
solution-file	(נדרש) הנתיב והשם של קובץ הפתרון שברצונך לייבא.
app-id	מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
client-secret	סוד הלקוח המשמש לאימות קו צינור של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
tenant-id	מזהה הדייר בעת אימות עם app-id ו- client-secret.

export-solution

מייצא פתרון מסביבת מקור.

פרמטר	תיאור
environment-url	(נדרש) כתובת ה- URL עבור הסביבה שממנה ברצונך לייצא את הפתרון (למשל, https://YourOrg.crm.dynamics.com).
user-name	(נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, שם המשתמש של החשבון שבו אתה משתמש כדי להתחבר.
password-secret	(נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, הסיסמה עבור שם משתמש. הסיסמאות של GitHub מוגדרות בהגדרות תחת סודות. אין באפשרותך לאחזר סוד לאחר שהוגדר ונשמר.
app-id	מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
client-secret	סוד הלקוח המשמש לאימות קו צינור של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
tenant-id	מזהה הדייר בעת אימות עם app-id ו- client-secret.
solution-name	(חובה) שם הפתרון שיש לייצא. השתמש תמיד בשם של הפתרון, ולא בשם התצוגה שלו.
solution-output-file	(נדרש) הנתיב ושם הקובץ solution.zip שאליו יש לייצא את סביבת המקור.
managed	(נדרש) הגדר כ- 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	סוד הלקוח המשמש לאימות קו צינור של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
tenant-id	מזהה הדייר בעת אימות עם app-id ו- client-secret.

clone-solution

משכפל את הפתרון עבור סביבה נתונה.

פרמטר	תיאור
environment-url	(נדרש) כתובת ה- URL עבור הסביבה שממנה ברצונך לשכפל את הפתרון (למשל, https://YourOrg.crm.dynamics.com).
user-name	(נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, שם המשתמש של החשבון שבו אתה משתמש כדי להתחבר.
password-secret	(נדרש) אם אתה משתמש באימות שם משתמש/סיסמה, הסיסמה של החשבון שבו אתה משתמש כדי להתחבר.
solution-file	(נדרש) הנתיב והשם של קובץ הפתרון שברצונך לייבא.
app-id	מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
client-secret	סוד הלקוח המשמש לאימות קו צינור של 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	מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
client-secret	סוד הלקוח המשמש לאימות קו צינור של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
tenant-id	מזהה הדייר בעת אימות עם app-id ו- client-secret.
path	(נדרש) הנתיב והשם של קובץ הפתרון שברצונך לבדוק.
אזור גיאוגרפי	באיזה מיקום גיאוגרפי של השירות 'בודק 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	מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
client-secret	סוד הלקוח המשמש לאימות קו צינור של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
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	מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
client-secret	סוד הלקוח המשמש לאימות קו צינור של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
tenant-id	מזהה הדייר בעת אימות עם app-id ו- client-secret.
חבילה	(נדרש) הנתיב לקובץ dll של חבילה או קובץ zip עם חבילה.

משימות פורטל

משימות אלה מבצעות את הפעולות הבאות כנגד Power Pages.

upload-paportal

מעלה נתונים אל Power Pages.

פרמטר	תיאור‬‏‫‬
environment-url	(נדרש) כתובת ה- URL עבור הסביבה שבה ברצונך לייבא את הפתרון (למשל, https://YourOrg.crm.dynamics.com).
app-id	מזהה היישום שעמו יש לבצע אימות. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
client-secret	סוד הלקוח המשמש לאימות קו צינור של GitHub. פרמטר זה הוא נדרש בעת אימות עם אישורי מנהל שירות.
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.

משימות קטלוג ‏(Preview)

משימות אלה מבצעות פעולות מול הקטלוג ב- Power Platform וכוללות את הדברים הבאים.

הערה

נכון לעכשיו, משימות הקטלוג עבור Power Platform הן במהדורת Preview.

התקן

התקן פריט Catalog עבור סביבת היעד.

פרמטר	תיאור‬‏‫‬
מזהה פריט קטלוג	(חובה) פריט קטלוג להתקנה בסביבת היעד.
target-url	(חובה) כתובת ה-URL של סביבת היעד שבה יותקן פריט הקטלוג (לדוגמה, "https://YourOrg.crm.dynamics.com").
הגדרות	(חובה) הגדרות חבילת זמן ריצה להפעלת מסגרת ההתקנה. תבנית המחרוזת חייבת להיות key=value|key=value.
גירסת יעד	גרסת יעד להתקנה. אם נשאר ריק, הגירסה שפורסמה נבחרת.
מצב התשאול	תשאול לבדיקת מצב הבקשה שלך.

שלח

רשום את כל פריטי הקטלוג שפורסמו מסביבת Dataverse הנוכחית (הארגון).

פרמטר	תיאור‬‏‫‬
path	(חובה) נתיב למסמך שליחת הקטלוג.
package-zip	נתיב לקובץ ה- ZIP של החבילה.
solution-zip	נתיב לקובץ ה- zip של הפתרון.
poll-status	תשאול לבדיקת מצב הבקשה שלך.

status

קבל את מצב בקשת ההתקנה/ההגשה של Catalog.

פרמטר	תיאור‬‏‫‬
tracking-id	(חובה) מזהה מעקב אחר בקשה.
סוג	(חובה) סוג הבקשה (ערכים: התקן, שלח)

חיבור זרימת עבודה של GitHub

לקבלת מידע נוסף אודות חיבור זרימות עבודה של GitHub באמצעות פעולות GitHub, השלם את פעולות GitHub עבור מעבדות Microsoft Power Platform.

מידע נוסף: אודות פעולות GitHub

למידע נוסף

פעולות GitHub עבור Microsoft Power Platform