חבילת אינטגרציה רציפה (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.
- לוחצים על הכרטיסייה חבילות כדי לפתוח את הדף חבילות.
- בדף Suites (חבילות), אפשר ליצור חבילה חדשה או לערוך חבילה קיימת:
- כדי ליצור חבילה חדשה, לוחצים על הלחצן יצירת חבילה.
- כדי לערוך חבילה קיימת, לוחצים על הלחצן עריכת החבילה של החבילה.
- מזינים שם חבילה. אם אתם עורכים חבילה קיימת, אתם יכולים ללחוץ על סמל העיפרון כדי לערוך את שם החבילה.
- (אופציונלי) מפעילים את המתג הפעלה לפי לוח זמנים אם רוצים להגדיר בדיקות אימות אוטומטיות לפי לוח זמנים חוזר. מידע נוסף זמין בקטע הפעלת טריגר לפי לוח זמנים בדף הזה.
(אופציונלי) מפעילים את המתג Trigger on pull requests from Looker אם רוצים להגדיר בדיקות אימות אוטומטיות בכל פעם שמפתח ב-Looker שולח בקשת מיזוג למאגר. מידע נוסף זמין בקטע הפעלת טריגר בבקשות משיכה מ-Looker בדף הזה.
אם מפעילים הפעלה של חבילת CI באמצעות בקשת מיזוג, אפשר להשתמש בשדה רק לענף היעד כדי לציין שבקשות מיזוג רק לענפים ספציפיים במאגר צריכות להפעיל את חבילת ה-CI. מידע נוסף זמין בקטע הפעלת טריגר בבקשות משיכה מ-Looker בדף הזה.
אופציונלית, מפעילים את המתגים של כלי האימות כדי להפעיל כלי אימות ולהגדיר את האפשרויות שלו. לפרטים נוספים, אפשר לעיין בדפי התיעוד של כל אחד מהכלי לאימות:
שומרים את השינויים:
- אם אתם יוצרים חבילה חדשה, לוחצים על הלחצן יצירת חבילה.
- אם אתם עורכים חבילה קיימת, לוחצים על הלחצן עדכון החבילה.
טריגרים
אפשר להפעיל ריצות של 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, מבצעים את השלבים הבאים:
- ב-Looker IDE, לוחצים על סמל השילוב המתמשך בסרגל הניווט של IDE.
- לוחצים על הכרטיסייה חבילות כדי לפתוח את הדף חבילות.
- בדף חבילות, לוחצים על הלחצן עריכת החבילה של החבילה.
- בדף של החבילה, לוחצים על הלחצן מחיקת החבילה.
- בתיבת הדו-שיח לאישור, לוחצים על הלחצן מחיקת החבילה.