Podstawowa konfiguracja git na Windowsie¶

1. Różnica między gitem, GitHubem i GitLabem¶

Za nim przystapimy do konfiguracji Gita na Windowsie warto zrozumieć różnicę między Gitem, GitHubem i GitLabem.
Git i GitHub to dwie różne rzeczy.

• Git to oprogramowanie które służy do przechowywania kodu w repozytoriach dzięki czemu pracując w zespole możemy przechowywać kod na serwerze w formie repozytorium.
• GitHub to portal w którym ludzie którzy lubią open-source wrzucają swoje projekty i często wspólnie je rozwijają, GitHub do przechowywania kodu i zarządzania nim używa gita, po prostu różne funkcje gita wyświetla w formie ładnego graficznego interfejsu. GitHub zawiera płatne subskrypcje dla prywatnych repozytoriów, ale nie można samemu zainstalować GitHuba na swoim serwerze (np. dla swojej firmy)
• Natomiast GitLab to alternatywa dla GitHuba którą można sobie samemu zainstalować na swoim serwerze, aktualnie używamy tego do zarządzania kodem i rozpisywania sobie zadań przy projekcie SZA (link).

Dużo o podstawowym używaniu gita można przeczytać tutaj, sekcje Getting started, Git Basics i Git Branching
Do takich najważniejszych funkcji Gita można zaliczyć:

• Automatyczne i ręczne scalanie zmian - co nazywa się mergowaniem i czasem patchowaniem
• Możliwość pracy nad różnymi zadaniami w tym samym czasie - dzięki używaniu branchy
• Cofanie zmian - revert
• Przeglądanie jak kod się zmieniał - log
• Porównywanie różnic między różnymi wersjami plików - diff
• Możliwość wykonywania własnego kodu podczas wrzucania kodu do repozytorium (np. aby uruchomić testy kodu) - hooki

2. Instalacja i konfiguracja git na Windowsie¶

Gita na Windowsa można pobrać tutaj, po pobraniu:

1. Uruchamiamy pobrany plik (na potrzeby instrukcji zakładamy, że pobieramy wersję "Windows Setup")
2. Przy czytaniu licencji wybieramy "Next"
3. Zmieniamy ścieżkę instalacji jeśli chcemy, wybieramy "Next"
4. Podczas wybierania kompomentów nie musimy nic zmieniać, wybieramy "Next" Zdjęcie jakie kompomenty są zaznaczone domyślnie w momencie pisania instrukcjiZdjęcie jakie kompomenty są zaznaczone domyślnie w momencie pisania instrukcji

   

5. Wybieramy czy chcemy dodawać Gita do Start menu w Windowsie
6. Zostaniemy zapytani jaki edytor tekstu chcemy używać w Gicie. Domyślnie zaznaczony edytor to vim który jest naprawdę trudny w używaniu dla osób które nie korzystały nigdy z Linuxa. Wygodnym i prostszym edytorem którego nie musimy dodatkowo instalować jest nano, jeśli jednak chcemy edytor GUI to warto zainstalować Notepada++ i wybrać z listy Zdjęcie z wybranym nanoZdjęcie z wybranym nano

   

7. Konfigurator zapyta czy chcemy zapisać go do ścieżek w Windowsie. Najlepiej pozostawić zaznaczoną drugą opcję, wydaje się najlepszym rozwiązaniem ZdjęcieZdjęcie

   

   Opis wszystkich opcjiOpis wszystkich opcji
   • Możemy wybrać pierwszą pozycję która jest najbezpieczniejsza, Git wtedy będzie działał jedynie w aplikacji Git Bash, nie będzie działał w Windowsowym CMD lub PowerShellu
   • Wybierając drugą opcję zapiszemy gita do ścieżek w Windowsie, komenda git powinna działać w CMD i PowerShellu
   • Decydując się na trzecią opcję nadpisujemy kilka Windowsowych komend na ich linuxowe wersje, oznacza to, że git i kilka linuxowych komend (jak mv) będą dostępne w CMD i PowerShellu. Może to doprowadzić do sytuacji, że aplikacje które korzystają z Windowsowych komend przestaną poprawnie działać
8. Zostaniemy zapytani której biblioteki do połączeń SSH chcemy użyć, pozostajemy przy open-source OpenSSL ZdjęcieZdjęcie

   

