פעולות GitHub Actions זמינות לפיתוח Microsoft Power Platform

הסעיפים הבאים מתארים 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.

ראו גם

GitHub Actions עבור Microsoft Power Platform