Připojte svůj účet Bitbucket, aby se vaše stránky nasazovaly z repozitáře

Co vám propojení přinese

Propojení Bitbucket umožňuje nasazovat web z jednoho z vašich repozitářů v Bitbucket Cloud: odešlete změny do větve (push) a web se aktualizuje.

Než začnete

Účet Bitbucket Cloud s přístupem k repozitářům, které chcete nasazovat.

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

Bitbucket nabízí dva druhy přihlašovacích údajů a fungují oba:

• Přístupový token pro repozitář, projekt nebo pracovní prostor, vytvořený z vlastního nastavení daného repozitáře, projektu nebo pracovního prostoru v části Access tokens. Je vázán na daný repozitář, projekt nebo pracovní prostor, nikoli na konkrétní osobu. Udělte mu přístup pro čtení k repozitářům.
• Token API ve vašem účtu Atlassian. Vyberte svůj profil a poté Account settings → Security → Create and manage API tokens → Create API token with scopes. Pojmenujte jej, nastavte dobu platnosti, jako aplikaci zvolte Bitbucket a vyberte přístup pro čtení k repozitářům. Bitbucket zobrazí token pouze jednou; v té chvíli si jej zkopírujte.

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 Bitbucket, vyplňte API token — a pokud jste místo přístupového tokenu vytvořili token ve svém účtu Atlassian, zadejte také Account username, a stiskněte Connect account.

To, co vložíte, otestujeme ještě předtím, než se cokoli uloží. Nefunkční klíč se nikdy neuloží a v odpovědi bude uvedeno, co s ním bylo v nepořádku. Funkční klíč je uchováván v šifrované podobě v našem trezoru tajných údajů — nikdy v naší databázi — a již se nikdy znovu nezobrazí, a to ani vám.

Uživatelské jméno určuje, jak token odesíláme, proto jej zadávejte pouze pro token účtu. Přístupový token zadaný s uživatelským jménem nebo token účtu zadaný bez něj bude odmítnut.

Co se stane potom

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

Pokud se propojení nezdaří

Repozitář chybí. Přístupový token má dosah pouze k repozitáři, projektu nebo pracovnímu prostoru, ve kterém byl vytvořen. Vytvořte jej na takové úrovni, která pokrývá všechny repozitáře, jež potřebujete.

Fungovalo to a pak to přestalo. Platnost obou druhů tokenů může vypršet. Vytvořte nový a propojte jej.

Hlásí to, ž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, platnost klíče vypršela, nebo byl klíč 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 ú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é staré 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, na to upozorní, 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 samotný klíč mohl uniknout, odvolejte jej také u poskytovatele; odpojením se odstraní naše kopie, nikoli jejich.