Nainstalujte si aplikaci GitHub Zinn®, abychom mohli nasazovat bez dlouhodobého tokenu

Co vám propojení přinese

Instalace aplikace Zinn® GitHub umožní webu nasazení z vašich repozitářů — a projektové nástěnce držet krok se službou GitHub — aniž byste nám museli předávat osobní token. Uchováváme pouze instalační číslo aplikace, které je samo o sobě nepoužitelné, a pokaždé, když token potřebujeme, vygenerujeme nový s platností na jednu hodinu. Pro organizaci je to lepší volba, protože nepatří žádné konkrétní osobě a nepřestane fungovat, když někdo odejde.

Než začnete

Účet GitHub nebo vlastnická práva k organizaci, do které chcete aplikaci nainstalovat. Organizace, které zakazují aplikace třetích stran, vyžadují povolení od vlastníka; pokud to není možné, použijte místo toho jemně odstupňovaný token (Connect your GitHub account).

1. Vytvořte klíč na GitHubu

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, ze kterých chcete, abychom prováděli nasazení.

Poté vyhledejte instalační číslo:

• Osobní účet — Settings → Applications → Installed GitHub Apps a Configure vedle aplikace Zinn®.
• Organizace — Your organizations → Settings → GitHub Apps a Configure vedle aplikace Zinn®.

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

2. Propojte ji zde

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

• Při propojení repozitáře webu zvolte GitHub (app install).
• Při propojení projektové nástěnky s GitHubem zvolte The Zinn® GitHub app.

Vložte Instalační číslo a pokračujte. Před uložením čehokoli instalaci zkontrolujeme; číslo, ke kterému se nemůžeme připojit, se nikdy neuloží.

Co se stane potom

• Repozitáře, které jste aplikaci zpřístupnili, se zobrazí pro nasazení webu a push provede nasazení.
• Každá akce, kterou provedeme, se zobrazí v protokolu auditu instalace na GitHubu pod názvem aplikace, nikoli pod vaším.
• Chcete-li nám udělit přístup k dalším repozitářům, změňte přístup aplikace k repozitářům na stejné stránce Configure — nic není třeba znovu propojovat.

Pokud se propojení nezdaří

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

Číslo bylo odmítnuto. Zkontrolujte, zda se jedná o instalační číslo z adresního řádku, nikoli o vlastní ID aplikace, a zda je aplikace stále nainstalována — odinstalovaná aplikace žádnou instalaci nemá.

Zobrazuje se hlášení, že klíč byl odmítnut. Téměř vždy jde o jednu ze tří věcí: mezera nebo zalomení řádku zkopírované spolu s ním, klíč, jehož platnost vypršela, nebo klíč, který byl po zkopírování odvolán či znovu vygenerován. Vytvořte nový a vložte jej znovu.

Propojí se, ale později něco selže. Klíč se ověří, ale chybí mu oprávnění, které daná akce vyžaduje. Vytvořte nový klíč s výše uvedenými oprávněními, poté staré připojení odpojte 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. Cokoli, co jej používalo, se při své další akci zastaví a obrazovky, které na něm závisely, to oznámí, místo aby tiše selhaly.

Odpojení nevrátí zpět to, co již bylo provedeno — záznamy, nasazení nebo nastavení, která jsme na vašem účtu změnili, zůstanou beze změny. Pokud se domníváte, že mohl uniknout samotný klíč, odvolejte jej také u poskytovatele; odpojením se odstraní naše kopie, nikoli jejich.