סקירה וקידום
סביבות מתמשכות ו-CI & Review
יצירת סביבות משותפות לטווח ארוך, הגדרת מסלולי סקירת CI, בדיקת אירועי מיזוג עם ראיות QA, מיזוג ב-Console וקידום המועמד שעבר אימות.
עודכן לאחרונה
Environments (/environments) ו-CI & Review (/ci-review) הם תהליכי האימות המשותפים של Console. השתמשו בהם כאשר צוות זקוק לסביבת QA, UAT, הדגמה, staging או סקירת לקוח לטווח ארוך, ורוצה שהשינויים יעברו סקירת קוד ו-QA לפני קידומם.
סביבה מתמשכת אינה סביבת עבודה אישית. זו סביבת ריצה משותפת לצוות, עם מדיניות, חיוב והיסטוריית אירועים משלה. פרופיל סביבת עבודה של CI אומר ל-Console באיזו סביבת QA או סקירה להשתמש כאשר אירוע מיזוג דורש בדיקות דפדפן, מסד נתונים או בינת קוד.
מי יכול לראות זאת
שני הדפים נמצאים תחת הפצה בניווט עבור כל מי ששייך לצוות: חברי צוות, מנהלי צוות, מפעילי פלטפורמה ומנהלי פלטפורמה. מדיניות הצוות קובעת מי יכול ליצור סביבות ופרופילי CI. אם כפתור יצירה חסר או שהפעולה נדחית, פנו למנהל צוות.
לפני שמתחילים
- חברו את ספק Git עבור המאגר (הגדרות ← Git Access).
- הכינו גיבוי מסד נתונים מאושר לזריעה (גיבויים).
- החליטו אם המסלול בודק רק את ענף המקור או גם סביבת יעד מתמשכת. הבחירה קובעת אילו בדיקות ירוצו.
סביבות מתמשכות
Persistent Environments (“יצירה והפעלה של סביבות עבודה מתמשכות לצוות”) מציג את סביבות הצוות, התור, הפרטים והמפקח. סמל (i) לצד הכותרת מסביר את הדף ומקשר לכאן.
יצירת סביבה מתמשכת
בחרו Create environment (/environments/new). באשף ארבעה שלבים: Source, Runtime, Policy ו-Review, וכן חלונית הפעלה שמציגה חסימות שנותרו.
- Source: הצוות, שם הסביבה, כתובת המאגר וענף המקור. Console בודק גישה לספק. הפעילו את מחסנית המאגרים כאשר יש לבצע checkout בסדר מוגדר של מאגר סביבת הריצה ומאגר המוצר.
- Runtime: פרופיל הסביבה המתמשכת, משפחת התבניות, יעד סביבת העבודה והגודל. הפרופיל קובע את גרסת WebCentral (Java, Gradle, Tomcat וחבילת הרישוי).
- Policy: גיבוי הזריעה, החשיפה ומנוע העברת מסד הנתונים (Flyway, ARCHIBUS DUW או ללא מנוע).
- Review: בדקו את התוכנית ובחרו Create environment. מחיר זמן הפעילות לתקופה שבחרתם מוצג כאן.
Console יוצר את הרשומה ומפעיל את סביבת העבודה התומכת בה. לאחר מכן הסביבה מציגה את סביבת העבודה המתמשכת, המועמד והגרסאות הנוכחיות, מצב העדכון, קיצורי הדרך לסביבת הריצה והיסטוריית האירועים. כל מי שרשאי לראות סביבה יכול לשנות את שמה באמצעות סמל העיפרון. שינוי השם משנה את שם התצוגה בלבד.
קיצורי דרך לסביבת הריצה
| פעולה | מתי להשתמש |
|---|---|
| Open workspace | כאשר נדרשים העורך או מעטפת הפקודות של סביבת העבודה התומכת. |
| Open Archibus | כאשר רוצים לפתוח את יישום Tomcat בנתיב /archibus. |
| Restart Tomcat | כאשר נדרש אתחול מבוקר של Tomcat. |
| Open archibus.log | כאשר נדרשות ראיות עדכניות מיומן היישום. |
| Open CI & Review | כאשר נדרשת היסטוריית הסקירה, ה-QA והקידום של הסביבה. |
עדכון סביבה בשני שלבים
סביבה משותפת אינה מופעלת מחדש בטעות:
- Request environment update מאשר את העדכון אך עדיין אינו נוגע בסביבה הפעילה.
- Start environment update מפעיל אותו וממתין. המצב עובר ל-running ואז ל-applied.
CI & Review
CI & Review (“עבודה על אירועי מיזוג משלב הקליטה ועד האישור, QA בסביבת עבודה, אימות סביבת יעד ומיזוג אנושי”) הוא המקום שבו סוקרים וממזגים שינויים. סמל (i) לצד הכותרת מסביר את הדף ומקשר לכאן.
רצועת תהליך העבודה מציגה את השלבים של אירוע המיזוג שנבחר: Intake, Review, QA, Target QA ו-Merge. מתחתיה חמש כרטיסיות, כל אחת עם מונה:
| כרטיסייה | מה היא כוללת |
|---|---|
| Merge events | תור הסקירה: כל אירועי המיזוג מ-webhooks, העברות מסביבת עבודה או רישום ידני. |
| Review | אירוע המיזוג שנבחר (Review workspace): ענפים, סוקרים, שינויים בערימה והפקדים להפעלת סקירה ו-QA. |
| Run detail | פרטי הריצה, ציר הזמן של השלבים ושורות יומן שעברו ניקוי. |
| Repository routes | פרופילי CI שמורים של סביבת עבודה. טעינת הגדרת ספק של מסלול או התחלת ריצה. |
| Provider handoff | פרטי החיבור לספק, ה-webhook והצינור עבור המסלול שנבחר. |
יצירת פרופיל סביבת עבודה של CI
בחרו Create CI profile (/ci-review/workspaces/new). השלבים הם Source route, Workspace runtime, Run policy ו-Review and create.
- Source route: צוות, ספק, מאגר, ענף ואפשרות לסביבת יעד. סביבת יעד מפעילה את בדיקת היעד.
- Workspace runtime: סקירה, QA, סקירה ו-QA, או QA של סביבת היעד, וכן תבנית CI, יעד וגודל.
- Run policy: שמירה, ארטיפקטים, השלבים שירוצו, היקף ה-QA, מנוע ההעברה, פרופיל גרסת WebCentral וגיבוי מסד הנתונים.
- Review and create: בדקו את הטבלה ובחרו Create CI profile.
פרופיל הוא מטא-נתונים של מסלול, לא סביבת עבודה אישית. Console משתמש בו כאשר אירוע מיזוג דורש סביבת עבודה לסקירה או ל-QA.
הגדרת העברת הספק
ב-Provider handoff, טענו מסלול ואז:
- שמרו חיבור מנוהל באמצעות הפניה לאישור שאושר. Console מציג תצוגה מקדימה רק לאחר השמירה.
- Rotate credential או Revoke credential.
- Install webhook, Reconcile webhook או Remove webhook.
- בחרו Check connection לפני הסתמכות על המסלול.
לעולם אל תכניסו אסימוני ספק לשמות מסלולים, לתיאורים או להערות QA.
סקירת המימוש
סקירת מימוש היא הדרך להפוך שינוי מתוכנן, לעיתים קרובות משימה שאושרה ב-Design, לקוד ממוזג:
- מפתח מממש את המשימה בסביבת עבודה ודוחף ענף.
- השינוי מגיע אל Merge events מ-webhook של הספק, מהעברה מסביבת עבודה או מרישום ידני.
- ב-Review, בדקו את ענפי המקור והיעד, את הקישור לספק, את הסוקרים ואת השינויים בערימה. הקצו סוקרים והוסיפו הערות.
- בחרו Start review & QA. סקירת ArchiBot בוחנת את הקוד, הפרשי השינויים בערימה, בדיקות חסרות ונתיבים מסוכנים. QA של Runner אוסף ראיות ביצוע: בדיקות עשן בדפדפן, בדיקות מסד נתונים, פקודות בדיקה ויומני סביבת העבודה. ראו Console Bots.
- עקבו אחר רצועת תהליך העבודה ו-Run detail. השתמשו ב-Cancel run כדי לעצור ריצה.
האפשרות Merge in Console זמינה רק כאשר:
- נרשם אישור של סוקר,
- סקירת הקוד שהתבקשה עברה,
- QA של Runner שהתבקש עבר, וכן
- אם נבחרה סביבת יעד, בדיקת סביבת היעד עברה.
מיזוג אנושי הוא ברירת המחדל. לאחר המיזוג אפשר לקדם את המועמד: ב-Environment השתמשו ב-Promote candidate כאשר הריצה האחרונה תואמת למועמד, ולאחר מכן בצעו את העדכון הדו-שלבי שלעיל.
ענף מקור בלבד או סביבת יעד
ללא סביבת יעד, Console מריץ סקירת קוד ו-QA של Runner, ו-Target QA מסומן כמדולג. עם סביבת יעד, Console מאמת גם את המועמד מול מסד הנתונים של הסביבה, הגיבוי, מנוע ההעברה, היעד, התבנית, שרשרת הכלים והפרמטרים שלה לפני המיזוג או הקידום. הקפידו להשתמש באותו פרופיל גרסת WebCentral בסביבה ובשני פרופילי ה-QA.
יומנים וראיות
Save to Shared Drive שומר ראיות מעבר לתקופת השמירה הרגילה של היומנים. נדרש כונן עם הרשאת כתיבה. לפני המיזוג, הסוקרים צריכים להיות מסוגלים לענות מתוך Console על השאלות: מה השתנה, אילו בדיקות רצו ואיפה נמצאות הראיות שעברו ניקוי. לעולם אל תשתפו מפתחות, אסימוני ספק, קובצי Cookie, סודות אשכול, כתובות URL של מסדי נתונים, תוכן גיבויים או קובצי רישיון.
בטלפון
- Environments מציג את התור, הפרטים והמפקח זה מתחת לזה. בחירת סביבה גוללת לפרטים שלה.
- Create environment ו-Create CI profile נשארים מוצמדים לתחתית המסך במהלך האשפים. כפתורים כפולים בחלונית ההפעלה ובכרטיס הסקירה מוסתרים כדי להשאיר כפתור ראשי אחד.
- טבלת ספקי ה-CI באשף הפרופיל הופכת לכרטיסים מסומנים.
- כרטיסיות CI & Review נגללות לצדדים, וקישורי סוקרים, ריצות ובקשות מיזוג מספקים אזורי מגע בגודל מלא.
- Build logs וחלוניות דו-שיח אחרות נפתחים כגיליונות ברוחב מלא. חלונית המידע (i) שלצד כל כותרת מותאמת למסך.
פתרון בעיות
| חסימה | מה היא בדרך כלל אומרת | הצעד הבא |
|---|---|---|
| חסרה גישה למאגר | Console אינו יכול לאשר גישת Git. | רעננו את האישור או פתחו את Manage Git access. |
| חסרים יעד או תבנית | אין יעד או כינוי תבנית תואמים. | בקשו ממנהל צוות או מ-ISM לבדוק את מוכנות היעד. |
| לא נבחר גיבוי | סביבת העבודה או פרופיל ה-QA זקוקים לזריעה. | בחרו גיבוי מאושר. |
| חסרה מדיניות העברה | לא נבחר מנוע העברה. | בחרו את המנוע שתואם ליעד. |
| בדיקת סביבת היעד חסומה | הסקירה וה-QA עברו, אך ראיות היעד נכשלו. | קראו את ציר הזמן של הריצה לפני המיזוג. |
| Promote candidate מושבת | המועמד חסר, מיושן או לא עבר אימות. | הריצו שוב סקירה ו-QA או בחרו את הענף הנכון. |
לצורך תמיכה, ציינו את הצוות, שם הסביבה, אירוע המיזוג או מזהה הריצה, הענפים, השלב החסום ושגיאה שעברה ניקוי. ראו העברת טיפול לתמיכה.
מדריכים קשורים
הושלם כאשר
- סביבת העבודה ופרופיל ה-CI משתמשים באותו פרופיל גרסת WebCentral.
- לפני כל מיזוג, סטטוס הסקירה, ה-QA ובדיקת סביבת היעד גלויים ב-Console.
- יומנים שנשמרים ב-Shared Drive אינם מכילים סודות.