Ինչ է տալիս միացումը ձեզ
Zinn® GitHub հավելվածի տեղադրումը թույլ է տալիս կայքին տեղակայվել ձեր ռեպոզիտորիաներից, իսկ նախագծի գրատախտակին՝ համաժամեցված մնալ GitHub-ի հետ՝ առանց մեզ անձնական թոքեն տրամադրելու: Մենք պահում ենք միայն հավելվածի տեղադրման համարը (installation number), որն ինքնին անօգուտ է, և ստեղծում ենք մեկ ժամ տևողությամբ թոքեն ամեն անգամ, երբ դրա կարիքն ունենք: Սա ավելի լավ ընտրություն է կազմակերպության համար, քանի որ այն չի պատկանում որևէ կոնկրետ անձի և չի դադարում գործել, երբ ինչ-որ մեկը հեռանում է:
Նախքան սկսելը
GitHub հաշիվ կամ սեփականատիրոջ իրավունքներ այն կազմակերպությունում, որտեղ ցանկանում եք տեղադրել հավելվածը: Երրորդ կողմի հավելվածներն արգելող կազմակերպություններին անհրաժեշտ է սեփականատիրոջ թույլտվությունը. եթե դա հնարավոր չէ, փոխարենն օգտագործեք նուրբ կարգավորվող թոքեն (fine-grained token) (Միացրեք ձեր 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 հղման վրա ընտրեք The Zinn® GitHub app:
Տեղադրեք Տեղադրման համարը (Installation number) և շարունակեք: Մենք ստուգում ենք տեղադրումը նախքան որևէ բան պահպանելը. համարը, որին չենք կարողանում հասնել, երբեք չի պահպանվում:
Ինչ է տեղի ունենում հետո
- Այն ռեպոզիտորիաները, որոնց հասանելիություն եք տվել հավելվածին, հայտնվում են կայքի համար՝ դրանցից տեղակայելու նպատակով, և push-ը տեղակայում է այն:
- Մեր կողմից կատարվող յուրաքանչյուր գործողություն հայտնվում է տեղադրման աուդիտի մատյանում (audit log) GitHub-ում՝ հավելվածի անվան ներքո, այլ ոչ թե ձեր:
- Մեզ ավելի շատ ռեպոզիտորիաներ տրամադրելու համար փոխեք հավելվածի ռեպոզիտորիաների հասանելիությունը նույն Configure էջում. ոչինչ վերամիացնելու կարիք չկա:
Եթե այն չի միանում
Ռեպոզիտորիան բացակայում է: Տեղադրումը տարածվում է միայն ձեր ընտրած ռեպոզիտորիաների վրա: Բացեք Configure-ը և ավելացրեք այն:
Համարը մերժվում է: Ստուգեք, որ դա հասցեագոտու տեղադրման համարն է, այլ ոչ թե բուն հավելվածի ID-ն, և որ հավելվածը դեռևս տեղադրված է — ապատեղադրված հավելվածը տեղադրում չունի:
Հաղորդվում է, որ բանալին մերժվել է: Գրեթե միշտ երեք պատճառներից մեկն է. դրա հետ պատճենված բացատ կամ տողադարձ, ժամկետանց բանալի կամ բանալի, որը չեղարկվել կամ վերագեներացվել է այն պատճենելուց հետո: Ստեղծեք նորը և կրկին տեղադրեք:
Այն միանում է, բայց ավելի ուշ ինչ-որ բան ձախողվում է: Բանալին անցնում է վավերացումը, բայց չունի այն թույլտվությունը, որն անհրաժեշտ է գործողությանը: Ստեղծեք նոր բանալի՝ վերը նշված թույլտվություններով, ապա անջատեք հին կապը և միացրեք նոր բանալին:
Անջատում
Բացեք Integrations բաժինը, գտեք հաշիվը և սեղմեք Disconnect: Դա անմիջապես կջնջի պահպանված բանալին: Այն ամենը, ինչ օգտագործում էր այն, կդադարի գործել իր հաջորդ գործողության ժամանակ, և դրանից կախված էկրանները կտեղեկացնեն այդ մասին՝ լուռ ձախողվելու փոխարեն:
Անջատումը չի չեղարկում այն, ինչ արդեն արվել է. ձեր հաշվում մեր կողմից փոփոխված գրառումները, տեղակայումները կամ կարգավորումները մնում են այնպես, ինչպես կան: Եթե կարծում եք, որ բուն բանալին կարող է արտահոսած լինել, նաև չեղարկեք այն մատակարարի մոտ. անջատումը հեռացնում է մեր օրինակը, ոչ թե նրանցը: