חבילת אינטגרציה רציפה (CI) היא קבוצה של הוראות אימות שמשויכות לפרויקט LookML. משתמש Looker עם ההרשאה manage_ci יכול להגדיר את הפעולות הבאות בחבילת CI:
- איך מפעילים בדיקת אימות של CI (ידנית מ-Looker IDE או אוטומטית כששולחים בקשת משיכה למאגר).
- אילו כלים לאימות CI להפעיל.
- אפשרויות נוספות לכל בדיקת אימות. פרטים נוספים זמינים בדפי התיעוד של כל אחד מהכלי לאימות:
לפני שמתחילים
כדי ליצור חבילת CI, צריך:
- מופע Looker שעומד בדרישות ל-CI ומופעל בו CI.
- חשבון משתמש ב-Looker עם ההרשאה
manage_ci(ההרשאה הזו כלולה בחבילת ההרשאות 'אדמין').
יצירת חבילת CI
אפשר להגדיר ולהפעיל את כלי האימות בדף Suites ב-Looker IDE:
כדי ליצור חבילת CI, מבצעים את השלבים הבאים:
- ב-Looker IDE, לוחצים על סמל השילוב המתמשך בסרגל הניווט של IDE.
- לוחצים על הכרטיסייה חבילות כדי לפתוח את הדף חבילות.
- בדף חבילות, אפשר ליצור חבילה חדשה או לערוך חבילה קיימת:
- כדי ליצור חבילה חדשה, לוחצים על הלחצן יצירת חבילה.
- כדי לערוך חבילה קיימת, לוחצים על הלחצן עריכת החבילה של החבילה.
- מזינים שם חבילה. אם אתם עורכים חבילה קיימת, אתם יכולים ללחוץ על סמל העיפרון כדי לערוך את שם החבילה.
- (אופציונלי) מפעילים את המתג הפעלה לפי לוח זמנים אם רוצים להגדיר בדיקות אימות אוטומטיות לפי לוח זמנים חוזר. מידע נוסף זמין בקטע הפעלת טריגר לפי לוח זמנים בדף הזה.
(אופציונלי) מפעילים את המתג Trigger on pull requests from Looker אם רוצים להגדיר בדיקות אימות אוטומטיות בכל פעם שמפתח Looker שולח בקשת מיזוג למאגר. מידע נוסף זמין בקטע הפעלת טריגר בבקשות משיכה מ-Looker בדף הזה.
אם מפעילים הפעלה של סוויטת CI באמצעות בקשת מיזוג, אפשר להשתמש בשדה רק עבור ענף היעד כדי לציין שבקשות מיזוג רק לענפים ספציפיים במאגר צריכות להפעיל את סוויטת ה-CI. מידע נוסף זמין בקטע הפעלת טריגר בבקשות משיכה מ-Looker בדף הזה.
(אופציונלי) מפעילים את המתג הפעלת התראות באימייל אם רוצים לקבל התראות באימייל על סמך הסטטוס של הרצת CI. מידע נוסף זמין בקטע הגדרת התראות בדף הזה.
אפשר גם להפעיל את המתגים של כלי התיקוף כדי להפעיל כלי תיקוף ולהגדיר את האפשרויות שלו. לפרטים נוספים, אפשר לעיין בדפי התיעוד של כל אחד מהכלי לאימות:
שומרים את השינויים:
- אם אתם יוצרים חבילה חדשה, לוחצים על הלחצן יצירת חבילה.
- אם אתם עורכים חבילה קיימת, לוחצים על הלחצן עדכון החבילה.
טריגרים
אפשר להפעיל ריצות של CI בכמה דרכים:
- באופן אוטומטי, לפי לוח זמנים חוזר.
- באופן אוטומטי, כשמפתח Looker שולח בקשת משיכה למאגר של פרויקט LookML.
- באופן ידני, באמצעות הלחצן Run suite בדף Suites ב-Looker IDE.
- באופן ידני, על ידי הפעלה מחדש של ריצת CI קודמת, מהדף Runs של Looker IDE.
הפעלת טריגר לפי לוח זמנים
כדי להגדיר הפעלה אוטומטית של חבילת CI לפי לוח זמנים, צריך להפעיל את המתג הפעלה לפי לוח זמנים.
כשמפעילים את המתג הזה, אפשר לבחור את התדירות והפרטים של הפעלת חבילת ה-CI באופן אוטומטי:
- חודשי, ביום ובשעה ספציפיים
- שבועי, ביום ובשעה ספציפיים
- יומי, בשעה ספציפית
- מדי שעה או כל 2, 3, 4, 6, 8 או 12 שעות, החל משעה מסוימת ביום ועד שעה מסוימת ביום
- דקות כל 5, 10, 15, 20 או 30 דקות, החל משעה מסוימת ביום ועד שעה מסוימת ביום
- בחודשים ספציפיים בשנה, ביום ובשעה ספציפיים
- בימים ספציפיים בשבוע בשעה ספציפית
הפעלת טריגר בבקשות מ-Looker למיזוג קוד
כדי להגדיר חבילת CI להפעלה אוטומטית של בקשת משיכה, מפעילים את המתג Trigger on pull requests from Looker. כדי להשתמש בהפעלת בקשות משיכה, אדמין Looker צריך להגדיר את מאגר Git בדף Continuous Integration Admin ב-Looker).
אם מפעילים טריגרים של בקשות משיכה לחבילת CI, אפשר לציין באופן אופציונלי שבקשות משיכה רק לענפים ספציפיים במאגר יפעילו ריצה של חבילת ה-CI. כדי להגביל את הטריגרים האוטומטיים של בקשות משיכה להרצות CI לענפים ספציפיים במאגר, מזינים רשימה מופרדת בפסיקים של הענפים בשדה רק לענף היעד.
לדוגמה, אם במאגר יש שלושה ענפים בשמות main, release_1 ו-dev, אפשר להזין main, release_1 בשדה רק לענף היעד. המשמעות היא שהרצות CI יופעלו כשמפתח Looker ישלח בקשת משיכה (pull request) לענף main או לענף release_1. אם מפתח Looker שולח בקשת משיכה (pull request) לענף dev, זה לא יפעיל באופן אוטומטי את חבילת ה-CI.
הגדרת התראות
כדי לקבל התראות באימייל על סמך הסטטוס של הרצות CI, אפשר להגדיר התראות לחבילת CI. כך אפשר לעקוב אחרי הרצות של שילוב רציף בלי להיכנס לדף Runs בסביבת הפיתוח המשולבת (IDE) של Looker.
כדי להגדיר התראות באימייל לחבילת CI, פועלים לפי השלבים הבאים כשיוצרים או עורכים חבילת CI:
- מפעילים את המתג הפעלת התראות באימייל.
- בשדה כתובות אימייל, מזינים רשימה של כתובות אימייל שמופרדות בפסיקים, שאליהן יישלחו ההתראות.
- משתמשים בתיבות הסימון כדי לבחור את סטטוסי העבודות שצריכים להפעיל התראה:
- נכשל: מפעיל שליחת אימייל כשריצת CI נכשלת בבדיקות אימות.
- שגיאה: מפעיל שליחת אימייל כשריצת CI נתקלת בשגיאת מערכת או שגיאת הגדרה.
- Passed: מפעיל שליחת אימייל כשריצת CI מסתיימת בהצלחה.
- Cancelled: מפעיל שליחת אימייל כשריצת CI מבוטלת.
מחיקת חבילה
כדי למחוק חבילת CI, מבצעים את השלבים הבאים:
- ב-Looker IDE, לוחצים על סמל השילוב המתמשך בסרגל הניווט של IDE.
- לוחצים על הכרטיסייה חבילות כדי לפתוח את הדף חבילות.
- בדף חבילות, לוחצים על הלחצן עריכת החבילה של החבילה.
- בדף של החבילה, לוחצים על הלחצן מחיקת החבילה.
- בתיבת הדו-שיח לאישור, לוחצים על הלחצן מחיקת החבילה.