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

בערכת לימוד זו, תלמד איך לבצע את הפעולות הבאות:

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

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

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

יצירת חשבון GitHub

  1. עבור אל https://github.com ולחץ על Sign up או Start a free trial (או היכנס למערכת אם יש לך חשבון קיים).

    יצירת חשבון

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

    יצירת מאגר

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

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

  3. צור את המאגר החדש ששמו poweractionslab. הקפד לבחור את האפשרות Add a README file כדי להפעיל את המאגר ובחר Create repository.

    הפעלת מאגר.

יצירת סוד חדש שישמש את GitHub Actions

  1. נווט אל המאגר מהקישור שבאשף הייבוא ובחר Settings, נווט אל Secrets ולאחר מכן לחץ על New secret.

    סוד חדש

  2. בדף הסודות, קרא לסוד password. הקלד את הסיסמה של שם המשתמש שבו אתה משתמש כדי להתחבר ל- Microsoft Power Platform בשדה Value ובחר Add secret. הסיסמה תוזכר בקבצי YML המשמשים להגדרת זרימות העבודה של GitHub מאוחר יותר במעבדה זו.

    יצירת סוד

    הסיסמה מאוחסנת כעת באופן מאובטח כסוד GitHub.

    סוד מאוחסן

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

  1. נווט אל המאגר מהקישור שבאשף הייבוא ובחר Settings, נווט אל Secrets ולאחר מכן לחץ על New secret.

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

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

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

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

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

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

  1. בחר Actions ולאחר מכן ‎set up a workflow yourself.

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

    פעולה זו תפעיל קובץ YML חדש עם זרימת עבודה בסיסית כדי לעזור לך להתחיל בעבודה עם GitHub Actions.

    קובץ YML לדוגמה

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

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

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

  4. עדכן את <USERNAME> בשם המשתמש שבו אתה משתמש כדי להתחבר לסביבה.

    • אם אתה משתמש באימות SPN ביחד עם <ENVIRONMENTURL>, עדכן את <APPID> ו- <TENANT ID>

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

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

    התחל בביצוע.

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

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

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

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

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

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

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

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

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

    הצגת ענפים

  4. בחר את הענף שנוצר על-ידי הפעולה.

    בחירת ענף.

  5. ודא שהתיקיה 'solutions/ALMLab' נוצרה בענף החדש ולאחר מכן צור בקשת משיכה למיזוג השינויים בענף הראשי. לחץ על Pull request.

    יצירת בקשת משיכה מענף.

  6. בטופס Open a pull request, הוסף כותרת ותיאור (אופציונלי) ולאחר מכן בחר Create pull request.

    פתיחת בקשת משיכה.

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

    צירוף ומיזוג

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

יצירת זרימת עבודה להפקת תוצר Build ולייבוא לייצור

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

  • יוצרת פתרון מנוהל ומפרסמת אותו כתוצר של GitHub
  • מייבאת את תוצר ה- Build לסביבת הייצור
  1. נווט אל Actions ובחר New workflow.

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

  2. בחר setup a workflow yourself.

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

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

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

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

    • עדכן את <BUILDENVIRONMENTURL> בכתובת ה- URL של סביבת ה- Build שבה אתה משתמש כדי ליצור את הפתרון המנוהל. לדוגמה: https://poweractionsbuild.crm.dynamics.com.
    • עדכן את <PRODUCTIONENVIRONMENTURL> בכתובת ה- URL של סביבת הייצור שאליה אתה פורס. לדוגמה: https://poweractionsbuild.crm.dynamics.com.
    • עדכן את <USERNAME> בשם המשתמש שבו אתה משתמש כדי להתחבר לסביבות.

    שינוי שם והדבקת קוד 4a. אם אתה משתמש באימות SPN, עליך לעדכן בזרימת העבודה שלך את המשתנים הבאים:

    • עדכן את <BUILDENVIRONMENTURL> בכתובת ה- URL של סביבת ה- Build שבה אתה משתמש כדי ליצור את הפתרון המנוהל. לדוגמה: https://poweractionsbuild.crm.dynamics.com.
    • עדכן את <PRODUCTIONENVIRONMENTURL> בכתובת ה- URL של סביבת הייצור שאליה אתה פורס. לדוגמה: https://poweractionsbuild.crm.dynamics.com.
    • עדכן את <APPID> בשם היישום שבו אתה משתמש כדי להתחבר לסביבות.
    • עדכן את <TENANT ID> במזהה הדייר עבור הסביבות שלך.
  5. בצע את השינויים. בחר Start commit והוסף כותרת ותיאור (אופציונלי). לאחר מכן, בחר Commit new file.

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

בדיקת זרימת העבודה מהמהדורה לייצור

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

  1. נווט אל Releases.

    ניווט למהדורות.

  2. בחר Draft a new release.

    ניסוח מהדורה חדשה.

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

    יצירת מהדורה.

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

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

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

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

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

    הצגת ענף.

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

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

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

  1. נווט לפתרון ALMLab בסביבת הפיתוח שלך ובחר Edit.

    ערוך פתרון.

  2. בחר והצג את הישות Time off Request.

    הצגת הישות.

  3. בחר Add field וצור את השדה החדש כפי שמוצג באיור הבא.

    הוסף שדה.

  4. בחר סיום.

  5. נווט בחזרה למאגר GitHub אל Actions, בחר Run workflow ובחר את הלחצן Run workflow.

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

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

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

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

  7. לאחר השלמת זרימת העבודה, נווט לענף החדש על-ידי בחירת האפשרות Code והאפשרות Branches.

    ניווט לענף.

  8. בחר את הענף שנוצר על-ידי זרימת העבודה ובחר New pull request.

    יצירת בקשת משיכה.

  9. בחר Pull request בדף הבא.

    בקשת משיכה חדשה.

  10. הוסף כותרת ולאחר מכן בחר Create pull request.

    יצירת בקשת משיכה.

  11. בדף בקשת המשיכה, בחר את הכרטיסיה Files changed.

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

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

    הצגת עדכונים.

  13. נווט חזרה לבקשת המשיכה. בחר Pull requests ולאחר מכן בחר את בקשת המשיכה שנוצרה קודם לכן.

    בחירת בקשת משיכה.

  14. בדף Pull request, בחר Squash and merge כדי למזג את קובץ הפתרון המעודכן בענף הראשי.

    צירוף ומיזוג לאחר מכן.

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

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

למידע נוסף

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