Przejdź do głównej zawartości

BitBucket

Formularz konektora BitBucket

Standardowy formularz konektora, opisany ogólnie w Konektorach. Obsługiwany jest Bitbucket Cloud oraz Bitbucket Data Center i Server.

PoleCo wpisaćPrzykład
Adres URL API konektoraadres API instancjihttps://bitbucket.firma.pl/rest/api/1.0
Nazwa użytkownikalogin konta serwisowego, w Bitbucket Cloud adres e-mail konta Atlassianq247-service
Osobisty token dostępu (PAT)token z uprawnieniem odczytu, w Bitbucket Cloud token API Bitbucket opisany niżej$$BITBUCKET_TOKEN

Zamiast wpisywać login i token wprost, można wskazać zmienne środowiskowe hosta wtyczki, zapisem $$BITBUCKET_USER i $$BITBUCKET_TOKEN. Sposób działania i warunki opisują Konektory.

Uprawnienia na dwóch poziomach

Konto serwisowe potrzebuje uprawnienia odczytu do projektów i do repozytoriów. Uprawnienie tylko na poziomie repozytoriów wystarcza do nawiązania połączenia, ale konektor pominie repozytoria z projektów, do których konto nie ma dostępu. Objawem jest niekompletna lista przy statusie Operacyjny.

W Bitbucket Data Center token generuje się w profilu użytkownika, w sekcji Personal access tokens, z uprawnieniem Read dla projektów i repozytoriów.

Do rozpoznania gałęzi chronionych przy pull requestach token w Data Center potrzebuje uprawnienia administratora repozytorium albo projektu. Bez niego wtyczka zapisuje w logu ostrzeżenie i dalej zbiera pull requesty, bez informacji o ochronie gałęzi docelowej.

W Bitbucket Cloud konektor łączy się tokenem API Bitbucket. W polu „Nazwa użytkownika” podaje się adres e-mail konta Atlassian, a w polu „Osobisty token dostępu (PAT)” token API z dostępem do odczytu repozytoriów (w dokumentacji wtyczki zakres read:repository:bitbucket) oraz z uprawnieniem administratora repozytorium, potrzebnym do odczytu reguł ochrony gałęzi. Hasła aplikacji Bitbucket nie są przyjmowane.

Gdy adres API konektora prowadzi do bitbucket.org, formularz pokazuje trzy dodatkowe pola. Wszystkie są wymagane:

PoleCo wpisać
Workspace Bitbucketworkspace Bitbucket Cloud, z którego konektor pobiera repozytoria
ID organizacji Atlassianidentyfikator organizacji Atlassian
Klucz API Atlassianklucz API administratora organizacji Atlassian

ID organizacji i klucz API Atlassian tworzą osobne poświadczenie, różne od tokenu API Bitbucket z pola „Osobisty token dostępu (PAT)”. Wtyczka korzysta z niego wyłącznie do ustalenia adresów e-mail recenzentów pull requestów, bo API Bitbucket Cloud nie zwraca adresów e-mail innych użytkowników.

Historię wdrożeń CI/CD z Bitbucket Pipelines Q247 zbiera tylko z Bitbucket Cloud. Token API Bitbucket potrzebuje do tego dodatkowo odczytu Pipelines (w dokumentacji Atlassiana zakres read:pipeline:bitbucket), a wdrożenia są odczytywane z workspace'u podanego w polu „Workspace Bitbucket”.

Zobacz też​