Propojte svůj účet GitHub pomocí tokenu, aby se vaše stránky nasazovaly z repozitáře

Co vám propojení přinese

Propojení služby GitHub pomocí tokenu umožňuje nasazovat web z jednoho z vašich repozitářů: odešlete změny do větve (push) a web se aktualizuje. Umožňuje nám také publikovat na GitHub Pages ve vašem účtu, pokud tuto možnost zvolíte jako hosting webu.

Pokud vaše repozitáře patří organizaci, dejte přednost aplikaci Zinn® pro GitHub — viz Instalace aplikace Zinn® pro GitHub. Token patří jedné osobě a přestane fungovat, jakmile tato osoba odejde.

Než začnete

Účet GitHub s přístupem k repozitářům, které chcete nasazovat. Pokud patří organizaci, může být nutné, aby pro ni vlastník schválil jemně odstupňované tokeny (fine-grained tokens).

1. Vytvořte klíč na GitHubu

Na GitHubu klikněte na svůj profilový obrázek a poté na Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Pojmenujte jej a zvolte dobu platnosti. V části Repository access zvolte Only select repositories a vyberte ty, které nasazujete — tedy nejužší možný přístup, který funguje.

Pod Repository permissions udělte oprávnění Read and write pro:

• Contents
• Pages
• Administration

Klikněte na Generate token a zkopírujte jej — GitHub jej zobrazí pouze jednou.

2. Propojte jej zde

V administračním panelu otevřete Integrations a zvolte Connect an account. Jako skupinu vyberte Code hosting a jako účet GitHub, vyplňte API token a stiskněte Connect account.

Před uložením čehokoli vložený obsah otestujeme. Klíč, který nefunguje, se nikdy neuloží a v odpovědi se dozvíte, co bylo špatně. Funkční klíč je uchováván šifrovaný v našem trezoru přihlašovacích údajů — nikdy v naší databázi — a již se nikdy znovu nezobrazí, a to ani vám.

Co následuje

• Web se může nasazovat přímo z repozitáře v tomto účtu: zvolte jej v propojení repozitáře webu, vyberte repozitář i větev a nasazení proběhne při pushi.
• Každá další větev může získat vlastní náhled, takže si můžete změnu zkontrolovat ještě předtím, než se dostane na ostrý web.
• Statické hostingy sestavované přes Git, jako jsou Render a Azure Static Web Apps, používají toto propojení jako zdroj kódu webu.

Pokud se propojení nezdaří

Repozitář se nezobrazuje. Přístupová oprávnění tokenu k repozitářům jej nezahrnují. Upravte token na GitHubu a repozitář přidejte.

Fungovalo to a pak přestalo. Platnost jemně odstupňovaných tokenů vyprší k datu, které jste zvolili. Vygenerujte nový a propojte jej; GitHub vám před vypršením platnosti tokenu pošle e-mail.

Hlásí, ž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íč s vypršenou platností, nebo klíč, který byl po zkopírování odvolán či přegenerová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é propojení odpojte a propojte nový klíč.

Odpojení

Otevřete Integrations, vyhledejte daný úč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, tuto skutečnost oznámí, místo aby tiše selhaly.

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