הגדרה ובדיקה של חיבור Git

כשיוצרים פרויקט חדש, הוא קיים רק במצב פיתוח כדי לאפשר לכם לפתח את המודל בסביבה בטוחה שלא תשפיע על משתמשים אחרים. אחרי שמוכנים לפרסם את הפרויקט, השלב הבא הוא להגדיר חיבור Git.

הגדרת חיבור Git לפרויקט מאפשרת לכם לפרוס את LookML במצב ייצור, שבו משתמשים אחרים יכולים לעיין במודל הנתונים שלכם, ליצור לוחות בקרה ולהוסיף LookML למודל. כדי להגדיר מהר יותר, אפשר להשתמש במאגר חשוף. כדי ליצור שילוב חזק יותר של Git, צריך ליצור מאגר Git משלכם ולפעול לפי ההוראות בדף הזה כדי לקשר אותו למופע Looker.

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

שילוב של Looker עם Git

‫Looker משתמש ב-Git כדי לתעד שינויים ולנהל גרסאות של קבצים. כל פרויקט של LookML תואם למאגר Git. בכל פעם שמשתמש נמצא במצב פיתוח, הוא נמצא בענף Git משלו.

כדי לנהל קובץ מקור של LookML, אפשר להגדיר את Looker עם כל ספק Git שמשתמש במפתח SSH או ב-HTTPS לאימות. השלבים הכלליים זהים בכל הפלטפורמות. בדף הזה נשתמש ב-GitHub כדוגמה לחיבור פרויקט Looker ל-Git אחרי יצירת מאגר Git.

כדי לגשת לאפשרויות השילוב של Git, צריך להפעיל את מצב הפיתוח.

אפשר להגדיר שילוב של Git באמצעות אחד מהפרוטוקולים הבאים:

• ‫HTTPS: ‏HyperText Transfer Protocol Secure. ב-HTTPS, ‏ Looker ניגש למאגר Git באמצעות שם משתמש וסיסמה (או טוקן גישה) שאתם מספקים, כמו שמתואר במאמר חיבור ל-Git באמצעות HTTPS.
• ‫SSH: Secure Shell. ב-SSH, ‏ Looker ניגש למאגר ה-Git באמצעות מפתח פריסה שאתם יוצרים דרך האתר של ספק ה-Git, כמו שמתואר במאמר Connecting to Git Using SSH.

התחברות ל-Git באמצעות HTTPS

בפרויקטים של LookML שמוגדרת בהם אימות HTTPS, ‏ Looker מתחבר לספק Git באמצעות חשבון משתמש אחד או יותר שהגדרתם אצל ספק Git. מערכת Looker משתמשת בשם משתמש ובסיסמה (או באסימון גישה) כדי להיכנס לספק Git שלכם ולבצע פעולות Git בשם מפתחי LookML.

אם בחשבון Git שלכם מופעל אימות דו-שלבי, אתם יכולים לעבור לספק Git וליצור אסימוני גישה לשימוש במקום סיסמאות. הוראות ליצירת אסימוני גישה אישיים לספקי Git נפוצים מופיעות בפוסט לקהילה בנושא הגדרת חיבור Git באמצעות HTTPS עם אימות דו-שלבי מופעל.

באמצעות אימות HTTPS, אתם יכולים להגדיר את פרויקט LookML כך שישתמש בחשבון Git יחיד לכל הפרויקט, או להגדיר את הפרויקט כך שישתמש בחשבונות Git האישיים של המפתחים כדי לבצע את פעולות ה-Git שלהם.

הערות לגבי אימות HTTPS ב-GitHub:

• ‫GitHub לא מקבל סיסמאות לחשבונות לצורך אימות פעולות Git ב-github.com. מידע נוסף זמין בפוסט בבלוג של GitHub. כדי לקשר פרויקט Looker ל-GitHub באמצעות HTTPS, צריך להשתמש בהגדרות למפתחים ב-GitHub כדי ליצור טוקן גישה אישי.
• ‫Looker תומך באסימוני גישה אישיים עם הרשאות מפורטות של GitHub.
• יכול להיות שתוקף של אסימוני גישה אישיים או פרטי כניסה שהוגדרו בסביבת הפיתוח של Looker יפוג. כדאי לעקוב אחרי תאריכי התפוגה של אסימון הגישה האישי ל-Git כדי לוודא שהוא מתעדכן ב-Looker לפני שהוא פג. אם לא תעדכנו את טוקן הגישה האישי, עלולות להתרחש שגיאות כשמבצעים פעולות ב-Git. פרטים נוספים זמינים במאמר בנושא פתרון השגיאה Production HTTPS credentials are OK but your development HTTPS credentials are failing to authorize to the remote.

