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

מה החיבור הזה עושה עבורכם

חיבור GitHub באמצעות אסימון מאפשר לאתר פריסה מאחד מהמאגרים שלכם: לבצע 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 והוסיפו את המאגר.

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

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

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

ניתוק

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

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