Lepsza jakość kodu dzięki Bitbucket: 4 początkowe kroki

Zacznijmy od dodania kodu.

Krok 1: Umieszczenie kodu w Bitbucket

Repozytoria to miejsca w Bitbucket, w których znajduje się kod. W zależności od potrzeb, można rozpocząć pracę na kilka sposobów:

Od zera

Tworzenie nowego pustego repozytorium

1. Kliknij przycisk + na globalnym pasku bocznym z lewej strony i w obszarze Create new (Utwórz nowe) wybierz opcję Repository (Repozytorium).

2. Nadaj repozytorium nazwę. To ważne! Nazwa repozytorium zostanie uwzględniona w jego adresie URL.

3. Dla opcji Include a README? (Dołączyć plik README?) wybierz ustawienie Yes, with a template (Tak, z szablonem).

4. Przy pozostałych opcjach pozostaw ustawienia domyślne i kliknij przycisk Create (Utwórz).

Od innego dostawcy

Importowanie repozytorium od innego dostawcy Git

1. Kliknij przycisk + na globalnym pasku bocznym z lewej strony i w obszarze Import (Importuj) wybierz opcję Repository (Repozytorium).

2. Podaj adres URL, pod którym repozytorium jest dostępne.

3. Jeśli repozytorium wymaga uwierzytelnienia, zaznacz opcję Requires authorization (Wymagane uwierzytelnienie) i podaj dane uwierzytelniające niezbędne do uzyskania dostępu.

4. Nadaj repozytorium nazwę. To ważne! Nazwa repozytorium zostanie uwzględniona w jego adresie URL.

5. Przy pozostałych opcjach pozostaw ustawienia domyślne i kliknij przycisk Import repository (Importuj repozytorium).

Krok 2: Lokalna konfiguracja, globalna współpraca

Klonowanie repozytorium Bitbucket

1. Kliknij przycisk + na globalnym pasku bocznym z lewej strony i w obszarze Get to work (Rozpocznij pracę) wybierz opcję Clone this repository (Klonuj to repozytorium).

2. Wybierz opcję HTTPS z menu w prawym górnym rogu (chyba że zostały już skonfigurowane klucze SSH).

3. Skopiuj polecenie klonowania.

W interfejsie wiersza poleceń

• Przejdź do katalogu, do którego chcesz sklonować swoje repozytorium. cd

• Wklej polecenie git clone skopiowane z Bitbucket (powinno wyglądać mniej więcej tak): git clone https://username@bitbucket.org/teamsinspace/documentation-test.git

Na dysku lokalnym pojawi się nowy podkatalog o takiej samej nazwie jak nazwa sklonowanego repozytorium. Jeśli sklonowano puste repozytorium, ten katalog lokalny może nie mieć jeszcze żadnej zawartości. 

Wprowadzanie zmian w pliku w Bitbucket online

Zaczekajcie, nie mam w Bitbucket żadnych plików...

Opcjonalny krok dodania pliku README do repozytorium Bitbucket został pominięty? Bez obaw. Jeśli repozytorium wciąż jest puste, przejdź do niego i utwórz ten plik, klikając przycisk Create a README (Utwórz plik README). W ten sposób masz do sklonowania coś więcej niż tylko puste repozytorium.

Ściąganie aktualizacji z Bitbucket

W interfejsie wiersza poleceń

1. Przejdź do katalogu, do którego chcesz sklonować swoje repozytorium. cd

2. Wklej polecenie skopiowane z Bitbucket (powinno wyglądać mniej więcej tak): git clone

W ten sposób wszelkie zmiany wprowadzone w tych plikach zostały pobrane do systemu lokalnego.

Krok 3: Podstawy tworzenia gałęzi za pomocą Bitbucket

Tworzenie gałęzi umożliwia poszczególnym członkom zespołu jednoczesną pracę nad różnymi rzeczami bez ingerowania w oryginalną bazę kodu lub nawzajem w swoją pracę. Gdy zmiany będą gotowe do scalenia, wypchniesz gałąź do Bitbucket, gdzie będzie można ją sprawdzić w ramach pull requestu.

Gałęzie można tworzyć na kilka sposobów. Wybierz ten, który najlepiej odpowiada potrzebom Twojego zespołu.

Tworzenie gałęzi

W Bitbucket (najłatwiejszy sposób)

1. Z poziomu repozytorium kliknij przycisk + na globalnym pasku bocznym i w obszarze Get to work (Rozpocznij pracę) wybierz opcję Create a branch (Utwórz gałąź).

2. W wyświetlonym oknie wybierz opcję Type (Typ) (jeśli korzystasz z modelu tworzenia gałęzi), wprowadź nazwę w polu Branch name (Nazwa gałęzi) i kliknij przycisk Create (Utwórz).

W interfejsie wiersza poleceń

1. Po utworzeniu uruchom polecenie git fetch, a następnie wyewidencjonuj gałąź z systemu lokalnego. Bitbucket automatycznie wyświetli potrzebne polecenie, które będzie wyglądało mniej więcej tak: git fetch && git checkout

2. Wprowadź zmiany lokalnie, a następnie dodaj, zatwierdź i wypchnij je do gałęzi za pomocą polecenia:

   git add .

   git commit -m "dodanie zmiany z gałęzi funkcji"git push origin

3. Kliknij stronę Source (Źródło) repozytorium. Na liście rozwijanej powinna być widoczna zarówno gałąź main, jak i utworzona gałąź.

W interfejsie wiersza poleceń

Z poziomu interfejsu wiersza poleceń w katalogu lokalnym repozytorium

1. Utwórz gałąź za pomocą polecenia Git branch.