אימות HTTPS בחשבון יחיד

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

באימות HTTPS של חשבון יחיד, לחשבון המשתמש ב-Git שאתם מציינים צריכה להיות גישת קריאה וכתיבה למאגר Git. מפתחי LookML לא צריכים חשבונות משתמש משלהם ב-Git.

אימות HTTPS של כמה חשבונות עם מאפייני משתמש

אם הגדרתם את פרויקט LookML עם כמה חשבונות, פרויקט LookML ישתמש בחשבון Git האישי של כל מפתח Looker כדי לבצע פעולות Git. צריך גם להגדיר חשבון משתמש Git כללי, עם הרשאת קריאה לפחות, ש-Looker ישתמש בו כדי לשלוף את גרסת הייצור של הקבצים.

כדי לבצע אימות של Git באמצעות מאפייני משתמש, צריך לבצע את המשימות הבאות ולעמוד בדרישות הבאות:

• לכל מפתח LookML צריך להיות חשבון משתמש משלו אצל ספק Git. לכל חשבון משתמש ב-Git צריכה להיות גישת קריאה וכתיבה למאגר של הפרויקט.
• אדמין Looker צריך להגדיר חשבונות משתמשים ב-Looker עם מאפייני משתמש שתואמים לשם המשתמש ולסיסמה ב-Git (או אסימון גישה אם בחשבונות המשתמשים ב-Git מופעל אימות דו-שלבי).
• מאפייני המשתמש לסיסמאות (או לטוקנים לגישה) לחשבון Git צריכים להיות מוסתרים. כשיוצרים את מאפיין הסיסמה או אסימון הגישה, בוחרים באפשרות כן בקטע הסתרת ערכים ומזינים את כתובת ה-URL של ספק Git בשדה רשימת ההיתרים של הדומיין.
• צריך למלא את מאפייני המשתמש של שם וסיסמה (או אסימון גישה) ב-Git לכל מפתח Looker. אדמין ב-Looker או משתמש ב-Looker יכולים להגדיר מאפייני משתמש.

בדוגמה הבאה מוצג דף הניהול של מאפייני משתמש, שבו אדמין ב-Looker הגדיר מאפייני משתמש עבור שם המשתמש ב-Git ואסימון הגישה של המשתמש.

בדוגמה הבאה מוצג הדף Account של משתמש Looker, שבו המשתמש הזין את פרטי הכניסה שלו ל-Git בשדות של מאפייני המשתמש.

הגדרת אימות Git באמצעות HTTPS

כדי להגדיר פרויקט LookML עם אימות HTTPS Git, פועלים לפי השלבים הבאים:

1. מקבלים את כתובת ה-URL של מאגר ה-Git בפרוטוקול HTTPS. במקרה של GitHub, במאגרים חדשים (מאגרים שעדיין לא מכילים קבצים), כתובת ה-URL תוצג כחלק מההגדרה הראשונית. חשוב ללחוץ על הלחצן HTTPS בכרטיסייה קוד כדי לקבל את כתובת ה-URL מסוג HTTPS, ואז ללחוץ על סמל העתקת כתובת ה-URL ללוח כדי להעתיק אותה ללוח.

   

   במאגרי GitHub קיימים (מאגרים שכבר מכילים קבצים), אפשר לראות את כתובת ה-URL של HTTPS. לשם כך, עוברים לכרטיסייה Code במאגר ובוחרים בלחצן Code. חשוב לבחור את הקישור HTTPS. אפשר ללחוץ על הסמל העתקת כתובת ה-URL ללוח כדי להעתיק את כתובת ה-URL של ה-HTTPS ללוח.

   

2. עוברים לפרויקט LookML ולוחצים על סמל ההגדרות בסרגל הניווט.

3. בדף Project Configuration (הגדרת הפרויקט), בכרטיסייה Configuration (הגדרה), לוחצים על הלחצן Configure Git (הגדרת Git) (לפרויקטים חדשים) או על הלחצן Reset Git Connection (איפוס החיבור ל-Git) (לפרויקטים קיימים שחוברו ל-Git בעבר).

