BitBucket

Standardowy formularz konektora, opisany ogólnie w Konektorach. Obsługiwany jest Bitbucket Cloud oraz Bitbucket Data Center i Server.
| Pole | Co wpisać | Przykład |
|---|---|---|
| Adres URL API konektora | adres API instancji | https://bitbucket.firma.pl/rest/api/1.0 |
| Nazwa użytkownika | login konta serwisowego, w Bitbucket Cloud adres e-mail konta Atlassian | q247-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.
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:
| Pole | Co wpisać |
|---|---|
| Workspace Bitbucket | workspace Bitbucket Cloud, z którego konektor pobiera repozytoria |
| ID organizacji Atlassian | identyfikator organizacji Atlassian |
| Klucz API Atlassian | klucz 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ż
- Konektory: wspólny formularz, uprawnienia tokenu, statusy
- Uruchomienie analizy kodu: co zrobić po zapisaniu konektora
- Wdrożenia CI/CD: historia wdrożeń z Bitbucket Pipelines i wymagania wobec wtyczki