חבילת אינטגרציה רציפה (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 בדף הזה.
(אופציונלי) מפעילים את המתג Trigger on pull requests from dbt Cloud אם רוצים להגדיר בדיקות אימות אוטומטיות בכל פעם שמריצים dbt Cloud CI job. מידע נוסף מופיע בקטע הפעלת טריגר בבקשות משיכה מ-dbt Cloud בדף הזה.
(אופציונלי) מפעילים את המתג הפעלת התראות באימייל אם רוצים לקבל התראות באימייל על סמך הסטטוס של הרצת CI. למידע נוסף, עיין בקטע הגדרת התראות בדף זה.
באופן אופציונלי, ניתן להפעיל את כפתורי המאמת כדי להפעיל מאמת ולקבוע את אפשרויותיו. לפרטים נוספים, אפשר לעיין בדפי התיעוד של כל אחד מהכלי לאימות:
שומרים את השינויים:
- כדי ליצור חבילה חדשה, לוחצים על הלחצן יצירת חבילה.
- אם אתם עורכים חבילה קיימת, לוחצים על הלחצן עדכון החבילה.
טריגרים
ניתן להפעיל ריצות CI בכמה דרכים:
- באופן אוטומטי, לפי לוח זמנים חוזר.
- באופן אוטומטי, כשמפתח Looker שולח בקשת משיכה למאגר של פרויקט LookML.
- באופן אוטומטי, כשמשימת CI ב-dbt Cloud יוצרת בקשת משיכה.
- באופן ידני, באמצעות הלחצן Run suite בדף Suites ב-Looker IDE.
- באופן ידני, על ידי הפעלה מחדש של ריצת CI קודמת, מהדף Runs של Looker IDE.
הפעלת טריגר לפי לוח זמנים
ניתן להגדיר חבילת CI כך שתופעל אוטומטית לפי לוח זמנים על ידי הפעלת כפתור ההפעלה הפעלה לפי לוח זמנים.
כשמפעילים את המתג הזה, אפשר לבחור את התדירות והפרטים של הפעלת חבילת ה-CI באופן אוטומטי:
- חודשי, ביום ובשעה ספציפיים
- שבועי, ביום ובשעה ספציפיים
- יומי, בשעה ספציפית
- מדי שעה או כל 2, 3, 4, 6, 8 או 12 שעות, החל משעה מסוימת ביום ועד שעה מסוימת ביום
- דקות כל 5, 10, 15, 20 או 30 דקות, החל משעה מסוימת ביום ועד שעה מסוימת ביום
- בחודשים ספציפיים בשנה, ביום ובשעה ספציפיים
- בימים ספציפיים בשבוע בשעה ספציפית
הפעלת טריגר בבקשות pull מ-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 לא תופעל.
הפעלה ב-pull requests מ-dbt Cloud
אם הגדרת את אינטגרציית dbt Cloud במערכת שלך, תוכל להגדיר חבילת CI שתפעל אוטומטית כאשר משימת CI של dbt Cloud מסתיימת. חבילת ה-CI בודקת אם שינויים במודלים של dbt יגרמו לשגיאות SQL ב-Looker Explores לפני פריסת השינויים ב-dbt.
כדי להגדיר את הטריגר הזה, מפעילים את המתג Trigger on pull requests from dbt Cloud כשיוצרים או עורכים חבילת CI.
אחרי שמפעילים את הטריגר הזה, מגדירים את האפשרויות הבאות:
dbt Cloud Job: בוחרים את משימת ה-CI של dbt Cloud מהשדה הנפתח שאמור להפעיל את החבילה הזו.
מאפיין משתמש בסכימה: בוחרים את מאפיין המשתמש ב-Looker שמכיל את שם הסכימה של חיבור מסד הנתונים. ברשימה הזו יופיעו רק מאפייני משתמשים שהופעלו עבור CI בלוח האדמין.
כששומרים את חבילת הכלים עם הטריגר הזה מופעל, Looker רושם באופן אוטומטי webhook בחשבון dbt Cloud כדי להאזין לסיום של עבודות.
בהרצות שמופעלות על ידי dbt Cloud, Looker מזהה באופן דינמי את הסכימה הזמנית שנוצרה על ידי ההרצה של dbt Cloud ומבטל את מאפיין המשתמש שנבחר באמצעות שם הסכימה הזמנית הזה למשך ההרצה של CI.
הגדרת התראות
כדי לקבל התראות באימייל על סמך הסטטוס של הרצות CI, אפשר להגדיר התראות לחבילת CI. כך אפשר לעקוב אחרי הרצות של שילוב רציף בלי להיכנס לדף Runs בסביבת הפיתוח המשולבת (IDE) של Looker.
כדי להגדיר התראות באימייל לחבילת CI, פועלים לפי השלבים הבאים כשיוצרים או עורכים חבילת CI:
- מפעילים את המתג הפעלת התראות באימייל.
- בשדה כתובות אימייל, מזינים רשימה של כתובות אימייל שמופרדות בפסיקים, שאליהן יישלחו ההתראות.
- משתמשים בתיבות הסימון כדי לבחור את סטטוסי העבודה שצריכים להפעיל התראה:
- נכשל: מפעיל שליחת אימייל כשריצת CI נכשלת בבדיקות אימות.
- שגיאה: מפעיל שליחת אימייל כשריצת CI נתקלת בשגיאת מערכת או שגיאת הגדרה.
- Passed: מפעיל שליחת אימייל כשריצת CI מסתיימת בהצלחה.
- Cancelled: מפעיל שליחת אימייל כשריצת CI מבוטלת.
מחיקת חבילה
כדי למחוק חבילת CI, מבצעים את השלבים הבאים:
- ב-Looker IDE, לוחצים על סמל השילוב המתמשך בסרגל הניווט של IDE.
- לוחצים על הכרטיסייה חבילות כדי לפתוח את הדף חבילות.
- בדף חבילות, לוחצים על הלחצן עריכת החבילה של החבילה.
- בדף של החבילה, לוחצים על הלחצן מחיקת החבילה.
- בתיבת הדו-שיח לאישור, לוחצים על הלחצן מחיקת החבילה.