מה החיבור עושה עבורכם
חיבור Bitbucket מאפשר לאתר לפרוס מאחד ממאגרי ה-Bitbucket Cloud שלכם: בצעו דחיפה (push) לענף והאתר מתעדכן.
לפני שתתחילו
חשבון Bitbucket Cloud עם גישה למאגרים שברצונכם לפרוס.
1. יצירת המפתח ב-Bitbucket
Bitbucket מציע שני סוגי אישורים, ושניהם פועלים:
- אסימון גישה (access token) למאגר, לפרויקט או לסביבת עבודה, שנוצר מההגדרות של אותו מאגר,
פרויקט או סביבת עבודה תחת Access tokens. הוא מקושר לאותו מאגר, פרויקט או סביבת עבודה ולא לאדם מסוים. תנו לו גישת קריאה למאגרים.
- אסימון API בחשבון ה-Atlassian שלכם. בחרו את הפרופיל שלכם, ולאחר מכן **Account settings →
Security → Create and manage API tokens → Create API token with scopes. תנו לו שם, קבעו תאריך תפוגה, בחרו ב-Bitbucket** בתור האפליקציה, ובחרו גישת קריאה למאגרים. Bitbucket מציג את האסימון פעם אחת בלבד; העתיקו אותו אז.
2. חיבור כאן
פתחו את Integrations בלוח הבקרה שלכם ובחרו ב-Connect an account. בחרו את Code hosting כקבוצה ואת Bitbucket כחשבון, מלאו את API token — ואם יצרתם אסימון בחשבון ה-Atlassian שלכם במקום אסימון גישה, גם את Account username — ולחצו על Connect account.
אנו בודקים את מה שאתם מדביקים לפני שדבר מה נשמר. מפתח שאינו עובד לעולם אינו נשמר, והתשובה מציינת מה לא היה תקין בו. מפתח שעובד נשמר בצורה מוצפנת בכספת הסודית שלנו — לעולם לא במסד הנתונים שלנו — ולעולם אינו מוצג שוב, אפילו לא לכם.
שם המשתמש קובע כיצד אנו שולחים את האסימון, לכן הקלידו אותו רק עבור אסימון חשבון. אסימון גישה המוזן עם שם משתמש, או אסימון חשבון ללא שם משתמש, נדחים.
מה קורה בהמשך
- אתר יכול להיפרס ישירות ממאגר בחשבון זה: בחרו אותו בחיבור המאגר
של האתר, בחרו את המאגר והענף, ופעולת דחיפה (push) מבצעת פריסה.
- כל ענף אחר יכול לקבל תצוגה מקדימה משלו, כך שתוכלו לבדוק שינוי לפני שהוא מגיע אל
האתר החי.
- מארחים סטטיים הבנויים על Git כגון Render ו-Azure Static Web Apps משתמשים בחיבור זה כמקור
לקוד של האתר.
אם החיבור נכשל
מאגר חסר. אסימון גישה מגיע רק למאגר, לפרויקט או לסביבת העבודה שבהם הוא נוצר. צרו אחד ברמה המכסה את כל המאגרים הדרושים לכם.
הפעולה עבדה ואז הפסיקה. שני סוגי האסימונים עשויים פוג תוקף. צרו חדש וחברו אותו.
הודעה שהמפתח נדחה. כמעט תמיד אחד משלושה דברים: רווח או מעבר שורה שהועתקו יחד איתו, מפתח שפג תוקפו, או מפתח שבוטל או נוצר מחדש לאחר שהעתקתם אותו. צרו מפתח חדש והדביקו אותו שוב.
החיבור מצליח, אך משהו מאוחר יותר נכשל. המפתח מבצע אימות אך חסרה לו הרשאה שהפעולה דורשת. צרו מפתח חדש עם ההרשאה המפורטת לעיל, ולאחר מכן נתקו את החיבור הישן וחברו את המפתח החדש.
ניתוק
פתחו את Integrations, מצאו את החשבון ולחצו על Disconnect. פעולה זו מוחקת את המפתח השמור באופן מידי. כל דבר שהשתמש בו מפסיק בפעולתו הבאה, והמסכים שהסתמכו עליו מציינים זאת במקום להיכשל בשקט.
ניתוק אינו מבטל את מה שכבר נעשה — רשומות, פריסות או הגדרות ששינינו בחשבון שלכם נשארות כפי שהן. אם אתם סבורים שהמפתח עצמו דלף, בטלו אותו גם אצל הספק; הניתוק מסיר את העותק שלנו, ולא את שלהם.