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

Co vám propojení přinese

Propojení služby GitLab umožňuje nasadit web z jednoho z vašich repozitářů v GitLab a umožňuje nám publikovat na GitLab Pages ve vašem účtu, pokud jej zvolíte jako hostitele webu.

Než začnete

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

1. Vytvořte klíč ve službě GitLab

V GitLab vyberte vpravo nahoře svého avatara, poté Edit profile → Access → Personal access tokens a vygenerujte nový token (GitLab jej v nabídce Generate token může označovat jako Legacy token). Pojmenujte jej, nastavte datum vypršení platnosti a zaškrtněte tyto rozsahy (scopes):

• api
• write_repository

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

2. Propojte jej zde

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

Před uložením čehokoli nejprve otestujeme, co jste vložili. Klíč, který nefunguje, se nikdy neuloží a v odpovědi se dozvíte, co s ním bylo v nepořádku. Klíč, který funguje, je uchováván šifrovaný v našem trezoru tajemství (secrets vault) — nikdy v naší databázi — a již se nikdy znovu nezobrazí, a to ani vám.

Co se stane potom

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

Pokud se propojení nezdaří

Fungovalo to a pak to přestalo. Tokenům GitLab vždy vyprší platnost — obvykle nejpozději rok po jejich vytvoření — a GitLab vám před vypršením zašle e-mail. Vytvořte nový a propojte jej.

Chybí rozsah (scope). Rozsahy tokenu nelze po jeho vytvoření změnit; vytvořte nový token se zaškrtnutými oběma rozsahy.

Zobrazuje se, ž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íči vypršela platnost, nebo byl klíč 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 úspěšně ověří, ale postrádá oprávnění, které daná akce vyžaduje. Vytvořte nový klíč s výše uvedenými oprávněními, poté původní propojení odpojte a propojte 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ím se 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 došlo k úniku samotného klíče, odvolejte jej také u poskytovatele; odpojením se odstraní naše kopie, nikoli jejich.