הפעלת חבילות של אינטגרציה רציפה (CI)

יש כמה דרכים להפעיל הרצות של אינטגרציה רציפה (CI):

אחרי שבדיקות האימות מסתיימות, אפשר לבדוק את התוצאות, כמו שמתואר בדף התיעוד הצגת התוצאות של הרצת Continuous Integration.

הפעלה אוטומטית מבקשות משיכה

אם הפעלתם את חבילת ה-CI עם Trigger on pull requests from Looker, ה-CI יפעיל הרצת אימות באופן אוטומטי כשמפתח Looker ישלח בקשת משיכה למאגר LookML שלכם. (אפשר גם לציין שרק בקשות משיכה לענפים מסוימים במאגר יפעילו הרצות CI אוטומטיות).

באימות אוטומטי של בקשות משיכה, ה-CI מאמת את ה-commit האחרון של בקשת המשיכה ומחזיר את כל השגיאות בגרסה הזו של המאגר.

במאמר הצגת התוצאות של הרצת Continuous Integration מוסבר איך רואים את התוצאות.

הפעלה אוטומטית מבקשות משיכה של פרויקטים שיובאו

אם הפעלתם את חבילת ה-CI בפרויקט במורד הזרם (spoke) עם Trigger on pull requests from imported projects, ה-CI מפעיל הרצת אימות באופן אוטומטי בפרויקט ה-spoke כשמפתח פותח או מעדכן בקשת משיכה במאגר של פרויקט במעלה הזרם (hub) שהפרויקט רשום אליו.

במהלך הרצת CI שמופעלת על ידי בקשת משיכה של פרויקט מיובא, Looker מבצע את הפעולות הבאות:

  1. אימות גרסת הייצור של פרויקט ה-spoke, תוך הצמדה זמנית של פרויקט ה-Hub המיובא ל-commit של בקשת משיכה (pull request).
  2. כתיבת התוצאה של הרצת ה-CI של פרויקט ה-spoke בחזרה לבקשת משיכה (pull request) במאגר של פרויקט ה-hub.

במאמר הצגת התוצאות של הרצת Continuous Integration מוסבר איך רואים את התוצאות.

הפעלה אוטומטית מ-dbt Cloud

אם הפעלתם את חבילת ה-CI עם Trigger on pull requests from dbt Cloud, ה-CI יפעיל הרצת אימות באופן אוטומטי כשמשימת ה-CI שצוינה ב-dbt Cloud תסתיים.

הרצת CI שמופעלת על ידי משימת CI ב-dbt Cloud נועדה לבדוק אם שינויים בסכימה שבוצעו ב-dbt יגרמו לבעיות בתוכן LookML. במהלך ההרצה, Looker מבצע את הפעולות הבאות:

  1. מקבל את ההתראה מ-dbt Cloud בסיום המשימה.
  2. שליפת הפרטים של הסכימה הזמנית שנוצרה על ידי dbt Cloud להרצה הספציפית הזו.
  3. השם של הסכימה הזמנית הזו מחליף את מאפיין המשתמש שהוגדר (לדוגמה, מאפיין הסכימה של החיבור).
  4. מפעיל את מאמתי ה-CI על הסכימה הזמנית הזו.

כך אפשר לזהות שינויי תוכנה שעלולים לגרום לכשל (כמו עמודות שהושמטו או טבלאות ששמן השתנה) לפני שהשינויים ב-dbt מוזגו לסביבת הייצור. בסיום ההרצה, ערך מאפיין המשתמש חוזר לערך הרגיל שלו עבור משתמשי ה-CI.

הפעלה אוטומטית לפי לוח זמנים

אם הפעלתם את חבילת ה-CI עם הפעלה לפי לוח זמנים, ה-CI יפעיל הרצת אימות באופן אוטומטי לפי לוח הזמנים שציינתם.

בהרצות אוטומטיות מתוזמנות של אימות, ה-CI מאמת את גרסת הייצור של המאגר ומחזיר את כל השגיאות בגרסה הזו.

במאמר הצגת התוצאות של הרצת Continuous Integration מוסבר איך רואים את התוצאות.

הפעלה ידנית של הרצה חדשה של חבילת CI

משתמש Looker עם ההרשאה see_ci יכול להפעיל באופן ידני הרצת CI מ-Looker IDE.

כדי להפעיל באופן ידני הרצה חדשה של חבילת CI, פועלים לפי השלבים הבאים:

  1. ב-Looker IDE, לוחצים על הסמל Continuous Integration בסרגל הניווט של ה-IDE.
  2. לוחצים על Suites כדי לפתוח את הדף Suites.
  3. לוחצים על הלחצן Run suite של חבילת ה-CI שרוצים להריץ (אם אין חבילות CI בפרויקט, אפשר ליצור חבילת CI).

  4. בתיבת הדו-שיח Trigger a run manually, משתמשים באפשרויות של Workspace כדי לבחור את ההסתעפות שרוצים לאמת (פרטים נוספים זמינים בקטע Workspace):

    • כדי לאמת את גרסת הייצור של פרויקט LookML, לוחצים על Production.
    • אם רוצים לאמת הסתעפות פיתוח של פרויקט LookML, לוחצים על Dev Mode (מצב פיתוח). בתפריט הנפתח Branch, בוחרים את ענף הפיתוח שרוצים לאמת.

  5. כדי להפעיל את ההרצה של חבילת ה-CI, לוחצים על Start run.