4. לוחצים על הכפתור Configure Git (הגדרת Git) או על הכפתור Reset Git Connection (איפוס החיבור ל-Git) כדי לפתוח את הדף Configure Git (הגדרת Git).

   איפוס החיבור ל-Git ישמור את היסטוריית ה-Git של הענף הראשי. בנוסף, הוא ישמור את ההיסטוריה של כל ענף אישי של מפתח Looker אחרי שהוא ימשוך, ימזג ויפרוס. כדי לשמור את ההיסטוריה של כל הענפים, אפשר לעיין בדף השיטות המומלצות בנושא מעבר למאגר Git חדש.

   

5. בדף Configure Git ב-Looker, מדביקים את כתובת ה-URL של מאגר ה-Git בשדה Repository URL ולוחצים על Continue.

   ‫Looker יזהה את ספק Git ויעדכן את החלון עם מידע על מאגר Git.

   אם Looker לא יזהה את ספק Git, תתבקשו לבחור מתוך רשימה נפתחת.

6. בוחרים את אפשרות הכניסה ל-Git:

   • שימוש בשם משתמש וסיסמה או טוקן קבועים ויחידים (ראו אימות HTTPS של חשבון יחיד).
   • שימוש במאפייני משתמש לשם משתמש וסיסמה/אסימון (ראו אימות HTTPS של מאפייני משתמש).

7. בשדות שם משתמש וסיסמה/אסימון גישה אישי, מזינים את פרטי הכניסה שבהם ישתמש פרויקט של LookML כדי לגשת ל-Git. הפעולה הזו נדרשת ללא קשר להגדרת הכניסה שלכם ל-Git:

   • אם בחרתם באפשרות Use a single, constant username and password/personal access token combination (שימוש בשם משתמש וסיסמה קבועים), אלה יהיו שם המשתמש והסיסמה (או אסימון הגישה) ב-Git שמופע Looker שלכם ישתמש בהם לכל הפעולות ב-Git. לחשבון המשתמש הזה ב-Git צריכה להיות גישת קריאה וכתיבה למאגר Git.
   • אם בחרתם באפשרות Use user attributes for username and password/personal access token (שימוש במאפייני משתמש לשם משתמש ולסיסמה או לטוקן גישה אישי), אלה שם המשתמש והסיסמה (או טוקן הגישה) של Git שמופע Looker ישתמש בהם כדי לשלוף את גרסת הייצור של המאגר. לחשבון המשתמש הזה ב-Git צריכה להיות לפחות הרשאת קריאה למאגר Git.

   אם בחשבון Git שלכם מופעל אימות דו-שלבי, או אם אתם משתמשים ב-GitHub (שבו נדרש אסימון גישה אישי במקום סיסמה), אתם יכולים להיכנס לספק Git וליצור אסימוני גישה לשימוש במקום סיסמאות. הוראות ליצירת אסימוני גישה אישיים לספקי Git נפוצים מופיעות בפוסט לקהילה הגדרת חיבור Git באמצעות HTTPS עם אימות דו-שלבי מופעל .

8. אם בחרתם באפשרות שימוש במאפייני משתמש לשם משתמש ולסיסמה/טוקן גישה אישי, בתפריטים הנפתחים מאפיין משתמש של שם משתמש ומאפיין משתמש של טוקן גישה אישי שמופיעים בקטע פרטי כניסה במצב פיתוח יוצגו ב-Looker. משתמשים בתפריטים הנפתחים כדי לבחור את מאפייני המשתמש של פרטי הכניסה ל-Git של מפתח מסוים.

   

   (משתמשי Looker יכולים לערוך את הערכים של שדות מאפייני המשתמש בדף Account שלהם, או שאדמינים של Looker יכולים לערוך את הערכים של מאפייני המשתמש של משתמש בדף האדמין Users).

9. לוחצים על הלחצן המשך ההגדרה.

‫Git מוגדר עכשיו לפרויקט של LookML. מכאן אפשר לאמת את ה-LookML, ואז ליצור את השמירה הראשונית ולפרוס לייצור כדי שהפרויקט יהיה זמין במצב ייצור. אפשר גם:

