מדריך: הפיכת פריסת פתרונות לאוטומטית באמצעות GitHub Actions עבור Microsoft Power Platform

במדריך זה, תלמד כיצד:

  • צור מאגר קוד חדש של GitHub
  • צור שתי זרימות עבודה של GitHub באמצעות GitHub Actions עבור Microsoft Power Platform

זרימות העבודה יכולות לייצא באופן אוטומטי את היישום שלך (כפתרון לא מנוהל) מסביבת פיתוח, ליצור תוצר גירסת Build (פתרון מנוהל) ולפרוס את היישום בסביבת הייצור שלך. ערכת לימוד זו משתמשת בפתרון ALMLab שבנית ובסביבות שהגדרת בערכות לימוד קודמות.

מדריכים קשורים: תחילת העבודה, וכן בניית יישום מונחה-דגמים.

צור חשבון GitHub

  1. עבור אל https://github.com ובחר הירשם או התחל תקופת ניסיון ללא תשלום (או התחבר אם כבר יש לך חשבון).

    צור חשבון

  2. לאחר יצירת החשבון שלך, צור מאגר על-ידי בחירה באפשרות צור מאגר או חדש.

    יצירת מאגר קוד

    ייתכן שיופיע מסך הפתיחה החלופי הבא:

    יצירת מאגר חדש

  3. צור את המאגר החדש ותן לו שם poweractionslab. הקפד לבחור הוסף קובץ README כדי לאתחל את המאגר, ולאחר מכן בחר צור מאגר.

    אתחל מאגר.

יצירת סוד חדש עבור אימות Service Principal

  1. עבור אל המאגר שלך ובחר הגדרות. הרחב את הסודות, ולאחר מכן בחר פעולות.

  2. בדף סודות, קרא לסוד בשם PowerPlatformSPN. הזן את סוד הלקוח מתוך רישום היישום שיצרת ב-Microsoft Entra בשדה ערך, ולאחר מכן בחר הוסף סוד. עליך לפנות אל ה-client secret בקובצי YML שמגדירים את זרימות העבודה של GitHub בהמשך ערכת לימוד זו.

    יצירה של סוד מנהל השירות החדש

    הסוד של הלקוח מאוחסן כעת בצורה מאובטחת כ־GitHub Secret.

