Propojte svůj účet Bitbucket, aby se vaše weby nasazovaly z úložiště

Co vám propojení přinese

Propojení Bitbucket umožňuje nasazení webu z jednoho z vašich repozitářů na Bitbucket Cloud: proveďte push do větve a web se aktualizuje.

Než začnete

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

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

Bitbucket nabízí dva druhy přihlašovacích údajů a funguje každý z nich:

• Přístupový token pro repozitář, projekt nebo pracovní prostor, vytvořený v nastavení daného repozitáře,

projektu nebo pracovního prostoru v sekci Access tokens. Je vázán na daný repozitář, projekt nebo pracovní prostor namísto na konkrétní osobu. Udělte mu oprávnění k čtení repozitářů.

• API token na vašem účtu Atlassian. Vyberte svůj profil a potom **Account settings →

Security → Create and manage API tokens → Create API token with scopes. Pojmenujte ho, nastavte dobu platnosti, vyberte Bitbucket** jako aplikaci a zvolte oprávnění k čtení repozitářů. Bitbucket zobrazí token pouze jednou; poté si ho zkopírujte.

2. Propojení zde

Otevřete Integrations ve svém řídicím panelu a zvolte Connect an account. Vyberte Code hosting jako skupinu a Bitbucket jako účet, vyplňte API token — a pokud jste vytvořili token na svém účtu Atlassian namísto přístupového tokenu, vyplňte také Account username — a stiskněte Connect account.

Před uložením cokoliv, co vložíte, otestujeme. Nefunkční klíč se nikdy neuloží a odpověď uvede, co s ním bylo v nepořádku. Fungující klíč se uchovává šifrovaný v našem trezoru tajných kódů – nikdy ne v naší databázi – a už se nikdy nezobrazí, a to ani vám.

Uživatelské jméno určuje, jak token odešleme, takže ho zadejte pouze pro token účtu. Přístupový token zadaný s uživatelským jménem nebo token účtu bez něj bude odmítnut.

Co se stane potom

• Web lze nasadit přímo z repozitáře na tomto účtu: vyberte ho v připojení repozitáře

webu, zvolte repozitář a větev a 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

ostrý web.

• Statické hostingové služby sestavované přes Git, jako jsou Render a Azure Static Web Apps, používají toto připojení jako

zdroj kódu webu.

Pokud se připojení nezdaří

Chybí repozitář. Přístupový token dosáhne pouze do repozitáře, projektu nebo pracovního prostoru, ve kterém byl vytvořen. Vytvořte ho na úrovni, která pokrývá každý repozitář, který potřebujete.

Fungovalo to a pak to přestalo. Oba druhy tokenu mohou vypršet. Vytvořte nový a propojte ho.

Hlásí to, že klíč byl odmítnut. Téměř vždy jde o jednu ze tří věcí: mezera nebo zalomení řádku zkopírované s ním, klíč, jehož platnost vypršela, nebo klíč, který byl odvolán či regenerován poté, co jste ho zkopírovali. Vytvořte nový a vložte ho znovu.

Připojí se to, ale něco později selže. Klíč se ověří, 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, najděte účet a stiskněte Disconnect. Tím se uložený klíč okamžitě smaže. Cokoliv, co ho používalo, se při další akci zastaví a obrazovky, které na něm závisely, to oznámí, namísto aby potichu selhaly.

Odpojení nevezme zpět to, co již bylo provedeno – záznamy, nasazení nebo nastavení, která jsme změnili na vašem účtu, zůstanou tak, jak jsou. Pokud si myslíte, že mohl uniknout samotný klíč, odvolejte ho také u poskytovatele; odpojením odstraníte naši kopii, nikoli jejich.