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

Co vám propojení přinese

Připojení GitLab umožňuje nasazení webu z jednoho z vašich repozitářů na GitLab a umožňuje nám publikovat na GitLab Pages na vašem účtu, kde si jej zvolíte jako hostitele webu.

Než začnete

Účet GitLab s přístupem k projektům, které chcete nasadit.

1. Vytvoření klíče v GitLab

V rozhraní GitLab vyberte svůj avatara v pravém horním rohu, přejděte na položky Edit profile → Access → Personal access tokens a vygenerujte nový token (v nabídce Generate token jej může GitLab označovat jako Legacy token). Pojmenujte jej, nastavte datum platnosti a zaškrtněte tyto rozsahy oprávnění:

• api
• write_repository

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

2. Propojení zde

Otevřete Integrations na svém řídicím panelu a vyberte možnost Connect an account. Jako skupinu zvolte Code hosting a jako účet GitLab, vyplňte položku API token a stiskněte Connect account.

To, co vložite, před uložením otestujeme. Klíč, který nefunguje, se nikdy neuloží a odpověď uvede, co s ním bylo v nepořádku. Funkční klíč se uchovává v zašifrované podobě v našem trezoru hesel – nikdy ne 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: vyberte jej v nastavení připojení repozitáře webu, zvolte repozitář a větev a odeslání (push) provede nasazení.
• Každá další větev může získat vlastní náhled, takže můžete zkontrolovat změnu dříve, než se dostane na živý web.
• Statičtí hostitelé sestavovaní pomocí Git, jako jsou Render a Azure Static Web Apps, používají toto připojení jako zdroj kódu webu.

Pokud se připojení nezdaří

Fungovalo to a pak to přestalo fungovat. Tokeny GitLab mají vždy omezenou platnost – obvykle maximálně jeden rok od jejich vytvoření – a GitLab vás na to předem upozorní e-mailem. Vytvořte nový a propojte jej.

Chybí rozsah oprávnění. Rozsahy oprávnění tokenu nelze po jeho vytvoření změnit; vytvořte nový token s oběma zaškrtnutými rozsahy.

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

Připojení proběhne, ale pozdější akce selže. Klíč sice provede ověření, 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. Vše, co jej používalo, se zastaví při své další akci a obrazovky, které na něm závisely, to namísto tichého selhání oznámí.

Odpojení maže pouze budoucí vazby, nikoli to, co již bylo provedeno – záznamy, nasazení nebo nastavení, která jsme na vašem účtu změnili, zůstávají tak, jak jsou. Pokud se domníváte, že mohlo dojít k úniku samotného klíče, odvolejte jej také u poskytovatele; odpojením se odstraní naše kopie, nikoli jejich.