• משתמשים בתפריט Git כדי לגשת אל פקודות Git.
• משתמשים בתפריט Git כדי לבדוק את החיבור ל-Git.
• אם אתם אדמינים ב-Looker, אתם יכולים לעבור אל הגדרות הפרויקט כדי לדרוש אימות של LookML ולהגדיר אפשרויות שילוב של Git.

התחברות ל-Git באמצעות SSH

באימות SSH, יוצרים מפתח פריסה לספק Git. ‫Looker יוצר את זוג מפתחות ה-SSH ומציג את המפתח הציבורי בממשק המשתמש, כמו שרואים בשלב 4. מערכת Looker משתמשת במפתח הפריסה הזה כדי להיכנס לספק Git שלכם ולבצע התחייבויות בשם מפתחי Looker. מערכת Looker מבצעת קומיטים באמצעות שם המשתמש של המפתח ב-Looker, כך שאפשר לדעת איזה מפתח ביצע כל קומיט. אפשר לראות את היסטוריית הקומיטים של הפרויקט בממשק של ספק Git או על ידי בחירה באפשרות היסטוריה בתפריט Git של Looker IDE. מידע נוסף על תפריטי Git ב-Looker זמין במאמר בנושא הפעלת פקודות Git ב-Looker .

כדי להגדיר פרויקט של LookML עם אימות SSH Git, פועלים לפי השלבים הבאים:

1. פותחים את הפרויקט או יוצרים פרויקט של LookML חדש.
2. בפרויקט, לוחצים על סמל ההגדרות בתפריט הסמלים שמימין כדי לפתוח את הדף Project Configuration (הגדרת הפרויקט).

3. בדף Project Configuration (הגדרת הפרויקט), מבצעים אחת מהפעולות הבאות כדי לפתוח את הדף Configure Git (הגדרת Git):

   • בפרויקט ללא חיבור Git, לוחצים על הלחצן Configure Git (הגדרת Git).
   • אם הפרויקט כבר מוגדר עם חיבור Git, לוחצים על הלחצן איפוס חיבור Git.

   איפוס החיבור ל-Git ישמור את היסטוריית ה-Git של הענף הראשי. בנוסף, המערכת תשמור את ההיסטוריה של כל ענף אישי של מפתח Looker אחרי שהוא ימשוך, ימזג ויפרוס. כדי לשמור את ההיסטוריה של כל הענפים, אפשר לעיין בדף השיטות המומלצות בנושא מעבר למאגר Git חדש.

   

4. מקבלים את כתובת ה-URL של ה-SSH למאגר ה-Git. הנה הפורמטים של ספקי Git נפוצים:

   • GitHub: [e-mail]:<organization-name>/<repository-name>.git
   • ‫GitHub Enterprise: [e-mail]:<organization-name>/<repository-name>.git
   • ‫GitLab: ‏ [e-mail]:<organization-name>/<repository-name>.git
   • ‫Bitbucket: [e-mail]:<organization-name>/<repository-name>.git
   • ‫Cloud Source Repositories: ssh://[e-mail]@source.developers.google.com:2022/p/<project-id>/r/<repository-name>
   • ‫Phabricator: ssh://[e-mail]/diffusion/MYCALLSIGN/<repository-name>.git
   הערות:

   • ב-Phabricator, בהגדרת Git בהתאמה אישית, ב-Cloud Source Repositories וב-Gerrit,‏ Looker תומך במשתמשים בהתאמה אישית, כמו [e-mail]:<organization-name>/<repository-name>.git.
   • ב-GitHub,‏ GitHub Enterprise,‏ GitLab ו-Bitbucket (Cloud/Server),‏ Looker תומך רק בgit@ משתמש, כמו [e-mail]:<organization-name>/<repository-name>.git. לכן, צריך לוודא שלמשתמש git יש הרשאה לגשת למאגר Looker.

   במקרה של GitHub, במאגרים חדשים (מאגרים שעדיין לא מכילים קבצים), כתובת ה-SSH תוצג ב-GitHub בכרטיסייה Code כחלק מההגדרה הראשונית. חשוב ללחוץ על הלחצן SSH כדי לקבל את כתובת ה-URL של ה-SSH, ואז ללחוץ על סמל הלוח כדי להעתיק אותה ללוח.

   

   במאגרי GitHub קיימים (מאגרים שכבר מכילים קבצים), אפשר לראות את כתובת ה-URL של ה-SSH. לשם כך, עוברים לכרטיסייה Code במאגר ולוחצים על הכפתור Code. חשוב ללחוץ על הקישור שימוש ב-SSH. אפשר ללחוץ על סמל הלוח כדי להעתיק את הקוד ללוח.

   

