Připojte svůj účet GitHub pomocí tokenu, aby se vaše weby nasazovaly z repozitáře

Co vám propojení přinese

Propojení GitHub pomocí tokenu umožňuje nasazení webu z jednoho z vašich repozitářů: stačí provést push do větve a web se aktualizuje. Umožňuje nám také publikovat na GitHub Pages na vašem účtu, pokud si tuto službu zvolíte jako hostitele webu.

Pokud vaše repozitáře patří organizaci, dejte přednost aplikaci Zinn® GitHub – viz Instalace aplikace Zinn® GitHub. Token patří jedné osobě a po jejím odchodu přestane fungovat.

Než začnete

Účet GitHub s přístupem k repozitářům, které chcete nasadit. Pokud patří organizaci, vlastník možná bude muset schválit podrobné tokeny (fine-grained tokens).

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

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

V části Repository permissions udělte oprávnění Read and write pro:

• Contents
• Pages
• Administration

Stiskněte Generate token a zkopírujte jej – GitHub jej zobrazí pouze jednou.

2. Propojení zde

Otevřete Integrations ve svém řídicím panelu a zvolte Connect an account. Jako skupinu vyberte Code hosting a jako účet GitHub, vyplňte API token a stiskněte Connect account.

To, co vložite, před uložením otestujeme. Nefunkční klíč se nikdy neuloží a chybová hláška sdělí, co s ním bylo v nepořádku. Fungující klíč se uchovává v zašifrované podobě v našem úložišti tajemství – nikdy v naší databázi – a už se nikdy nezobrazí, a to ani vám.

Co se stane potom

• Web lze nasadit přímo z repozitáře na tomto účtu: zvolte jej v nastavení připojení repozitáře webu, vyberte repozitář a větev a nasazení proběhne pomocí push.
• Každá další větev může získat vlastní náhled, takže si můžete zkontrolovat změnu dříve, než se dostane na živý web.
• Statické hostingové služby postavené na Gitu, jako jsou Render a Azure Static Web Apps, používají toto připojení jako zdroj kódu webu.

Pokud se připojení nezdaří

Repozitář se nezobrazuje. Přístup tokenu k repozitářům jej nezahrnuje. Upravte token na GitHub a přidejte repozitář.

Fungovalo to a pak to přestalo. Podrobné tokeny vyprší v den, který jste zvolili. Vygenerujte nový a připojte jej; GitHub vám zašle e-mail před vypršením platnosti tokenu.

Zobrazuje se hlášení, že klíč byl odmítnut. Téměř vždy jde o jednu ze tří věcí: s klíčem se zkopírovala mezera nebo konec řádku, klíč vypršel, nebo byl odvolán či regenerován poté, co jste jej zkopírovali. Vytvořte nový a vložte jej znovu.

Připojení proběhne, ale pozdější akce selže. Klíč se sice autentizuje, 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 okamžitě smaže uložený klíč. Vše, co jej používalo, se při příští akci zastaví a obrazovky, které na něm závisely, na to upozorní, namísto aby potichu selhaly.

Odpojení maže pouze to, co bylo vytvořeno u nás – záznamy, nasazení nebo nastavení, která jsme změnili na vašem účtu, zůstávají tak, jak jsou. Pokud máte podezření, že samotný klíč mohl uniknout, odvolejte jej také u poskytovatele; odpojením odstraníte naši kopii, nikoli tu jejich.