Połącz swoje konto Bitbucket, aby twoje witryny były wdrażane z repozytorium

Co daje nawiązanie połączenia

Połączenie z Bitbucket pozwala witrynie na wdrażanie z jednego z Państwa repozytoriów w Bitbucket Cloud: wystarczy wypchnąć zmiany do gałęzi, a witryna się zaktualizuje.

Zanim zaczniesz

Konto Bitbucket Cloud z dostępem do repozytoriów, które chcą Państwo wdrażać.

1. Utwórz klucz w Bitbucket

Bitbucket oferuje dwa rodzaje danych uwierzytelniających i każdy z nich działa:

• Token dostępu dla repozytorium, projektu lub przestrzeni roboczej, utworzony z poziomu ustawień danego repozytorium, projektu lub przestrzeni roboczej w sekcji Access tokens. Jest on powiązany z tym repozytorium, projektem lub przestrzenią roboczą, a nie z konkretną osobą. Należy nadać mu uprawnienia do odczytu repozytoriów.
• Token API na Państwa koncie Atlassian. Proszę wybrać swój profil, a następnie Account settings → Security → Create and manage API tokens → Create API token with scopes. Proszę nadać mu nazwę, ustawić datę wygaśnięcia, wybrać Bitbucket jako aplikację i wskazać dostęp do odczytu repozytoriów. Bitbucket wyświetla token tylko raz; należy go wtedy skopiować.

2. Połącz go tutaj

Proszę otworzyć Integrations w panelu nawigacyjnym i wybrać Connect an account. Jako grupę należy wybrać Code hosting, a jako konto Bitbucket, wypełnić pole API token — oraz, jeśli utworzono token na koncie Atlassian zamiast tokena dostępu, również Account username — i nacisnąć Connect account.

Testujemy wklejoną treść przed zapisaniem czegokolwiek. Klucz, który nie działa, nigdy nie jest zapisywany, a odpowiedź wskazuje, co było z nim nie tak. Działający klucz jest przechowywany w postaci zaszyfrowanej w naszym magazynie wpisów tajnych — nigdy w naszej bazie danych — i nie jest już nigdy więcej pokazywany, nawet Państwu.

Nazwa użytkownika decyduje o sposobie przesyłania tokena, dlatego należy ją wprowadzać tylko w przypadku tokena konta. Token dostępu wprowadzony z nazwą użytkownika lub token konta bez niej zostanie odrzucony.

Co dzieje się dalej

• Witryna może wdrażać się bezpośrednio z repozytorium na tym koncie: wystarczy wybrać je w połączeniu repozytorium witryny, wskazać repozytorium oraz gałąź, a wypchnięcie zmian zainicjuje wdrożenie.
• Każda inna gałąź może otrzymać własny podgląd, dzięki czemu mogą Państwo sprawdzić zmianę, zanim trafi ona na działającą stronę.
• Statyczne usługi hostingowe oparte na Git, takie jak Render i Azure Static Web Apps, używają tego połączenia jako źródła kodu witryny.

Jeśli połączenie nie zostanie nawiązane

Brakuje repozytorium. Token dostępu obejmuje tylko repozytorium, projekt lub przestrzeń roboczą, w której został utworzony. Proszę utworzyć go na poziomie, który obejmuje każde potrzebne repozytorium.

Działało, a potem przestało. Oba rodzaje tokenów mogą wygasnąć. Proszę utworzyć nowy token i go połączyć.

Komunikat informuje o odrzuceniu klucza. Prawie zawsze jest to jedna z trzech rzeczy: skopiowana wraz z nim spacja lub znak nowej linii, klucz, który wygasł, albo klucz, który został unieważniony lub wygenerowany ponownie po skopiowaniu. Proszę utworzyć nowy klucz i wkleić go ponownie.

Łączy się, ale coś później kończy się błędem. Klucz uwierzytelnia się pomyślnie, ale brakuje mu uprawnień wymaganych przez daną operację. Proszę utworzyć nowy klucz z uprawnieniami wymienionymi powyżej, a następnie odłączyć stare połączenie i podłączyć nowy klucz.

Rozłączanie

Proszę otworzyć Integrations, znaleźć konto i nacisnąć Disconnect. Spowoduje to natychmiastowe usunięcie zapisanego klucza. Wszystko, co z niego korzystało, zatrzyma się przy kolejnym działaniu, a ekrany, które od niego zależały, poinformują o tym, zamiast kończyć działanie w milczeniu.

Rozłączenie nie cofa tego, co zostało już zrobione — rekordy, wdrożenia lub ustawienia, które zmieniliśmy na Państwa koncie, pozostają bez zmian. Jeśli podejrzewają Państwo, że sam klucz mógł wyciec, należy go również unieważnić u dostawcy; rozłączenie usuwa naszą kopię, a nie ich.