5. בדף Configure Git ב-Looker, מדביקים את כתובת ה-SSH של מאגר ה-Git בשדה Repository URL ולוחצים על Continue.

   אפשר להשתמש בכתובות URL עם יציאות Git מותאמות אישית או לא סטנדרטיות ב-Looker. כדי לעשות את זה, צריך להוסיף את מספר היציאה הלא סטנדרטי לכתובת ה-URL של Git. לדוגמה: ssh://[e-mail]:22/myorganization/myproject.git

   כדי שהתכונה הזו תפעל בצורה תקינה, צריך לכלול את התג ssh://.

6. ‫Looker יזהה את ספק Git ויציג מפתח פריסה למאגר. (אם Looker לא יזהה את ספק Git, תופיע בקשה לבחור מתוך רשימה נפתחת). מעתיקים את מפתח הפריסה ללוח, ואז בוחרים בקישור Deploy Key settings for your repository כדי לפתוח את הדף Deploy keys ב-GitHub עבור מאגר GitHub.

7. בכרטיסייה Settings ב-GitHub, בדף Deploy keys, לוחצים על הלחצן Add deploy key:

   

   ב-GitHub מוצג הדף Deploy keys / Add new (מפתחות פריסה / הוספת מפתח חדש).

8. מוסיפים שם למפתח הפריסה. השם לא חשוב, אבל כדאי לכלול את המילה Looker ואת שם הפרויקט כדי שתוכלו לעקוב אחריו בעתיד.

9. מדביקים את מפתח הפריסה שהעתקתם מ-Looker .

10. בוחרים באפשרות מתן הרשאת כתיבה.

    הערה: זהו שלב חשוב, כי Looker דורש את ההגדרה הזו כדי לבצע ולפרוס שינויים במודל LookML.

11. לוחצים על הכפתור הוספת מפתח. (בשלב הזה, יכול להיות שתתבקשו להזין את הסיסמה שלכם בספק Git. אם כן, מזינים את הסיסמה ובוחרים באפשרות אישור הסיסמה.)

12. ב-GitHub יוצגו כל מפתחות הפריסה שנוספו למאגר.

13. חוזרים לחלון Looker ובדף Configure Git (הגדרת Git), בוחרים באפשרות Test and Finalize Setup (בדיקה וסיום ההגדרה).

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

‫Git מוגדר עכשיו לפרויקט של LookML. מכאן אפשר לאמת את ה-LookML, ואז ליצור את השמירה הראשונית ולפרוס לייצור כדי שהפרויקט יהיה זמין במצב ייצור. אפשר גם:

• משתמשים בתפריט Git כדי לגשת אל פקודות Git.
• משתמשים בתפריט Git כדי לבדוק את החיבור ל-Git.
• אם אתם אדמינים ב-Looker, אתם יכולים לעבור אל הגדרות הפרויקט כדי לדרוש אימות של LookML ולהגדיר אפשרויות שילוב של Git.

הגדרת מאגר Git חשוף

כשמגדירים פרויקט עם מאגר Git bare, ‏ Looker יוצר מאגר Git מקומי בשרת Looker ומתחיל את היסטוריית ה-Git של המאגר, במקום להתחבר למאגר אצל ספק Git מרוחק. הגדרת מאגר bare שימושית אם עדיין לא יצרתם מאגר Git מרוחק להתחברות אליו, או אם אתם רוצים להגדיר במהירות כדי שאחרים יוכלו ליהנות מ-LookML שלכם. לדוגמה, כשיוצרים פרויקט חדש במהלך יצירת מודל, המערכת מגדירה אוטומטית את הפרויקט עם מאגר מינימלי.

כשמגדירים פרויקט עם מאגר Git חשוף, אפשר לאפס מאוחר יותר את חיבור ה-Git של הפרויקט מתוך הדף Project settings של הפרויקט וליצור חיבור לספק Git מרוחק באמצעות HTTPS או SSH.

שימו לב למגבלות הבאות שקיימות במאגרי מידע חשופים:

