Nainstalujte aplikaci Zinn® GitHub, abychom mohli provádět nasazení bez tokenu s dlouhou platností

Co pro vás toto připojení znamená

Instalace aplikace Zinn® GitHub umožňuje nasazení webu z vašich repozitářů – a projektové nástěnky mohou být synchronizované s GitHub – aniž byste nám museli poskytovat osobní token. Uchováváme pouze číslo instalace aplikace, které samo o sobě k ničemu neslouží, a při každé potřebě si vygenerujeme token s platností na jednu hodinu. Je to lepší volba pro organizaci, protože nepatří žádnému jednotlivci a nepřestane fungovat, když někdo odejde.

Než začnete

Účet na GitHub nebo vlastnická práva k organizaci, kam chcete aplikaci nainstalovat. Organizace, které zakazují aplikace třetích stran, vyžadují, aby vlastník aplikaci povolil; pokud to není možné, použijte raději jemně odlišený token (Připojení účtu GitHub).

1. Vytvoření klíče na GitHub

Není třeba vytvářet žádný klíč. Nainstalujte aplikaci Zinn® GitHub do svého osobního účtu nebo do své organizace a vyberte buď všechny repozitáře, nebo pouze ty, které chcete, abychom nasadili.

Poté vyhledejte číslo instalace:

• Osobní účet – Settings → Applications → Installed GitHub Apps a klikněte na Configure vedle aplikace Zinn®.
• Organizace – Your organizations → Settings → GitHub Apps a klikněte na Configure vedle aplikace Zinn®.

Číslo na konci adresního řádku na této stránce – například github.com/settings/installations/12345678 – je číslo instalace.

2. Připojení zde

Aplikace se vybírá tam, kde se používá, nikoliv na obrazovce Integrace:

• U připojení repozitáře webu vyberte GitHub (app install).
• U odkazu GitHub projektové nástěnky vyberte The Zinn® GitHub app.

Vložte Installation number a pokračujte. Před uložením čehokoliv instalaci ověříme; číslo, které nedokážeme kontaktovat, se nikdy neuloží.

Co se stane potom

• Repozitáře, ke kterým jste aplikaci udělili přístup, se zobrazí jako možnost pro nasazení webu a každé odeslání (push) web nasadí.
• Každá naše akce se zobrazí v protokolu auditu instalace na GitHub pod názvem aplikace, nikoliv pod vaším.
• Chcete-li nám poskytnout další repozitáře, změňte přístup aplikace k repozitářům na stejné stránce Configure – nic není nutné znovu připojovat.

Pokud se připojení zdaří

Chybí repozitář. Instalace zahrnuje pouze repozitáře, které jste vybrali. Otevřete položku Configure a přidejte ho.

Číslo je odmítnuto. Zkontrolujte, zda se jedná o číslo instalace z adresního řádku, nikoliv o ID samotné aplikace, a zda je aplikace stále nainstalovaná – odinstalovaná aplikace nemá žádnou instalaci.

Zpráva uvádí, že klíč byl odmítnut. Téměř vždy jde o jednu ze tří věcí: s klíčem se zkopírovala mezera nebo zalomení řádku, klíč vypršel nebo byl po zkopírování zneplatněn či vygenerován znovu. Vytvořte nový a vložte jej znovu.

Připojení proběhne, ale něco později selže. Klíč se sice ověří, ale chybí mu oprávnění, které akce vyžaduje. Vytvořte nový klíč s výše uvedenými oprávněními, poté odpojte staré připojení a připojte nový klíč.

Odpojení

Otevřete Integrations, vyhledejte účet a stiskněte Disconnect. Tím se uložený klíč okamžitě smaže. Cokoliv, co jej používalo, se při příští akci zastaví a obrazovky, které na něm závisely, na to upozorní, namísto tichého selhání.

Odpojení nevezme zpět to, co již bylo provedeno – záznamy, nasazení nebo nastavení, která jsme na vašem účtu změnili, zůstanou tak, jak jsou. Pokud máte podezření, že mohl uniknout samotný klíč, zneplatněte jej také u poskytovatele; odpojením odstraníte naši kopii, nikoliv tu jejich.