צור זרימת עבודה כדי לייצא ולחלץ את קובץ הפתרון בהסתעפות חדשה

  1. בחר פעולות, ולאחר מכן בחר הגדר בעצמך זרימת עבודה. לחלופין, בחר/י באפשרות קבע תצורה בתיבה זרימת עבודה פשוטה תחת המקטע מומלץ עבור מאגר זה.

    תהליך ההגדרה.

  2. אתה רואה קובץ YAML חדש עם זרימת עבודה בסיסית שתעזור לך להתחיל בעבודה עם GitHub Actions.

    קובץ YML לדוגמה

  3. מחק את התוכן שנוצר מראש, ולאחר מכן הדבק את התוכן מהקובץ export-and-branch-solution-with-spn-auth.yml. שנה את שם הקובץ ל- export-and-branch-solution.yml.

    שינוי שם והחלפת תוכן.

  4. עדכן את <ENVIRONMENTURL> בכתובת ה- URL של סביבת הפיתוח שברצונך לייצא ממנה (לדוגמה: https://poweractionsdev.crm.dynamics.com).

  5. עדכן את <APPID> ו-<TENANT ID> בערכים שלך.

    • אם אתה משתמש בפרטי כניסה, הדבק את תוכן הקובץ export-and-branch-solution.yml במקום את תוכן הקובץ export-and-branch-solution-with-spn-auth.yml. עדכן את <USERNAME> בשם המשתמש שבו אתה משתמש כדי להתחבר לסביבה.

      שינוי שם והחלפת תוכן

    טיפ

    אם אינך מכיר את GitHub Actions וברצונך לקבל מידע נוסף, עיין בתיעוד הרשמי בכתובת https://docs.github.com/en/actions.

  6. כעת אתה מוכן לבצע commit לשינויים שלך. בחר Start commit, הקלד Create export yml בשדה הכותרת ולאחר מכן הוסף תיאור (אופציונלי). לאחר מכן, בחר Commit new file.

    התחל בביצוע.

מזל טוב, יצרת את תהליך העבודה הראשון שלך ב-GitHub תוך שימוש בפעולות הבאות:

  • Who Am I: מבטיחה שתוכל להתחבר בהצלחה לסביבה שממנה ברצונך לייצא.
  • ייצא פתרון: מייצא את קובץ הפתרון מסביבת הפיתוח שלך.
  • חלץ פתרון: קובץ הפתרון שהשרת מייצא הוא קובץ דחוס (zip) עם קובצי תצורה מאוחדים. קבצים ראשוניים אלה אינם מתאימים לניהול קוד מקור מכיוון שהם אינם בנויים באופן שמאפשר למערכות ניהול קוד מקור להשוות כראוי הבדלים בין גרסאות הקבצים וללכוד את השינויים שברצונך לבצע commit למערכת ניהול הגרסאות. עליך לפרוק את קבצי הפתרון כדי להתאים אותם לאחסון ולעיבוד של בקרת מקור.
  • פתרון הסתעפות: יוצר סניף חדש לאחסון הפתרון המיוצא.

בדיקת זרימת העבודה של הייצוא והחילוץ

  1. לאחר מכן, בדוק שזרימת העבודה פועלת. עבור אל פעולות, בחר הפעל זרימת עבודה ובחר הפעל זרימת עבודה. אם אתה משתמש בשם פתרון שונה מזה של ALMLab, שנה את הערך כאן אך השאר את שאר הערכים ללא שינוי.

    הפעל זרימת עבודה.

  2. לאחר 5-10 שניות, זרימת העבודה מופעלת. באפשרותך לבחור את תהליך העבודה הפועל כדי לנטר את ההתקדמות.

    לחץ כדי להציג את זרימת העבודה.

    בחר והצג זרימת עבודה.

  3. לאחר סיום זרימת העבודה, ודא שנוצר branch חדש כשהפתרון נפרק לתיקייה solutions/ALMLab. עבור אל הכרטיסיה קוד והרחבאת התפריט הנפתח של ההסתעפויות.

  4. בחר את המסתעף שהפעולה יצרה.

  5. ודא שהתיקיה solutions/ALMLab נוצרת בבראנץ׳ החדש. לאחר מכן, צור Pull Request כדי למזג את השינויים לתוך הענף הראשי. בחר תרומה ובתפריט הנשלף בחר פתח Pull Request.

  6. במסך פתח בקשת משיכה , הוסף כותרת ותיאור אם תרצה, ולאחר מכן בחר צור בקשת משיכה.

  7. המסך מתעדכן כדי להציג את בקשת המיזוג החדשה. בעת יצירת בקשת המשיכה, אתה מקבל אישור שהענף שלך אינו מתנגש עם הענף הראשי. המשמעות של אישור זה היא שתוכל למזג את השינויים לתוך הענף הראשי באופן אוטומטי. בחר מזג בקשת משיכה ולאחר מכן בחר אשר מיזוג. אם תרצה, בחר מחק ענף כדי להסיר את הענף שכבר אינו בשימוש.

    הצגת ענפים

  8. חזור לסניף ברירת המחדל (הראשי) ובדוק שהפתרון זמין שם.

יצירת זרימת עבודה לשימוש חוזר כדי להפיק תוצר בנייה ולייבא לסביבת ייצור

במקטע זה, צור זרימת עבודה נוספת ש:

  • יוצרת פתרון מנוהל ומפרסמת אותו כארטיפקט של GitHub
  • מייבאת את תוצר ה- Build לסביבת הייצור
  1. עבור אל פעולות ובחר זרימת עבודה חדשה.

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

  2. בחר הגדר זרימת עבודה בעצמך.

    הגדרת זרימת עבודה.

  3. שנה את שם הכותרת של זרימת העבודה ל- release-solution-to-prod-with-inputs. העתק את התוכן מהקובץ release-solution-to-prod-with-inputs.yml והדבק אותו למסך Edit new file.

    שנה שם והדבק קוד.

  4. בצע את השינויים. בחר Start commit והוסף כותרת ותיאור (אופציונלי). לאחר מכן, בחר Commit new file.

    ביצוע השינויים.

ביצוע קריאה לזרימת העבודה הניתנת לשימוש חוזר באירוע ההפצה

במקטע זה, עליך להתקשר לזרימת העבודה הניתנת לשימוש חוזר באירוע ההפצה.

  1. עבור אל פעולות ובחר זרימת עבודה חדשה.

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

  2. בחר להגדיר תהליך עבודה בעצמך.

    הגדרת זרימת עבודה.

  3. שנה את שם הכותרת של זרימת העבודה ל- release-action-call. העתק את התוכן release-action-call.yml הקובץ והדבק אותו במסך ערוך קובץ חדש.

    שינוי שם והדבקת קוד.

  4. עדכן את המשתנים הבאים בקובץ של זרימת העבודה החדשה:

    • <BUILD_ENVIRONMENT> עדכן עם כתובת ה- URL עבור סביבת ה- Build שבה אתה משתמש כדי ליצור את הפתרון המנוהל. לדוגמה: https://poweractionsbuild.crm.dynamics.com.
    • עדכן את <PROD_ENVIRONMENT> בכתובת ה-URL עבור סביבת הייצור שבה אתה פורס. לדוגמה: https://poweractionsprod.crm.dynamics.com.
    • עדכן את <APP_ID> עם מזהה היישום (לקוח) שאתה מוצא ב-להב App registrations של Microsoft Azure Portal על-ידי בחירת הרישום שיצרת מוקדם יותר בערכת לימוד זו.
    • עדכן את <TENANT_ID> עם מזהה הספריה (tenant) שאתה מוצא בלהב App registrations של Microsoft Azure Portal על-ידי בחירת הרישום שיצרת מוקדם יותר בערכת לימוד זו.
  5. בצע commit של השינויים. בחר התחל שמירה ולאחר מכן הוסף כותרת (אופציונלית) ותיאור (אופציונלי). לאחר מכן, בחר Commit new file.

    שמור שינויים.

בדוק את תהליך ההפצה לייצור

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

  1. עבור אל גרסאות.

    עבור אל המהדורות.

  2. בחר טיוטת גרסה חדשה.

  3. הוסף תגית מהדורה, את הכותרת, ובחר Publish release.

  4. בחר Actions כדי להציג את זרימת העבודה הפעילה.

    בחר כדי להציג את זרימת העבודה.

  5. בחר את זרימת העבודה הפועלת כדי להציג את הפעולות כשהן מבוצעות.

    הצג זרימת עבודה.

  6. המתן עד לסיום כל פעולה.

    הצג ענף.

  7. לאחר סיום זרימת העבודה, היכנס לסביבת הייצור שלך ואמת שהפתרון נפרס כפתרון מנוהל.

פרוס את העדכון ובדוק את השינויים לפני מהדורת הייצור

בדוק את התהליך מקצה לקצה, ולאחר מכן למד כיצד להציג ולאמת שינויים ביישום לפני שתפרוס אותו לסביבת הייצור.

  1. עבור אל פתרון ALMLab בסביבת הפיתוח שלך ובחר ערוך או בחר את שם התצוגה של הפתרון.

    ערוך פתרון.

  2. בחר והצג את הטבלה בקשת היעדרות.

    הצג את הטבלה.

  3. בחר + הוסף עמודה וצור את העמודה החדשה כמוצג באיור הבא.

    הוסף עמודה.

    ערכי שדות מעודכנים:**

    • שם תצוגה: אושר
    • סוג נתונים: כן/לא
  4. בחר בוצע.

  5. יש לבחור בשמירת טבלה. הוסף עמודה.

  6. חזור אל כרטיסיית Actions במאגרי GitHub שלך, בחר Run workflow, ובחר בלחצן Run workflow.

    הפעל את זרימת העבודה.

  7. לאחר 5-10 שניות, זרימת העבודה מופעלת. בחר את זרימת העבודה הפועלת כדי לנטר את ההתקדמות שלה.

    בחירת זרימת עבודה.

    הצג את זרימת העבודה.

  8. לאחר שזרימת העבודה מסתיימת, עבור אל הענף החדש על-ידי בחירת קוד ולאחר מכן ענפים.

    ניווט לבראנץ'.

  9. בחר את הענף שיצרת על-ידי הרחבת contribute ובחירה באפשרות Open pull request.

  10. הוסף כותרת (אופציונלי) ולאחר מכן בחר צור בקשת משיכה.

  11. לאחר עדכון התוכן, בחר את "Files changed" tab.

  12. שים לב שהשינויים בפתרון מודגשים בירוק כדי לציין שמקטע זה של הקובץ נוסף בהשוואה לאותו קובץ בענף הראשי.

  13. חזור אל הכרטיסיה שיחה . בחר בקשות משיכה ולאחר מכן בחר את בקשת המשיכה שיצרת בעבר.

  14. בדף בקשת משיכה , בחר סקווש ומיזוג כדי למזג את קובץ הפתרון המעודכן לתוך הענף הראשי שלך. לחלופין, מחק את הנתונים הממוזגים כעת לתוך ראשי.

    פתח בקשת משיכה עבור ענף חדש, הצג שינויים ומזג עם ענף ברירת המחדל

  15. בצע את השלבים שבסעיף בדיקת זרימת העבודה של הפצה לייצור כדי ליצור מהדורה חדשה ולאמת שהפתרון המעודכן נפרס בסביבת הייצור שלך.

מזל טוב, הגדרת בהצלחה זרימת עבודה לדוגמה של CI/CD באמצעות GitHub נוספות!

ראה גם

הפוך את זרימת העבודה שלך לאוטומטית מ-רעיון לייצור