• בפרויקטים שמוגדרים עם מאגר Git ריק, אי אפשר להשתמש באפשרויות שילוב של Git, כמו יצירת בקשת משיכה והצגת קישורים למאגר Git.
• אחרי שיוצרים מאגר מינימלי, אי אפשר ליצור עוד מאגר מינימלי עם אותו שם. מידע נוסף מופיע במאמר הקהילה בנושא שגיאה – 'הפרויקט כבר קיים' עבור מאגר bare.

כדי להגדיר פרויקט של LookML עם מאגר Git ריק:

1. פותחים את הפרויקט או יוצרים פרויקט חדש של LookML.
2. בפרויקט, לוחצים על סמל ההגדרות בתפריט הסמלים שמימין כדי לפתוח את הדף Project Configuration (הגדרת הפרויקט).

3. בדף Project Configuration (הגדרת הפרויקט), מבצעים אחת מהפעולות הבאות כדי לפתוח את הדף Configure Git (הגדרת Git):

   • בפרויקט ללא חיבור Git, לוחצים על הלחצן Configure Git (הגדרת Git).
   • אם הפרויקט כבר מוגדר עם חיבור Git, לוחצים על הלחצן איפוס חיבור Git.

   איפוס החיבור ל-Git ישמור את היסטוריית ה-Git של הענף הראשי. בנוסף, המערכת תשמור את ההיסטוריה של כל ענף אישי של מפתח Looker אחרי שהוא ימשוך וימזג ואז יפרוס. כדי לשמור את ההיסטוריה של כל הענפים, אפשר לעיין בדף השיטות המומלצות בנושא מעבר למאגר Git חדש.

4. בתחתית הדף Configure Git, לוחצים על Set up a bare repository instead (הגדרה של מאגר bare במקום זאת).

   

5. בתיבת הדו-שיח Configure Bare Git Repository (הגדרת מאגר Git חשוף), בוחרים באפשרות Create Repository (יצירת מאגר).

   אחרי שמאגר Git נוצר, Looker יציג תיבת דו-שיח עם הכיתוב Bare Repository Created (נוצר מאגר Bare).

‫Git מוגדר עכשיו לפרויקט של LookML. מכאן אפשר לאמת את ה-LookML, ואז ליצור את השמירה הראשונית ולפרוס לייצור כדי שהפרויקט יהיה זמין במצב ייצור. אפשר גם:

• משתמשים בתפריט Git כדי לגשת אל פקודות Git.
• משתמשים בתפריט Git כדי לבדוק את החיבור ל-Git.
• אם אתם אדמינים ב-Looker, אתם יכולים לעבור אל הגדרות הפרויקט כדי לדרוש אימות של LookML ולהגדיר אפשרויות שילוב של Git.

בפרויקטים שהוגדרו עם מאגר Git חשוף, אפשר להשתמש באפשרות איפוס חיבור Git אם רוצים לקשר את הפרויקט לספק Git (ראו את ההוראות לשימוש ב-HTTPS או ב-SSH). עם זאת, לא מומלץ להתחבר למאגר Git שכבר יש לו היסטוריית Git. אם הגדרתם את פרויקט LookML עם repository חשוף, ‏ Looker יוצר repository בשרת Looker ומתחיל את היסטוריית ה-Git של ה-repository. אם בהמשך תקשרו את פרויקט LookML למאגר Git שיש לו היסטוריית Git, מערכת Looker לא תוכל להשוות בין שתי היסטוריות ה-Git ולא תוכלו לבצע פעולות Git.

חיבור פרויקט LookML חדש למאגר Git לא ריק

הגדרת Git לניהול גרסאות היא שלב חשוב ביצירת פרויקט חדש של LookML. בדרך כלל, לכל פרויקט צריך להיות מאגר משלו. עם זאת, יכול להיות שתצטרכו להגדיר פרויקט עם מאגר Git שמכיל LookML קיים, למשל במקרים הבאים:

• כשמעבירים פרויקט של LookML קיים בין מופעים
• כשמשחזרים קוד מפרויקט של LookML פגום או לא פעיל לשימוש בפרויקט חדש

