חבר את חשבון ה-GitHub שלך באמצעות אסימון כדי שהאתרים שלך ייפרסו מתוך מאגר

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

חיבור GitHub באמצעות אסימון (token) מאפשר לאתר לפרוס מאחד המאגרים שלכם: בצעו דחיפה (push) לענף והאתר יתעדכן. הוא גם מאפשר לנו לפרסם ב-GitHub Pages בחשבון שלכם, במידה ותבחרו בכך כמארח של האתר.

אם המאגרים שלכם שייכים לארגון, עדיף להשתמש ב-אפליקציית Zinn® ל-GitHub במקום זאת — ראו התקנת אפליקציית Zinn® ל-GitHub. אסימון שייך לאדם אחד ומפסיק לפעול כאשר הוא עוזב.

לפני שמתחילים

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

1. יצירת המפתח ב-GitHub

ב-GitHub, לחצו על תמונת הפרופיל שלכם, ואז על Settings ← Developer settings ← Personal access tokens ← Fine-grained tokens ← Generate new token. תנו לו שם ובחרו תאריך תפוגה. תחת Repository access בחרו ב-Only select repositories ובחרו את אלה שאתם פורסים — הגישה המצומצמת ביותר שתעבוד.

תחת Repository permissions העניקו הרשאת Read and write עבור:

• Contents
• Pages
• Administration

לחצו על Generate token והעתיקו אותו — GitHub מציג אותו פעם אחת בלבד.

2. חיבור כאן

פתחו את Integrations בלוח הבקרה שלכם ובחרו ב-Connect an account. בחרו ב-Code hosting בתור הקבוצה וב-GitHub בתור החשבון, הזינו את API token, ולחצו על Connect account.

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

מה קורה הלאה

• אתר יכול להיפרס ישירות ממאגר בחשבון זה: בחרו בו בחיבור

המאגר של האתר, בחרו את המאגר ואת הענף, ופעולת push תבצע פריסה.

• כל ענף אחר יכול לקבל תצוגה מקדימה משלו, כך שתוכלו לבדוק שינוי לפני שהוא מגיע

לאתר הפעיל.

• שרתי אחסון סטטיים מבוססי Git כגון Render ו-Azure Static Web Apps משתמשים בחיבור זה כמקור לקוד של האתר.

אם החיבור אינו מצליח

מאגר אינו מופיע. גישת המאגרים של האסימון אינה כוללת אותו. ערכו את האסימון ב-GitHub והוסיפו את המאגר.

זה עבד ואז הפסיק. תוקפם של fine-grained tokens פג בתאריך שבחרתם. צרו אחד חדש וחברו אותו; GitHub שולח לכם דוא"ל לפני שתוקף האסימון פג.

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

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

ניתוק

פתחו את Integrations, מצאו את החשבון ולחצו על Disconnect. פעולה זו מוחקת את המפתח השמור מיד. כל מה שהשתמש בו ייעצר בפעולה הבאה שלו, והמסכים שהיו תלויים בו יודיעו על כך במקום להיכשל בשקט.

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