Połącz swoje konto Bitbucket, aby Twoje strony wdrażały się z repozytorium

Co daje nawiązanie połączenia

Połączenie z Bitbucket umożliwia wdrażanie witryny z jednego z Twoich repozytoriów w Bitbucket Cloud: wypchnij zmiany do gałęzi, a witryna zostanie zaktualizowana.

Przed rozpoczęciem

Konto w Bitbucket Cloud z dostępem do repozytoriów, które chcesz wdrażać.

1. Utwórz klucz w Bitbucket

Bitbucket oferuje dwa rodzaje poświadczeń i oba działają:

• Token dostępu do repozytorium, projektu lub obszaru roboczego, utworzony w ustawieniach danego repozytorium, projektu lub obszaru roboczego w sekcji Access tokens. Jest on powiązany z tym repozytorium, projektem lub obszarem roboczym, a nie z konkretną osobą. Przyznaj mu uprawnienia do odczytu repozytoriów.
• Token API na koncie Atlassian. Wybierz swój profil, a następnie Account settings → Security → Create and manage API tokens → Create API token with scopes. Nazwij go, ustaw datę wygaśnięcia, wybierz Bitbucket jako aplikację i zaznacz uprawnienia do odczytu repozytoriów. Bitbucket wyświetla token tylko raz – skopiuj go w tym momencie.

2. Połącz tutaj

Otwórz sekcję Integrations w panelu sterowania i wybierz Connect an account. Wybierz Code hosting jako grupę oraz Bitbucket jako konto, wpisz API token — a jeśli utworzyłeś token na koncie Atlassian zamiast tokenu dostępu, podaj również Account username — i kliknij Connect account.

Przetestujemy wklejone dane przed zapisaniem czegokolwiek. Nie działający klucz nigdy nie jest zapisywany, a komunikat informuje, co było w nim nie tak. Działający klucz jest przechowywany w postaci zaszyfrowanej w naszym magazynie sekretów — nigdy w bazie danych — i nie jest już pokazywany, nawet Państwu.

Nazwa użytkownika określa, w jaki sposób wysyłamy token, dlatego należy ją podać tylko w przypadku tokenu konta. Token dostępu podany wraz z nazwą użytkownika lub token konta bez nazwy użytkownika zostaną odrzucone.

Co dzieje się dalej

• Witrynę można wdrażać bezpośrednio z repozytorium na tym koncie: wybierz je w sekcji połączenia repozytorium

witryny, wskaż repozytorium oraz gałąź, a wypchnięcie zmian uruchomi wdrożenie.

• Każda inna gałąź może mieć własny podgląd, co pozwala sprawdzić zmiany przed ich trafieniem na

żywą witrynę.

• Statyczne platform and hostingu oparte na Gicie, takie jak Render oraz Azure Static Web Apps, korzystają z tego połączenia jako źródła

kodu witryny.

Jeśli połączenie nie powiedzie się

Brak repozytorium. Token dostępu obejmuje wyłącznie repozytorium, projekt lub obszar roboczy, w którym został utworzony. Utwórz go na poziomie obejmującym wszystkie potrzebne repozytoria.

Połączenie działało, a potem przestało. Oba rodzaje tokenów mogą wygasnąć. Utwórz nowy i połącz go ponownie.

Komunikat o odrzuceniu klucza. Prawie zawsze wynika to z jednej z trzech rzeczy: skopiowania wraz z kluczem spacji lub znaku nowej linii, wygaśnięcia klucza albo cofnięcia uprawnień lub wygenerowania klucza na nowo po jego skopiowaniu. Utwórz nowy klucz i wklej go ponownie.

Połączenie się udaje, ale dalsze działania kończą się niepowodzeniem. Klucz przechodzi uwierzytelnianie, ale brakuje mu uprawnień wymaganych przez daną akcję. Utwórz nowy klucz z uprawnieniami wymienionymi powyżej, a następnie rozłącz stare połączenie i połącz się za pomocą nowego klucza.

Rozłączanie

Otwórz sekcję Integrations, znajdź konto i kliknij Disconnect. Spowoduje to natychmiastowe usunięcie zapisanego klucza. Wszelkie elementy korzystające z niego zatrzymają się przy następnej akcji, a ekrany od nich zależne poinformują o tym zamiast cicho zawodzić.

Rozłączenie nie cofa tego, co zostało już wykonane — rekordy, wdrożenia lub ustawienia zmienione na 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.