אזהרה: אל תשתמשו בהליך הזה אם הגדרתם את הפרויקט עם מאגר מינימלי. אם הגדרתם את פרויקט LookML עם מאגר חשוף, Looker יוצר מאגר בשרת Looker ומתחיל את היסטוריית ה-Git של המאגר. אם בהמשך תקשרו את פרויקט LookML למאגר Git שיש לו היסטוריית Git, מערכת Looker לא תוכל להשוות בין שתי היסטוריות ה-Git ולא תוכלו לבצע פעולות Git.

בקטע הזה מפורטות שיטות מומלצות להגדרת פרויקט חדש של LookML עם מאגר Git קיים ולא ריק, לצורך פיתוח נוסף של LookML.

הערה: תהליך העבודה הזה רלוונטי רק למאגרי מידע שיש לכם הרשאת כתיבה אליהם.

1. כדי ליצור פרויקט LookML חדש, בוחרים באפשרות פרויקט ריק כנקודת ההתחלה. פרויקט ריק הוא נקודת ההתחלה, כי הוא יאוכלס באובייקטים של LookML ממאגר קיים, ולא מסכמת מסד נתונים או משאילתת SQL.
2. מגדירים את Git לפרויקט באמצעות HTTPS או SSH, באמצעות כתובת ה-URL של הפרויקט הלא ריק בקטע Repository URL בדף Configure Git.
3. אחרי שמגדירים את Git לפרויקט, מושכים מנתוני הייצור מהחלונית Git Actions.
4. אחרי ששולפים את הנתונים מסביבת הייצור, בוחרים באפשרות פריסה בסביבת הייצור.

השינויים שתבצעו ב-LookML בפרויקט לא ישפיעו על המאגר המקורי, אלא יישמרו בגרסה המקומית של המאגר.

אם אתם רוצים להשתמש במאגר ציבורי ספציפי כבסיס לפרויקט של LookML ריק, אבל אין לכם הרשאת כתיבה למאגר הזה, אתם צריכים לפעול לפי ההוראות שמפורטות בקטע שיבוט מאגר Git ציבורי בדף התיעוד יצירת פרויקט של LookML חדש.

אם אתם מגדירים תהליך עבודה ב-Git באמצעות מאגר אחד בכמה מופעים, תוכלו לקרוא מידע נוסף בפוסט בקהילה בנושא תהליך עבודה ב-Git באמצעות מאגר אחד בכמה מופעים – פיתוח, הכנה לייצור וייצור.

בדיקת החיבור ל-Git

‫Looker מספק בדיקה של חיבור Git כדי לוודא שהחיבור ל-Git תקין. בדיקת החיבור ל-Git מוודאת שהגדרתם את כתובת ה-URL הנכונה של Git ושהמארח של Git נגיש ל-Looker . בנוסף, בדיקת החיבור ל-Git מאמתת שסיפקתם מפתח פריסה תקין ל-Git, ושמפתח הפריסה כולל גישת כתיבה למאגר Git.

אם Looker לא מצליח להתחבר למאגר ה-Git, בלחצן Git יוצג הטקסט בדיקת החיבור ל-Git כדי להנחות אתכם לפתור את בעיית החיבור.

אפשר גם לגשת לכלי לבדיקת חיבור Git על ידי בחירה באפשרות בדיקת חיבור Git בחלונית פעולות Git:

לאחר מכן, כלי הבדיקה של חיבור Git מציג את השלבים שהוא מבצע כדי לבדוק את חיבור Git:

1. בדיקת git remote
2. שם המארח של שירות git יפוענח
3. הרשת פועלת בשירות git
4. אימות פרטי ההרשאה
5. בדיקה שלפרטי הכניסה יש הרשאת כתיבה

אם שלב מסוים מצליח, Looker מציג סימן וי ירוק מימין לשלב. אם שלב מסוים לא מצליח, Looker מציג סימן וי אדום משמאל לשלב וגם מציג הודעת שגיאה.

בדוגמה הבאה מוצגת בדיקה מוצלחת:

בדוגמה הבאה, למאגר Git אין מפתח פריסה שהוגדר לחיבור Looker. סימני הווי הירוקים שמימין לשלושת השלבים הראשונים מציינים שהשלבים האלה בוצעו בהצלחה:

• Examine git remote
• Host name for git service will resolve
• Networking to the git service is operational

סימני ה-V האדומים שמשמאל לשני השלבים האחרונים מציינים שהשלבים האלה נכשלו:

• Verify authorization credentials
• Ensure credentials allow write access