באינטגרציה של Looker עם Git שמוגדרת כברירת מחדל, מפתחי Looker מבצעים קומיט של השינויים שלהם בהסתעפות הפיתוח, ואז ממזגים את הסתעפות הפיתוח עם הסתעפות הייצור. לאחר מכן, כשפורסים בסביבת Looker, מערכת Looker משתמשת ב-commit האחרון בענף הייצור. (מידע על תהליך העבודה של Git כברירת מחדל ואפשרויות אחרות להטמעות מתקדמות של Git זמין בדף התיעוד שימוש בניהול גרסאות ופריסה).
במקרים מתקדמים של הטמעת Git שבהם לא רוצים שהקומִיט האחרון בענף הייצור ישמש לסביבת Looker, אדמין ב-Looker יכול להפעיל מצב פריסה מתקדם. כשמפעילים את מצב הפריסה המתקדם, מפתח עם הרשאת deploy יכול לציין תג או SHA שונים של קומיט לפריסה בסביבת הייצור של Looker, במקום להשתמש בקומיט האחרון בענף הייצור. אם רוצים לפרוס קומיט מענף אחר, אפשר להשתמש במצב הפריסה המתקדם webhook או נקודת קצה ל-API.
מצב הפריסה המתקדם עוזר לאחד מאגרי מידע בתהליכי עבודה של מפתחים בסביבות מרובות, שבהן כל סביבה מצביעה על גרסה שונה של בסיס קוד. בנוסף, הוא מאפשר למפתח אחד או לכמה מפתחים או אדמינים לקבל שליטה רבה יותר בשינויים שנפרסים בסביבת הייצור.
כשמצב הפריסה המתקדם מופעל, מערכת Looker לא מבקשת מהמפתחים לפרוס את השינויים שלהם בסביבת הייצור. במקום זאת, Looker מציג למפתחים הנחיה למזג את השינויים שלהם עם הסתעפות הייצור. מכאן אפשר לפרוס שינויים רק בדרכים הבאות:
- שימוש בכלי לפריסת אפליקציות
- הפעלת webhook
- באמצעות נקודת קצה ל-API
הפעלה של מצב פריסה מתקדם
כדי להפעיל את מצב הפריסה המתקדם:
- ב-Looker IDE, עוברים לדף Project Configuration (הגדרות הפרויקט) על ידי לחיצה על סמל ההגדרות בתפריט הסמלים ואז על הכרטיסייה Configuration (הגדרה).
- בדף Project Configuration (הגדרת הפרויקט), מסמנים את התיבה לצד Enable Advanced Deploy Mode (הפעלת מצב פריסה מתקדם) בקטע Deployment (פריסה).
- לוחצים על הלחצן Save Project Configuration (שמירת הגדרות הפרויקט) כדי לשמור את השינוי.
ניהול גרסאות באמצעות מצב פריסה מתקדם
כשהמצב המתקדם של פריסה מופעל, מפתחים לא יכולים יותר לפרוס לסביבת ייצור מ-Looker. במקום זאת, כשהמפתח מבצע קומיט, לחצן Git יציע לו למזג את השינויים שלו עם הענף הראשי, במקום להציע לו לפרוס אותם בסביבת הייצור.
השינויים נפרסים בסביבת הייצור באמצעות webhook, API או כלי הפריסה.
Deployment Manager
בפרויקטים שמופעל בהם מצב פריסה מתקדם, מפתחי Looker שיש להם את ההרשאה deploy יכולים להשתמש במנהל הפריסות כדי לפרוס קומיט או תג בסביבת הייצור של Looker.
כדי לגשת לכלי לניהול פריסה, בוחרים בסמל פריסה בתפריט הסמלים.
בכלי לניהול פריסות מוצגים כל הקומיטים והתגים שנפרסו בעבר באמצעות מצב פריסה מתקדם.
אם עדיין לא השתמשתם במצב פריסה מתקדם כדי לפרוס קומיט, לוחצים על הלחצן בחירת קומיט כדי לראות את היסטוריית הקומיטים עם הקומיטים שמפתחי Looker מיזגו לענף הייצור.
בפרויקטים שבהם נעשה שימוש במצב פריסה מתקדם כדי לפרוס קומיט, בהיסטוריית הקומיטים יוצגו גם התגים המשויכים לקומיט, אם יש כאלה, ויופיע ציון של הקומיט שהוא הגרסה הנוכחית שמשמשת לייצור.
אם בענף הייצור יש קומיטים עדכניים יותר מהקומיט שנפרס, מנהל הפריסה יציג את המידע הזה ויציג את הקומיט העדכני ביותר שמפתחי Looker מיזגו לענף הייצור.
פריסת קומיט ממנהל הפריסה
יש כמה דרכים לפרוס קומיט מ-Deployment Manager:
- כדי לפרוס קומיט שעוד לא נפרס, לוחצים על הלחצן Select Commit (בחירת קומיט) כדי לבחור מתוך כל הקומיטים שמוזגו לענף הייצור המרוחק. (אם רוצים לפרוס שמירה מענף אחר, צריך להשתמש במצב הפריסה המתקדם webhook או נקודת קצה ל-API).
- כדי לפרוס את הקומיט האחרון שמוזג בענף הייצור המרוחק, לוחצים על הלחצן Deploy Latest (פריסת הגרסה האחרונה).
- כדי לפרוס קומיט או תג שכבר נפרסו בעבר, לוחצים על תפריט האפשרויות (שלוש נקודות) של הקומיט או התג במנהל הפריסות ואז על פריסה בסביבת הייצור.
אם בוחרים פעולת Commit שלא בוצעה לה פריסה בעבר, בתפריט של כלי הפריסה יופיע האפשרות Deploy Commit (פריסת פעולת Commit). כדי לפרוס קומיט מהתפריט Deploy Commit (פריסת קומיט), פועלים לפי השלבים הבאים:
- כדי לפרוס את הקומיט בלי להקצות לו תג, בוחרים באפשרות Deploy without tagging (פריסה בלי תיוג) ואז באפשרות Deploy to Environment (פריסה בסביבה). אחרת, משאירים את האפשרות Tag and deploy (תיוג ופריסה) מסומנת.
מציינים תג לקומיט. תג Git מציין את החשיבות של הקומיט בהיסטוריה של המאגר, כמו מספר מהדורה או שם גרסה. חשוב לדעת על תגי Git:
- תגי Git חייבים להיות ייחודיים במאגר Git. אי אפשר להשתמש באותו תג לשני קומיטים שונים במאגר.
- תגי Git לא יכולים להכיל רווחים או תווים מיוחדים מסוימים. הכללים למתן שמות להפניות ב-Git מפורטים במאמרי העזרה בנושא Git reference.
אופציונלי: אפשר להוסיף תיאור לתג כדי לספק פרטים נוספים על הקומיט.
לוחצים על פריסה בסביבה כדי לפרוס את הקומיט בגרסת הייצור של מופע Looker.
אחרי שמבצעים פריסה של קומיט, כלי הפריסה מסמן את הקומיט כגרסה הנוכחית בסביבת הייצור של Looker.
פריסה באמצעות webhooks
בפרויקטים עם מצב פריסה מתקדם, אפשר להשתמש ב-webhook של הפריסה כדי לפרוס שינויים בסביבת הייצור.
כדי להגדיר את ה-webhook של הפריסה, קודם צריך להוסיף סוד של webhook לפרויקט Looker בדף Project Configuration. הוספת סוד של webhook מבטיחה שרק גורמים מורשים יוכלו להפעיל את ה-webhook של הפריסה.
יש שני ווּבּהוּקים שאפשר להשתמש בהם כדי לפרוס שינויים בסביבת הייצור כשמצב הפריסה המתקדם מופעל. ווּבּוּק אחד משמש לפריסת ה-HEAD של ענף, והשני משמש לפריסת תג או SHA ספציפיים של Git.
הפורמט של ה-webhook לפריסת ה-head של ענף הוא:
<Looker URL>/webhooks/projects/<LookML project name>/deploy/branch/<Git branch name>
הפורמט של ה-webhook להטמעה של SHA או תג של קומיט הוא:
<Looker URL>/webhooks/projects/<LookML project name>/deploy/ref/<commit SHA or tag>
מחליפים את המידע בסוגריים הזוויתיים < >v1.0 עבור הפרויקט e_faa במופע Looker docsexamples.dev.looker.com:
https://docsexamples.dev.looker.com/webhooks/projects/e_faa/deploy/ref/v1.0
פריסה באמצעות ה-API
בפרויקטים עם מצב פריסה מתקדם, אפשר להשתמש ב-Looker API כדי לפרוס שינויים בסביבת הייצור.
כדי לבצע פריסה באמצעות ה-API, למשתמש ה-API שמבצע את הקריאה צריכה להיות הרשאה deploy. מידע נוסף על אימות ושימוש ב-Looker API זמין בדפי התיעוד בנושא אימות Looker API ותחילת העבודה עם ה-API.
כדי לבצע פריסה באמצעות ה-API, משתמשים בנקודת הקצה deploy_ref_to_production. אפשר לקרוא לנקודת הקצה הזו בכמה דרכים שונות. הדוגמאות הבאות רלוונטיות לשיטות HTTPS ו-SDK.
HTTPS
כדי לבצע פריסה ידנית באמצעות נקודת קצה ל-API של deploy_ref_to_production, אפשר להיעזר בדוגמאות הבאות שבהן נעשה שימוש בשיטת HTTPS. מידע נוסף ודוגמאות לקריאה ידנית ל-API באמצעות בקשות CURL מופיעים בקובץ ה-readme של How to Authenticate to the API ב-GitHub, או שאתם יכולים להשתמש ב-API Explorer. אפשר להתקין את API Explorer במכונה של Looker מ-Looker Marketplace.
בדוגמאות הבאות מוצגת בקשת HTTP לפריסה של head של ענף, של SHA ספציפי של שמירה או של תג באמצעות נקודת קצה ל-API של deploy_ref_to_production:
פריסה של הענף הראשי:
<HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?branch=<BRANCH_NAME>
פריסת תג או SHA של קומיט:
<HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?ref=<SHA_OR_TAG>
SDK
אפשרות אחרת היא להשתמש באחד מערכות ה-SDK של Looker במקום לשלוח בקשות ידניות ל-API. ערכות ה-SDK מטפלות בפרטי האימות, בסריאליזציה של פרמטרים ותגובות ובנושאים אחרים.
פריסה באמצעות deploy_ref_to_production עם שיטת ה-SDK נראית כך:
פריסה של הענף הראשי:
deploy_ref_to_production(<PROJECT_ID>, {branch: <BRANCH_NAME>})
פריסת תג או SHA של קומיט:
deploy_ref_to_production(<PROJECT_ID>, {ref: <SHA_OR_TAG>})