מה החיבור מעניק לכם
התקנת אפליקציית ה-GitHub של Zinn® מאפשרת לאתר לבצע פריסה מתוך המאגרים שלכם — וללוח פרויקט להישאר מסונכרן עם GitHub — מבלי למסור לנו אסימון אישי. אנו מחזיקים אך ורק במספר ההתקנה של האפליקציה, שאינו שימושי בפני עצמו, ומנפיקים אסימון שתקף לשעה בכל פעם שאנו זקוקים לו. זוהי הבחירה העדיפה עבור ארגון, מכיוון שהיא אינה שייכת לאדם יחיד ואינה מפסיקה לפעול כאשר מישהו עוזב.
לפני שמתחילים
חשבון GitHub, או הרשאות בעלים בארגון שבו ברצונכם להתקין את האפליקציה. ארגונים האוסרים על אפליקציות צד שלישי דורשים מבעלים לאשר זאת; אם הדבר אינו אפשרי, השתמשו במקום זאת באסימון מותאם אישית (חיבור חשבון ה-GitHub שלכם).
1. יצירת המפתח ב-GitHub
אין מפתח ליצור. התקינו את אפליקציית ה-GitHub של Zinn® בחשבון האישי שלכם או בארגון שלכם, ובחרו בכל המאגרים או רק באלו שתרצו שנפרוס.
לאחר מכן מצאו את מספר ההתקנה:
- חשבון אישי — Settings ← Applications ← Installed GitHub Apps, ולחצו על Configure לצד אפליקציית Zinn®.
- ארגון — Your organizations ← Settings ← GitHub Apps, ולחצו על Configure לצד אפליקציית Zinn®.
המספר שבסוף שורת הכתובת בעמוד זה — לדוגמה github.com/settings/installations/12345678 — הוא מספר ההתקנה.
2. חיבור כאן
האפליקציה נבחרת במקום שבו משתמשים בה ולא במסך האינטגרציות:
- בחיבור המאגר של האתר, בחרו ב-GitHub (התקנת אפליקציה).
- בקישור ה-GitHub של לוח הפרויקט, בחרו ב-אפליקציית ה-GitHub של Zinn®.
הדביקו את מספר ההתקנה והמשיכו. אנו בודקים את ההתקנה לפני שמירת דבר כלשהו; מספר שאיננו יכולים לגשת אליו לעולם אינו נשמר.
מה קורה בהמשך
- המאגרים שהענקתם לאפליקציה מופיעים כדי שהאתר יוכל לבצע מהם פריסה, ופעולת דחיפה (push) פורסת אותו.
- כל פעולה שאנו מבצעים מופיעה ביומן הביקורת של ההתקנה ב-GitHub תחת שם האפליקציה, ולא תחת שמכם.
- כדי להעניק לנו גישה למאגרים נוספים, שנו את גישת המאגרים של האפליקציה באותו עמוד Configure — אין צורך לחבר מחדש דבר.
אם החיבור אינו מצליח
מאגר חסר. ההתקנה כוללת רק את המאגרים שבחרתם. פתחו את Configure והוסיפו אותו.
המספר נדחה. בדקו שזהו אכן מספר ההתקנה משורת הכתובת, ולא המזהה של האפליקציה עצמה, ושהאפליקציה עדיין מותקנת — לאפליקציה שהוסרה אין התקנה.
מוצגת הודעה שהמפתח נדחה. כמעט תמיד מדובר באחד משלושה דברים: רווח או שבירת שורה שהועתקו יחד איתו, מפתח שתוקפו פג, או מפתח שבוטל או נוצר מחדש לאחר שהעתקתם אותו. צרו מפתח חדש והדביקו אותו שוב.
הוא מתחבר, אך משהו נכשל מאוחר יותר. המפתח מאומת אך חסרה לו הרשאה שהפעולה דורשת. צרו מפתח חדש עם ההרשאות המפורטות לעיל, לאחר מכן נתקו את החיבור הישן וחברו את המפתח החדש.
ניתוק
פתחו את אינטגרציות, מצאו את החשבון ולחצו על התנתקות. פעולה זו מוחקת את המפתח השמור באופן מיידי. כל מה שהשתמש בו מפסיק לפעול בפעולה הבאה שלו, והמסכים שהסתמכו עליו מודיעים על כך במקום להיכשל באופן שקט.
הניתוק אינו מבטל את מה שכבר נעשה — רשומות, פריסות או הגדרות ששינינו בחשבונכם נשארים כפי שהם. אם אתם סבורים שהמפתח עצמו דלף, בטלו אותו גם אצל הספק; הניתוק מסיר את העותק שלנו, ולא את שלהם.