אפשר להפעיל אינטגרציה רציפה (CI) בכמה דרכים:
- באופן אוטומטי כשמפתח Looker שולח בקשת משיכה למאגר של פרויקט LookML (מידע על הגדרת האפשרות הזו זמין במאמר יצירת חבילת בדיקות של שילוב רציף).
- באופן אוטומטי כשמשימת CI ב-dbt Cloud מסתיימת (מידע על הגדרת האפשרות הזו זמין בדף יצירת חבילת אינטגרציה רציפה).
- באופן אוטומטי לפי לוח זמנים חוזר (מידע על הגדרת האפשרות הזו זמין בדף יצירת חבילת שילוב רציף).
- הפעלה ידנית של ריצה חדשה של חבילת CI מתוך Looker IDE.
- הפעלה מחדש ידנית של הרצת CI קודמת מ-Looker IDE.
אחרי שהבדיקות של האימות מסתיימות, אפשר לבדוק את התוצאות כמו שמתואר בדף התיעוד בנושא צפייה בתוצאות של הפעלת שילוב רציף.
הפעלה אוטומטית מ-pull requests
אם הפעלתם את חבילת ה-CI באמצעות Trigger on pull requests from Looker, CI יפעיל ריצת אימות באופן אוטומטי כשמפתח Looker ישלח בקשת מיזוג למאגר LookML. (אפשר גם לציין שרק בקשות משיכה לענפים מסוימים במאגר יפעילו ריצות CI אוטומטיות).
באימות אוטומטי של בקשות משיכה, מערכת ה-CI מאמתת את הקומיט האחרון של בקשת המשיכה ומחזירה את כל השגיאות בגרסה הזו של המאגר.
מידע על הצגת התוצאות זמין בדף התיעוד בנושא הצגת תוצאות של הרצת שילוב רציף.
הפעלה אוטומטית מ-dbt Cloud
אם הפעלתם את חבילת ה-CI באמצעות האפשרות Trigger on pull requests from dbt Cloud (הפעלה בבקשות משיכה מ-dbt Cloud), ה-CI יפעיל ריצת אימות באופן אוטומטי כשהמשימה שצוינה ב-dbt Cloud CI תסתיים.
הפעלה של CI שמופעלת על ידי משימת CI ב-dbt Cloud נועדה לבדוק אם שינויים בסכימה שבוצעו ב-dbt ישברו תוכן LookML. במהלך ההרצה, Looker מבצע את הפעולות הבאות:
- מקבל את ההתראה מ-dbt Cloud בסיום העבודה.
- הפעולה מחלצת את הפרטים של הסכימה הזמנית שנוצרה על ידי dbt Cloud עבור הריצה הספציפית הזו.
- השם של הסכימה הזמנית הזו מחליף את מאפיין המשתמש שהוגדר (לדוגמה, מאפיין הסכימה של החיבור).
- מריץ את כלי האימות של CI מול הסכימה הזמנית הזו.
כך תוכלו לזהות שינויים שעלולים לשבור את התהליך (כמו עמודות שהוסרו או טבלאות ששמן שונה) לפני שהשינויים ב-dbt ימוזגו עם הייצור. אחרי שההרצה מסתיימת, ערך מאפיין המשתמש חוזר לערך הרגיל שלו עבור משתמשי ה-CI.
הפעלה אוטומטית לפי לוח זמנים
אם הפעלתם את חבילת ה-CI באמצעות הפעלה לפי לוח זמנים, ה-CI יפעיל אוטומטית הרצת אימות לפי לוח הזמנים שציינתם.
במקרה של הפעלות אימות אוטומטיות ומתוזמנות, מערכת CI מאמתת את גרסת הייצור של המאגר ומחזירה את כל השגיאות בגרסה הזו.
מידע על הצגת התוצאות זמין בדף התיעוד בנושא הצגת תוצאות של הרצת שילוב רציף.
הפעלה ידנית של ריצה חדשה של חבילת CI
משתמש Looker עם ההרשאה see_ci יכול להפעיל ידנית הרצה של CI מ-IDE של Looker.
כדי להפעיל באופן ידני ריצה חדשה של חבילת CI, פועלים לפי השלבים הבאים:
- ב-Looker IDE, לוחצים על סמל השילוב המתמשך בסרגל הניווט של IDE.
- לוחצים על חבילות כדי לפתוח את הדף חבילות.
- לוחצים על הלחצן Run suite (הפעלת חבילת בדיקות) של חבילת ה-CI שרוצים להפעיל (אם אין לכם חבילות CI לפרויקט, אתם יכולים ליצור חבילת CI).
בתיבת הדו-שיח Trigger a run manually (הפעלת ריצה באופן ידני), משתמשים באפשרויות Workspace (סביבת עבודה) כדי לבחור את הענף שרוצים לאמת (פרטים מופיעים בקטע Workspace):
- כדי לאמת את גרסת הייצור של פרויקט LookML, לוחצים על Production (ייצור).
- כדי לאמת ענף פיתוח של פרויקט LookML, לוחצים על מצב פיתוח. בתפריט הנפתח Branch (ענף) בוחרים את ענף הפיתוח שרוצים לאמת.
כדי להפעיל את חבילת ה-CI, לוחצים על התחלת ההרצה.
הפעלת חבילת ה-CI עשויה להימשך כמה דקות, בהתאם לגודל הפרויקט, לאמצעי האימות שכלולים בחבילת ה-CI ולהגדרות של חבילת ה-CI.
אחרי שמפעילים ריצה, בסביבת Looker IDE מוצג הדף Run (הרצה) של חבילת הבדיקות שהופעלה. אחרי שבודקים את האימות, בדף הפעלה מוצגות התוצאות של כל אחד מהמאמתים. אתם יכולים לצאת מהדף הפעלה בזמן שהבדיקות של האימות פועלות, ואז לחזור לדף הפעלה כדי לראות את התוצאות.
מידע על הצגת התוצאות זמין בדף התיעוד בנושא הצגת תוצאות של הרצת שילוב רציף.
Workspace
כשמפעילים ידנית ריצת CI, אפשר להשתמש באפשרויות Workspace כדי לאמת את גרסת הייצור של המאגר או ענף פיתוח של המאגר.
אם בחרתם באפשרות Production (ייצור), כדי לזהות את הענף או את הקומיט שמשמשים לגרסת הייצור, תוכלו לעיין בשדה Default Production Branch (ענף הייצור שמוגדר כברירת מחדל) בקטע Git Summary (סיכום Git) בדף Branch Management (ניהול ענפים) של Project Settings (הגדרות הפרויקט) ב-Looker IDE:
- בפרויקטים שהוגדר בהם מצב פריסה מתקדם, גרסת הייצור היא קומיט או תג שנבחרו בכלי הפריסה על ידי מפתח Looker שיש לו את ההרשאה
deploy. - בפרויקטים ללא מצב פריסה מתקדם, גרסת הייצור היא הענף שמוגדר בשדה Git Production Branch Name בדף Project Configuration של Project Settings.
בנוגע לאפשרות מצב פיתוח, חשוב לשים לב לנקודות הבאות כדי לאמת ענפי פיתוח בפרויקט:
- כדי לראות את ההסתעפויות בפרויקט LookML ולזהות את הסתעפות הייצור ואת ההסתעפויות האישיות של המפתחים, אפשר לעיין בדף ניהול הסתעפויות של הגדרות הפרויקט בפרויקט בסביבת הפיתוח המשולבת (IDE) של Looker.
- כדי לאמת הסתעפות פיתוח, צריך לשלוח אותה למאגר LookML. ב-Looker IDE, המשמעות היא שהמפתח צריך ללחוץ על הלחצן Commit Changes & Push או לבחור באפשרות Commit מתוך Git Actions panel ב-IDE.
הפעלה מחדש ידנית של ריצת CI קודמת
משתמש Looker עם ההרשאה see_ci יכול להפעיל מחדש באופן ידני הרצה של CI מ-Looker IDE, עבור הרצות שהסתיימו (אם ההרצה עברה, נכשלה, הציגה שגיאה או בוטלה):
- אם מריצים מחדש ריצה שהופעלה על ידי בקשת מיזוג, שילוב רציף יפעל מול אותה התחייבות כמו בריצה המקורית.
- אם מריצים מחדש ריצה שהופעלה באופן ידני, שילוב רציף (CI) מופעל מול מצב הייצור או מול HEAD של הענף בזמן הריצה מחדש, שיכלול את כל ההתחייבויות הבאות שבוצעו מאז הריצה הראשונית של CI.
בנוסף, אם ערכתם את חבילת ה-CI מאז ההרצה הראשונית, הרצה חוזרת תכלול את כל השינויים שביצעתם בחבילת ה-CI מאז ההרצה הראשונית.
כדי להפעיל מחדש ריצת CI, פועלים לפי השלבים הבאים:
- ב-Looker IDE, לוחצים על סמל השילוב המתמשך בסרגל הניווט של IDE.
- לוחצים על הרצות כדי לפתוח את הדף הרצות.
- בדף Runs, לוחצים על הלחצן View Run של הרצת ה-CI שרוצים לבטל.
- בדף תוצאות ההרצה של ההרצה שנבחרה, לוחצים על הלחצן הרצה חוזרת בחלק העליון של הדף.
אחרי שלוחצים על הפעלה מחדש, כלי אימות התוכן יתחיל את ההפעלה ויחזיר אתכם לדף הפעלה של ההפעלה החדשה.
מידע על הצגת התוצאות זמין בדף התיעוד בנושא הצגת תוצאות של הרצת שילוב רציף.
ביטול של הרצת CI
כדי לבטל הרצה של CI, אפשר לעשות זאת מדף Run שלה באופן הבא:
- ב-Looker IDE, לוחצים על סמל השילוב המתמשך בסרגל הניווט של IDE.
- לוחצים על הרצות כדי לפתוח את הדף הרצות.
- בדף Runs, לוחצים על הלחצן View Run של הרצת ה-CI שרוצים לבטל.
- בדף הפעלה של ההפעלה שנבחרה, לוחצים על הלחצן ביטול בחלק העליון של הדף.
אחרי שלוחצים על ביטול, תהליך השילוב הרציף יבטל את ההרצה ויציג את הסטטוס בוטל בדף הרצה.