ערכת לימוד: פריסת פתרונות אוטומטית באמצעות GitHub Actions עבור Microsoft Power Platform
בערכת לימוד זו, תלמד איך לבצע את הפעולות הבאות:
- יצירת מאגר חדש של GitHub
- יצירת שתי זרימות עבודה של GitHub באמצעות GitHub Actions עבור Microsoft Power Platform
זרימות העבודה יכולות לייצא באופן אוטומטי את היישום שלך (כפתרון לא מנוהל) מסביבת פיתוח, ליצור תוצר גירסת Build (פתרון מנוהל) ולפרוס את היישום בסביבת הייצור שלך. ערכת לימוד זו משתמשת בפתרון ALMLab שבנית ובסביבות שהגדרת בערכות לימוד קודמות.
ערכות לימוד קשורות: תחילת העבודה וכן בניית יישום מונחה-דגמים.
יצירת חשבון GitHub
עבור אל https://github.com ולחץ על Sign up או Start a free trial (או היכנס למערכת אם יש לך חשבון קיים).

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

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

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

יצירת סוד חדש שישמש את GitHub Actions
נווט אל המאגר מהקישור שבאשף הייבוא ובחר Settings, נווט אל Secrets ולאחר מכן לחץ על New secret.

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

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

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

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

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

צור זרימת עבודה כדי לייצא ולפתוח את קובץ הפתרון בענף חדש
בחר Actions ולאחר מכן set up a workflow yourself.

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

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

עדכן את
<ENVIRONMENTURL>בכתובת ה- URL של סביבת הפיתוח שברצונך לייצא ממנה (לדוגמה: https://poweractionsdev.crm.dynamics.com).עדכן את
<USERNAME>בשם המשתמש שבו אתה משתמש כדי להתחבר לסביבה.אם אתה משתמש באימות SPN ביחד עם
<ENVIRONMENTURL>, עדכן את<APPID>ו-<TENANT ID>
כעת אתה מוכן לבצע את השינויים שלך. בחר Start commit, הקלד Create export yml בשדה הכותרת ולאחר מכן הוסף תיאור (אופציונלי). לאחר מכן, לחץ על Commit new file.

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

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


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

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

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

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

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

נווט חזרה לענף הראשי ובדוק שהפתרון זמין כעת גם שם.
יצירת זרימת עבודה להפקת תוצר Build ולייבוא לייצור
במקטע זה, ניצור זרימת עבודה נוספת אשר:
- יוצרת פתרון מנוהל ומפרסמת אותו כתוצר של GitHub
- מייבאת את תוצר ה- Build לסביבת הייצור
נווט אל Actions ובחר New workflow.

בחר setup a workflow yourself.

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

עדכן את המשתנים הבאים בקובץ של זרימת העבודה החדשה:
- עדכן את
<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>במזהה הדייר עבור הסביבות שלך.
- עדכן את
בצע את השינויים. בחר Start commit והוסף כותרת ותיאור (אופציונלי). לאחר מכן, בחר Commit new file.

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

בחר Draft a new release.

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

בצע את השלבים שבמקטע בדיקת זרימת העבודה מהמהדורה לייצור כדי ליצור מהדורה חדשה ולוודא שהפתרון המעודכן נפרס בסביבת הייצור שלך.
מזל טוב, הגדרת בהצלחה זרימת עבודה לדוגמה של CI/CD באמצעות GitHub Actions!