יכול להיות שחבילת ה-CI תפעל במשך כמה דקות, בהתאם לגודל הפרויקט, למאמתים שכלולים בחבילת ה-CI ולהגדרות של חבילת ה-CI.

אחרי שמפעילים הרצה, ב-Looker IDE מוצג הדף Run של חבילת הבדיקות שהפעלתם. בסיום בדיקות האימות, בדף Run יוצגו התוצאות של כל אחד מהמאמתים. אתם יכולים לצאת מהדף Run בזמן שבדיקות האימות פועלות, ואז לחזור לדף Run כדי לראות את התוצאות.

במאמר הצגת התוצאות של הרצת Continuous Integration מוסבר איך רואים את התוצאות.

Workspace

כשמפעילים באופן ידני הרצה של CI, אפשר להשתמש באפשרויות של Workspace כדי לאמת את גרסת הייצור של המאגר או את הסתעפות הפיתוח של המאגר.

באפשרות Production, אם רוצים לזהות באיזה הסתעפות או commit משתמשים בגרסת הייצור, אפשר לחפש ב-Looker IDE בשדה Default Production Branch בקטע Git Summary בדף Branch Management של הגדרות הפרויקט:

אם בחרתם באפשרות Dev Mode, שימו לב לנקודות הבאות לגבי אימות של הסתעפויות פיתוח בפרויקט:

  • כדי לראות את ההסתעפויות בפרויקט LookML ולזהות את הסתעפות הייצור ואת ההסתעפויות האישיות של המפתחים, עיינו בדף Branch Management בקטע Project Settings של הפרויקט ב-Looker IDE.
  • כדי לאמת הסתעפות פיתוח, צריך להעביר אותה למאגר LookML. ב-IDE של Looker, המשמעות היא שהמפתח צריך ללחוץ על הכפתור Commit Changes & Push או לבחור באפשרות Commit מתוך Git Actions panel ב-IDE.

הרצה מחדש באופן ידני של הרצת CI קודמת

בהרצות שהסתיימו (אם ההרצה עברה, נכשלה, נתקלה בשגיאה או בוטלה), משתמש Looker עם ההרשאה see_ci יכול להפעיל באופן ידני הרצה חוזרת של הרצת ה-CI מ-Looker IDE:

  • אם מריצים מחדש הרצה שהופעלה על ידי בקשת משיכה (שהופעלה על ידי בקשת משיכה במאגר של הפרויקט או בפרויקט מיובא), האינטגרציה הרציפה פועלת על אותו commit כמו ההרצה המקורית.
  • אם מפעילים מחדש הרצה שהופעלה באופן ידני, אינטגרציה רציפה (CI) פועלת מול מצב הייצור או ה-HEAD של ההסתעפות בזמן ההפעלה מחדש, שיכלול את כל השמירות שבוצעו מאז ההרצה הראשונית של אינטגרציה רציפה (CI).

בנוסף, אם ערכתם את חבילת ה-CI מאז ההרצה הראשונית, ההרצה החוזרת תכלול את כל השינויים שביצעתם בחבילת ה-CI מאז ההרצה הראשונית.

כדי להפעיל מחדש הרצת CI:

  1. ב-Looker IDE, לוחצים על הסמל Continuous Integration בסרגל הניווט של ה-IDE.
  2. לוחצים על Runs כדי לפתוח את הדף Runs.
  3. בדף Runs, לוחצים על הלחצן View Run של הרצת ה-CI שרוצים לבטל.
  4. בדף תוצאות ההרצה של ההרצה שנבחרה, לוחצים על הכפתור Rerun בחלק העליון של הדף.

אחרי שלוחצים על Rerun, הכלי לאימות התוכן יתחיל את ההרצה ויחזיר אתכם לדף Run של ההרצה החדשה.

במאמר הצגת התוצאות של הרצת Continuous Integration מוסבר איך רואים את התוצאות.

ביטול הרצה של CI

כדי לבטל הרצה של CI, אתם יכולים לעשות את זה מהדף Run:

  1. ב-Looker IDE, לוחצים על הסמל Continuous Integration בסרגל הניווט של ה-IDE.
  2. לוחצים על Runs כדי לפתוח את הדף Runs.
  3. בדף Runs, לוחצים על הלחצן View Run של הרצת ה-CI שרוצים לבטל.
  4. בדף Run של ההרצה שנבחרה, לוחצים על הכפתור Cancel בחלק העליון של הדף.

אחרי שלוחצים על Cancel, ההרצה תבוטל והסטטוס Cancelled יוצג בדף Run.