Какво ви дава свързването
Инсталирането на приложението Zinn® GitHub позволява на даден сайт да се разполага от вашите хранилища, а таблото на проекта да се синхронизира с GitHub, без да ни предоставяте личен токен. Ние съхраняваме само номера на инсталацията на приложението, който е безполезен сам по себе си, и генерираме токен, който издържа един час всеки път, когато ни е необходим. Това е по-добрият избор за организация, тъй като той не принадлежи на никое конкретно лице и не спира да работи, когато някой напусне.
Преди да започнете
Акаунт в GitHub или права на собственик в организацията, където искате да инсталирате приложението. Организациите, които забраняват приложения на трети страни, изискват собственик да разреши това; ако това не е възможно, използвайте вместо това токен с прецизен обхват (Свържете своя GitHub акаунт).
1. Създайте ключа в GitHub
Няма ключ за създаване. Инсталирайте приложението Zinn® GitHub във вашия личен акаунт или във вашата организация и изберете или всички хранилища, или само тези, които искате да разположим.
След това намерете номера на инсталацията:
- Личен акаунт — Settings → Applications → Installed GitHub Apps и Configure до приложението Zinn®.
- Организация — Your organizations → Settings → GitHub Apps и Configure до приложението Zinn®.
Номерът в края на адресната лента на тази страница — например github.com/settings/installations/12345678 — е номерът на инсталацията.
2. Свържете го тук
Приложението се избира там, където се използва, а не на екрана „Интеграции“:
- Във връзката с хранилището на сайт изберете GitHub (app install).
- Във връзката с GitHub на табло на проект изберете Приложението Zinn® GitHub.
Поставете Installation number и продължете. Ние проверяваме инсталацията, преди да запазим каквото и да било; номер, до който нямаме достъп, никога не се съхранява.
Какво се случва след това
- Хранилищата, до които сте дали достъп на приложението, се появяват, за да може сайтът да се разполага от тях, и ново изпращане (push) го разполага.
- Всяко действие, което предприемаме, се появява в одитния журнал на инсталацията в GitHub под името на приложението, а не във вашето.
- За да ни предоставите още хранилища, променете достъпа до хранилищата на приложението на същата страница Configure — нищо не се нуждае от повторно свързване.
Ако не се свърже
Липсва хранилище. Инсталацията обхваща само хранилищата, които сте избрали. Отворете Configure и го добавете.
Номерът е отхвърлен. Проверете дали това е номерът на инсталацията от адресната лента, а не собственото ID на приложението, и дали приложението все още е инсталирано — деинсталираното приложение няма инсталация.
Показва се съобщение, че ключът е отхвърлен. Почти винаги се дължи на едно от три неща: интервал или знак за нов ред, копирани заедно с него, изтекъл ключ или ключ, който е бил отменен или генериран наново, след като сте го копирали. Създайте нов и го поставете отново.
Свързва се, но нещо по-късно се проваля. Ключът се автентифицира, но му липсва разрешение, необходимо за действието. Създайте нов ключ с разрешенията, изброени по-горе, след което прекъснете старата връзка и свържете новия ключ.
Прекъсване на връзката
Отворете Integrations, намерете акаунта и натиснете Disconnect. Това незабавно изтрива съхранения ключ. Всичко, което го е използвало, спира при следващото си действие, а екраните, които са зависели от него, съобщават за това, вместо да се провалят тихо.
Прекъсването на връзката не отменя вече извършеното — записите, разполаганията или настройките, които сме променили във вашия акаунт, остават такива, каквито са. Ако смятате, че самият ключ може да е бил изтекъл, отменете го и при доставчика; премахването на връзката премахва нашето копие, но не и тяхното.