2. Wyświetl listę gałęzi dla tego repozytorium. Zobaczysz domyślną gałąź główną oraz nowo utworzoną gałąź. 

3. Wyewidencjonuj gałąź.

4. Wypchnij nową gałąź do Bitbucket. 

Przejdźmy teraz do Bitbucket, aby zobaczyć naszą gałąź.

1. Przejdź do repozytorium. 

2. Kliknij opcję Branches (Gałęzie).

W systemie Jira

Ten sposób wymaga dostępu do rozwiązania Jira Software Cloud oraz jego integracji z Bitbucket. Potrzebne są do tego uprawnienia administratora. Jeśli jednak chcesz pobawić się integracją i zobaczyć jak działa, zawsze możesz zarejestrować się, aby skorzystać z bezpłatnej wersji próbnej Jira Software Cloud.

Instrukcje na temat integracji tych dwóch produktów po skonfigurowaniu witryny Jira zawiera artykuł Łączenie Bitbucket Cloud z Jira Software Cloud.

Krok 4: Sprawdzanie zmian w kodzie za pomocą pull requestu

Po wypchnięciu zmian w kodzie do Bitbucket inna osoba powinna sprawdzić te zmiany. Pull requesty stanowią prosty i skuteczny sposób recenzowania kodu i współpracy w środowisku współdzielonym z zespołem.

Tworzenie pull requestu

1. Z poziomu otwartego repozytorium kliknij przycisk + na globalnym pasku bocznym i w obszarze Get to work (Rozpocznij pracę) wybierz opcję Create a pull request (Utwórz pull request).

2. Wypełnij pozostałe pola formularza pull requestu:

1. Source (Źródło): repozytorium oraz gałąź, w których wprowadzono zmiany w kodzie wymagające scalenia.

2. Destination (Lokalizacja docelowa): repozytorium oraz gałąź, z którymi chcesz scalić wprowadzone zmiany.

3. Title (Tytuł) i Description (Opis): te dwa pola będą widoczne w powiadomieniach e-mail, a tytuł będzie wyświetlany na liście pull requestów.

4. Reviewers (Recenzenci): wybierz recenzentów, którzy przedstawią konstruktywną opinię i zatwierdzą zmiany.

5. Close branch (Zamknij gałąź): wybranie tej opcji spowoduje automatyczne zamknięcie gałęzi po scaleniu pull requestu.

6. Diff (Wykaz różnic) i Commits (Commity): na tych kartach można zapoznać się z wprowadzonymi zmianami lub uwzględnionymi commitami.

1. Kliknij przycisk Create pull request (Utwórz pull request).

Utworzony pull request można zobaczyć na listach pull requestów po kliknięciu opcji Pull requests (Pull requesty) na bocznym pasku nawigacji repozytorium.

Sprawdzanie pull requestu

Jako recenzent, będziesz otrzymywać powiadomienia o pull requestach do sprawdzenia. Otwarte pull requesty znajdziesz również na karcie Pull requests (Pull requesty) na pulpicie. Istnieje wiele sposobów sprawdzania kodu w ramach procesu zapewniania jakości, jednak to, w jaki sposób Twój zespół będzie recenzował kod, zależy tylko od Ciebie. Oto kilka sposobów skutecznej komunikacji ze współpracownikami, dzięki którym każdy będzie wiedział, co zostało zmienione i zatwierdzi zmiany do scalenia.

Wyświetlanie wykazów różnic Podczas wyświetlania pull requestu widoczne będą wykazy różnic (zmiany) we wszystkich zmodyfikowanych plikach, które w nim uwzględniono. Wiersze podkreślone na zielono zostały dodane, a przekreślone na czerwono — usunięte. Możesz również kliknąć kartę Commits (Commity) u góry pull requestu, aby wyświetlić uwzględnione commity. Jest to przydatne podczas sprawdzania dużych pull requestów.

Pozostawienie informacji zwrotnych i zadawanie pytań w komentarzach W Bitbucket można dodawać komentarze do całego pull requestu, konkretnego pliku lub określonego miejsca w pliku. Jest to przydatne rozwiązanie, które pozwala uwzględnić kontekst lub szczegóły dotyczące zamieszczonej informacji zwrotnej. Komentarze mogą zawierać obrazy, łącza, tekst sformatowany oraz unikatowy adres URL, dzięki któremu można szybko udostępniać konkretne komentarze.

Zatwierdzanie lub odrzucanie pull requestu Po sprawdzeniu zmian w kodzie musisz poinformować autora pull requestu, czy nadaje się on do scalenia. Kliknięcie przycisku Approve (Zatwierdź) spowoduje wysłanie do autora pull requestu powiadomienia z informacją o możliwości bezpiecznego scalenia zmian. Odrzucenie pull requestu spowoduje wysłanie odwrotnej informacji. Raz odrzuconego pull requestu nie można ponownie otworzyć. Aby scalić gałąź, trzeba otworzyć nowy pull request.

Pamiętaj, że odrzucenie pull requestu nie jest szczególnie miłe dla jego autora i możliwość tę należy zachować na potrzeby całkowicie nietrafionych zmian lub prac, które nie są już potrzebne. Recenzując czyjąś pracę, utrzymuj życzliwy ton i zawsze staraj się zrozumieć innych, a nie tylko oczekiwać, że to oni muszą rozumieć Ciebie.

Scalanie pull requestu Po sprawdzeniu i zatwierdzeniu kodu w pull requeście kliknij przycisk Merge (Scal), aby scalić swoją gałąź z gałęzią główną. Wówczas zmiany wprowadzone w kodzie w gałęzi źródłowej zostaną w pełni włączone do gałęzi docelowej.