מה החיבור מעניק לכם
חיבור GitLab מאפשר לפרוס אתר מאחד ממאגרי ה-GitLab שלכם, ומאפשר לנו לפרסם ב-GitLab Pages בחשבונכם כאשר תבחרו בו כמארח של האתר.
לפני שמתחילים
חשבון GitLab עם גישה לפרויקטים שברצונכם לפרוס.
1. צרו את המפתח ב-GitLab
ב-GitLab, בחרו בסמל המשתמש שלכם בפינה השמאלית העליונה (או הימנית, בהתאם לשפת הממשק), לאחר מכן ב-Edit profile ← Access ← Personal access tokens, והפיקו טוקן חדש (GitLab עשויה לכנות זאת Legacy token בתפריט ה-Generate token). תנו לו שם, הגדירו תאריך תפוגה וסמנו את ההרשאות (scopes) הבאות:
לחצו על Generate token והעתיקו אותו — GitLab מציגה אותו פעם אחת בלבד.
2. חברו אותו כאן
פתחו את Integrations בלוח הבקרה שלכם ובחרו ב-Connect an account. בחרו ב-Code hosting בתור הקבוצה וב-GitLab בתור החשבון, מלאו את ה-API token, ולחצו על Connect account.
אנו בודקים את מה שהדבקתם לפני שדבר כלשהו נשמר. מפתח שאינו עובד לעולם אינו נשמר, והתשובה מציינת מה הייתה הבעיה בו. מפתח שעובד נשמר מוצפן בכספת הסודות שלנו — לעולם לא במסד הנתונים שלנו — ולעולם אינו מוצג שוב, אפילו לא לכם.
מה קורה הלאה
- אתר יכול להיפרס ישירות ממאגר בחשבון זה: בחרו בו בחיבור המאגר של האתר, בחרו את המאגר והענף, ודחיפה (push) תבצע פריסה.
- כל ענף אחר יכול לקבל תצוגה מקדימה משלו, כך שתוכלו לבדוק שינוי לפני שהוא מגיע לאתר החי.
- מארחים סטטיים מבוססי Git כגון Render ו-Azure Static Web Apps משתמשים בחיבור זה כמקור של קוד האתר.
אם החיבור אינו מצליח
זה עבד ואז הפסיק. טוקנים של GitLab תמיד פגים — בדרך כלל לכל היותר שנה לאחר יצירתם — ו-GitLab שולחת לכם אימייל לפני שזה קורה. צרו טוקן חדש וחברו אותו.
הרשאה (scope) חסרה. לא ניתן לשנות הרשאות של טוקן לאחר יצירתו; צרו טוקן חדש כששתי ההרשאות מסומנות.
ההודעה מציינת שהמפתח נדחה. כמעט תמיד מדובר באחד משלושה דברים: רווח או מעבר שורה שהועתקו איתו, מפתח שפג תוקפו, או מפתח שבוטל או הופק מחדש לאחר שהעתקתם אותו. צרו מפתח חדש והדביקו אותו שוב.
הוא מתחבר, אך משהו נכשל מאוחר יותר. המפתח מאומת אך חסרה לו הרשאה שהפעולה דורשת. צרו מפתח חדש עם ההרשאות המפורטות למעלה, לאחר מכן נתקו את החיבור הישן וחברו את המפתח החדש.
ניתוק
פתחו את Integrations, מצאו את החשבון ולחצו על Disconnect. פעולה זו מוחקת את המפתח השמור מיד. כל דבר שהשתמש בו יפסיק לפעול בפעולה הבאה שלו, והמסכים שהיו תלויים בו יציינו זאת במקום להיכשל בשקט.
ניתוק אינו מבטל את מה שכבר נעשה — רשומות, פריסות או הגדרות ששינינו בחשבונכם יישארו כפי שהן. אם אתם סבורים שהמפתח עצמו דלף, בטלו אותו גם אצל הספק; ניתוק מסיר את העותק שלנו, לא את שלהם.