נקודת קצה של פריסת webhook מנחה את מופע Looker לפרוס שינויים מענף Git, מ-SHA של קומיט או משם תג, ואז לדחוף את השינויים לגרסת הייצור של הפרויקט. (בקטע פריסה באמצעות תגובות לפעולות מאתר אחר (webhook) מפורטים הפורמטים של תגובות לפעולות מאתר אחר (webhook) של פריסת Looker). ברוב הפרויקטים, Looker מטפל בשילובי Git ופורס עדכונים בסביבת הייצור, כך שלא צריך להגדיר webhook לפריסה.
עם זאת, כן צריך להשתמש ב-webhook לפריסה כדי להעביר שינויים לסביבת הייצור אם מתקיים אחד מהתנאים הבאים:
- אתם דוחפים עדכונים להסתעפות הייצור המרוחקת מחוץ ל-Looker IDE, וזה נפוץ בתהליכי עבודה של פיתוח עם סביבות Staging.
- אתם רוצים להשתמש ב-webhook כדי לפרוס באמצעות מצב פריסה מתקדם, שמאפשר לכם לציין את הענף, את ה-SHA של הקומיט או את שם התג שמשמשים לגרסת הייצור של פרויקט Looker.
- הגדרתם את פרויקט Looker עם בקשות משיכה של Git, כלומר אתם צריכים להפעיל webhook של פריסה אחרי מיזוג בקשת משיכה כדי לדחוף את השינויים האלה לסביבת הייצור של Looker. לרוב שירותי אירוח Git יש דרכים לאוטומציה של התהליך הזה אם מוסיפים את ה-webhook לממשק של ספק Git.
אם אתם אדמינים ב-Looker, אתם יכולים להגדיר את ה-webhook לפריסה כך שיידרש סוד כדי להפעיל אותו, כדי שרק גורמים מורשים יוכלו להפעיל אותו. מפתחי Looker שאין להם הרשאות אדמין יכולים לראות את הדף Project Configuration אבל לא יכולים לשנות את האפשרויות שמופיעות בו.
הוספת סוד פריסה
Looker תומך בסודות אינטרנט עבור ספקי Git הבאים: GitHub, Bitbucket Server ו-GitLab.
כדי להגדיר סוד לפריסת webhook בפרויקט:
- במצב פיתוח, פותחים את הפרויקט ולוחצים על סמל ההגדרות בסרגל הניווט של סביבת הפיתוח המשולבת כדי לפתוח את חלונית הגדרות הפרויקט.
- בחלונית הגדרות הפרויקט, בוחרים באפשרות Configuration (הגדרה).
- גוללים לקטע Webhook Deploy Secret (סוד פריסת ה-Webhook) ולוחצים על Set Webhook Secret (הגדרת סוד ה-Webhook). Looker ייצור באופן אוטומטי טוקן סודי. אתם יכולים להשתמש בסוד שנוצר באופן אוטומטי, או להקליד אסימון סודי משלכם.
- בין אם אתם משתמשים בסוד שנוצר באופן אוטומטי או יוצרים סוד משלכם, אתם צריכים להעתיק את הסוד של פריסת ה-webhook ולהדביק אותו בקובץ טקסט כדי שיהיה לכם אותו אם תצטרכו להוסיף את הסוד ל-webhook של המאגר. חשוב להעתיק אותו בשלב הזה. אחרי שעוזבים את הדף Project Configuration או מרעננים אותו, מאבדים את הגישה לסוד הפריסה של ה-webhook, וצריך לשנות או להסיר את הסוד הזה כדי לקבל שוב גישה לפרויקט.
- לוחצים על שמירת הגדרות הפרויקט.
מעכשיו, כדי להפעיל את ה-webhook לפריסה של הפרויקט, צריך להזין את הסוד הזה. בפרויקטים שמשתמשים במופע Looker staging, צריך לכלול את סוד הפריסה של ה-webhook בכותרת ה-HTTP כדי לבצע פריסה בסביבת הייצור. בפרויקטים עם שילוב של בקשות משיכה מ-Git, צריך לעבור לממשק של ספק Git כדי להוסיף את הסוד ל-webhook של המאגר.
הגדרת הסוד עבור ה-webhook של מאגר Git
בפרויקטים עם שילוב של בקשות משיכה מ-Git, אם הוספתם סוד של webhook לפריסה לפרויקט LookML, אתם צריכים לעבור לממשק של ספק Git כדי להוסיף את הסוד ל-webhook של המאגר. לדוגמה, כך עושים זאת באמצעות GitHub:
עוברים להגדרות של מאגר הפרויקט באתר של ספק Git.
טיפ: אם הגדרתם את הפרויקט לשילוב עם Git, תוכלו להשתמש באפשרות View Project on Git (הצגת הפרויקט ב-Git) בתפריט Git של הפרויקט ב-Looker.
בהגדרות של המאגר, לוחצים על Webhooks.
מאתרים את ה-webhook של פרויקט של LookML ולוחצים על הלחצן עריכה.
בשדה Secret (סוד), מדביקים את סוד הפריסה של ה-webhook שהעתקתם מהקטע Webhook Deploy Secret (סוד הפריסה של ה-webhook) ב-Looker.
לוחצים על עדכון webhook.
מעכשיו נדרש סוד ה-webhook כדי לפרוס שינויים בגרסת הייצור של הפרויקט. במקרה הצורך, אפשר לשנות את הסוד או להסיר את הסוד מהפרויקט.
שינוי סוד הפריסה
אחרי שמוסיפים לפרויקט סוד לפריסת webhook, אם אתם אדמינים ב-Looker, אתם יכולים לשנות את הסוד באופן הבא:
- בפרויקט, לוחצים על סמל ההגדרות בסרגל הניווט.
- גוללים לקטע Webhook Deploy Secret ולוחצים על Reset Secret. המערכת של Looker תיצור באופן אוטומטי טוקן סודי חדש. אפשר להשתמש בסוד שנוצר באופן אוטומטי, או להקליד אסימון סודי חדש משלכם.
- בין אם אתם משתמשים בסוד שנוצר באופן אוטומטי או יוצרים סוד משלכם, אתם צריכים להעתיק את הסוד של פריסת ה-webhook ולהדביק אותו בקובץ טקסט כדי שיהיה לכם אותו אם תצטרכו להוסיף את הסוד ל-webhook של המאגר. חשוב להעתיק אותו מהלוח בשלב הזה. אחרי שיוצאים מהדף Project Configuration או מרעננים אותו, מאבדים את הגישה לסוד הפריסה של ה-webhook, וצריך לחזור לדף ולשנות אותו או להסיר אותו לגמרי.
- לוחצים על שמירת הגדרות הפרויקט.
אם הפרויקט שלכם מוגדר עם שילוב של בקשות משיכה של Git, תצטרכו גם להיכנס לממשק של ספק Git כדי לעדכן את סוד ה-webhook של המאגר.
הסרת סוד פריסה
אחרי שמוסיפים סוד לפריסת webhook לפרויקט, אדמינים ב-Looker יכולים להסיר את הסוד באופן הבא:
- בפרויקט, לוחצים על סמל ההגדרות בסרגל הניווט.
- גוללים לקטע Webhook Deploy Secret ולוחצים על Remove Secret (הסרת ה-Secret). בשלב הזה, אפשר לבטל את הפעולה ולשמור את סוד הפריסה על ידי לחיצה על Don't Remove (אל תסיר).
- כדי להסיר לצמיתות את סוד הפריסה של ה-webhook מהפרויקט, לוחצים על שמירת הגדרות הפרויקט.
הפרויקט כבר לא דורש סוד בשביל ה-webhook של הפריסה. אם הפרויקט שלכם מוגדר עם שילוב של בקשות משיכה של Git, אתם יכולים לעבור עכשיו לממשק של ספק ה-Git כדי להסיר את סוד ה-webhook מהמאגר. מערכת Looker עצמה לא תבדוק יותר אם יש סוד בצד של ספק Git, כך שאין בעיה אם עדיין מוגדר סוד ב-webhook של מאגר Git. אם אתם רוצים להסיר את הסוד ממאגר ה-Git, במאמר הגדרת הסוד עבור ה-Webhook של מאגר ה-Git מוסבר איך לערוך את הסוד בממשק של ספק Git.