9. Decydujemy się na format białych znaków ZdjęcieZdjęcie

   

   Opis wszystkich opcjiOpis wszystkich opcji
   • Pierwsza opcja pozwala nam by podczas pobierania zmian z repozytorium konwertować linuxowe białe znaki na ich Windowsowe odpowiedniki. Ale przed wysłaniem zamieniać je spowrotem na Linuxowe, dzięki czemu edytory na Windowsie nie będą miały z tym żadnych problemów (domyślnie zaznaczona i prawdopodobnie najlepsza)
   • Druga opcja pozwala nam by nie konwertować linuxowych białych znaków na Windowsowe, nie powinno to stworzyć za dużo problemów, ale jakieś mogą się pojawić
   • Trzecia opcja oznacza by nie konwertować w ogóle białych znaków i wysyłać je zawsze tak jak są zapisane, jest to bardzo niezalecana opcja, bo użytkownicy na dwóch różnych systemach operacyjnych (Linux-Windows) będą zawsze wrzucać zamienione białe znaki i możliwe że git będzie w plikach wykrywał wiele konfliktów za każdym razem gdy będziemy coś wrzucać
10. Wybieramy emulator konsoli, najlepiej pozostać przy domyślnie zaznaczonym MinTTY. Windowsowy cmd może mieć problemy z wyświetlaniem znaków spoza tablicy ASCII, ma też problemy ze scrollowaniem zawartości. Pełną listę różnic można przeczytać na stronie MinTTY ZdjęcieZdjęcie

    

11. Na koniec zostaniemy zapytani o kilka dodatkowych opcji, warto zaznaczyć ostatnią opcję o obsługę symbolic links ponieważ używamy tego w SZA w kilku miejscach. ZdjęcieZdjęcie

    

    Opis opcjiOpis opcji
    • Enable file system-caching - Włącza cache'owanie, zazwyczaj przyspiesza działanie gita
    • Enable Git Credential Manager - Git Credential Manager for Windows to dodatkowa aplikacja na Windowsa która w bezpieczniejszy sposób przechowuje informacje o danych do autoryzowania w repozytoriach git. Tutaj trochę więcej o tym
    • Enable symbolic links - Włącza obsługę symbolic linków
    
    Po instalacji zainstalowana zostanie aplikacja Git Bash w której możemy używać gita i kilka linuxowych komend jak mv.
    Warto w gicie ustawić swój adres e-mail i username którym będziemy podpisywać commity:
    

    git config --global user.name "Imię i nazwisko" 
    git config --global user.email "jakiś@email" 
    

    
    Podpisywanie commitów jest dużo bardziej rozbudowane, można o tym doczytać tutaj

3. Popularne problemy podczas używania gita na Windowsie¶

• Git nie pyta o login i hasło podczas klonowania repozytorium z GitLaba i wyrzuca "Access denied"
  Po zainstalowaniu Git Credential Manager for Windows (domyślnie) prośba o zalogowanie się zostanie wyświetlona w nowym okienku Okienko z prośbą o zalogowanie sięOkienko z prośbą o zalogowanie się

  

  
  Wpisanie niepoprawnych danych sprawi, że te zostaną zapamiętane i nie zostaniemy spytani o nie drugi raz, zamiast tego zawsze będziemy otrzymywać Access Denied.
  Źle wpisane dane należy usunąć z Credential Manager

• Wpisano niepoprawny username/email którym podpisujemy commity
  W Git Bash:
  

  git config --global user.name "nowy username" 
  git config --global user.email "nowy@email" 
  

• W konfiguracji gita są dodatkowe pozycje których nie ustawialiśmy
  Git for Windows do najlepszego działania na Windowsie ustawia kilka opcji na podstawie tego co wybierzemy podczas instalacji. Warto nie usuwać tych wartości (Git Bash może przestać działać)
  Listę całej konfiguracji możemy podejrzeć wpisując
  

  git config --global --list
  

• Różnica w konfiguracji gita między repozytoriami
  Git umożliwia zapisywanie różnych konfiguracji między repozytoriami, dlatego wpisując:
  

  git config --local --list
  

  
  Otrzymamy tylko konfigurację dla repozytorium w którym się aktualnie znajdujemy, a wpisując:
  

  git config --global --list
  

  
  Konfigurację globalną, wartości z globalnej konfiguracji są używane jeśli lokalnie nie ustawiono innych wartości