Install the Zinn® GitHub app so we can deploy without a long-lived token

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

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

לפני שתתחילו

חשבון GitHub, או זכויות בעלים בארגון שבו ברצונכם להתקין את האפליקציה. ארגונים האוסרים על שימוש באפליקציות צד שלישי דורשים מבעלים לאשר זאת; אם הדבר אינו אפשרי, השתמשו תחת זאת באסימון ממוקד (חברו את חשבון ה-GitHub שלכם).

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

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

לאחר מכן איתרו את מספר ההתקנה:

• חשבון אישי – הגדרות (Settings) ← יישומים (Applications) ← אפליקציות GitHub מותקנות (Installed GitHub Apps), ולחיצה על הגדר (Configure) לצד אפליקציית Zinn®.
• ארגון – הארגונים שלך (Your organizations) ← הגדרות (Settings) ← אפליקציות GitHub (GitHub Apps), ולחיצה על הגדר (Configure) לצד אפליקציית Zinn®.

המספר המופיע בסופו של סרגל הכתובות בעמוד זה – לדוגמה github.com/settings/installations/12345678 – הוא מספר ההתקנה.

2. חברו אותו כאן

האפליקציה נבחרת במקום שבו נעשה בה שימוש ולא במסך האינטגרציות:

• בחיבור המאגר של אתר, בחרו GitHub (התקנת אפליקציה).
• בקישור ה-GitHub של לוח פרויקטים, בחרו אפליקציית Zinn® GitHub.

הדביקו את מספר ההתקנה והמשיכו. אנו בודקים את ההתקנה לפני שמירת דבר כלשהו; מספר שאיננו יכולים להגיע אליו לעולם אינו נשמר.

מה קורה בהמשך

• המאגרים שהרשיתם לאפליקציה מופיעים כדי שהאתר יוכל לבצע מהם פריסה, ודחיפה (push) מבצעת פריסה.
• כל פעולה שאנו מבצעים מופיעה ביומן הביקורת של ההתקנה ב-GitHub תחת שם האפליקציה, ולא תחת שמכם.
• כדי להעניק לנו מאגרים נוספים, שונו את גישת המאגרים של האפליקציה באותו עמוד הגדר (Configure) – אין צורך לחבר מחדש דבר.

אם החיבור נכשל

מאגר חסר. ההתקנה מכסה אך ורק את המאגרים שבחרתם. פתחו את הגדר (Configure) והוסיפו אותו.

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

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

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

ניתוק

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

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