ערכת לימוד: פריסת פתרונות אוטומטית באמצעות 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.

   

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

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

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

   

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

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

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

   

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

   

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

   

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

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

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

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

   

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

   

   

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

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

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

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

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

   

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

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

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

• יוצרת פתרון מנוהל ומפרסמת אותו כתוצר של GitHub
• מייבאת את תוצר ה- Build לסביבת הייצור

1. נווט אל Actions ובחר New workflow.

   

2. בחר setup a workflow yourself.

   

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

   

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

   

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

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

1. נווט אל Actions ובחר New workflow.

   

2. בחר setup a workflow yourself.

   

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

   

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

   • עדכן את <BUILD_ENVIRONMENT> בכתובת ה- URL של סביבת ה- Build שבה אתה משתמש כדי ליצור את הפתרון המנוהל. לדוגמה: https://poweractionsbuild.crm.dynamics.com.
   • עדכן את <PROD_ENVIRONMENT> בכתובת ה- URL של סביבת הייצור שאליה אתה פורס. לדוגמה: https://poweractionsprod.crm.dynamics.com.
   • עדכן את <APP_ID> עם מזהה היישום (לקוח) שניתן למצוא במקטע רישומי היישומים של פורטל Microsoft Azure על-ידי לחיצה על הרישום שנוצר קודם לכן בערכת לימוד זו.
   • עדכן את <TENANT_ID> עם מזהה הספריה (דייר) שניתן למצוא במקטע רישומי היישומים של פורטל Microsoft Azure על-ידי לחיצה על הרישום שנוצר קודם לכן בערכת לימוד זו.

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

   

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

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

1. נווט אל Releases.

   

2. בחר Draft a new release.

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

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

   

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

   

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

   

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

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

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

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

   

2. בחר והצג את הטבלה ‏‫בקשה לשעות מנוחה‬.

   

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

   

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

   • שם תצוגה: אושר
   • סוג נתונים: כן/לא

4. לחץ על בוצע .

5. לחץ על שמור טבלה

6. נווט חזרה אל הכרטיסיה פעולות של מאגרי GitHub, בחר הפעל זרימת עבודה, ובחר בלחצן הפעל זרימת עבודה.

   

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

   

   

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

   

9. בחר את הענף שנוצר על-ידי ההרחבה תרום ולחץ על פתח בקשת משיכה.

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

11. לאחר עדכוני התוכן, לחץ על הכרטיסיה הקבצים השתנו.

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

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

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

    

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

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

ראה גם

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