wrz
14
2013

Git, Bitbucket, TortoiseGit i Puttygen – Konfiguracja i import projektu (clone repository)

Po dłuższej walce z konfiguracją Git i serwisu Bitbucket na stacji roboczej stwierdziłem, że warto by ulżyć innym i opisać sposób konfiguracji tego środowiska do prowadzenia repozytorium projektu. Poniżej jest podany przepis jak krok po kroku przejść sprawnie ten proces (ok. 20 min).

Dlaczego Bitbucket?

Może ktoś zapytać dlaczego akurat ten serwis, skoro GitHub jest bardziej popularny?
Odpowiedź jest prosta: Jest darmowy i można na nim trzymać prywatne projekty bez udostępniania ich jako openSource. Np. GitHub w wersji darmowej wymaga udostępnienia projektu z otwartym kodem. Chciałem tego uniknąć. Za wersję z prywatnym repo należy już płacić okresowy abonament.
W trakcie pracy na Bitbucket zdarzy Wam się czasem krzyknąć “WTF?!”, ale pomimo kilku niedociągnięć, wersja darmowa serwisu do 5 użytkowników dla jednego konta, to rekompensuje :)

 

Instalacja w skrócie

  1. Instalacja Git.
  2. Instalacja TortoiseGit.
  3. Generowanie kluczy SSH przez PuttyGen.
  4. Konfiguracja Bitbucket – klucz publiczny SSH.
  5. Import projektu.

 

Instalacja Git

  1. Pobieramy Plink.exe. Jest wymagany, aby pobierać repo przez SSH.
  2. Pobieramy msysgit.
  3. Rozpoczynamy instalację.
  4. Wybieramy folder docelowy.
  5. Wybieramy opcje widoczne na screenie.
    Ważne, aby odznaczyć Git Bash Here oraz Git GUI Here. Dzięki temu tylko TortoiseGit będziemy widzieć w Windows Context Menu.
    git_install
  6. Klikamy dalej i widzimy ekran, na którym zaznaczamy Use Git Bash only.
    git_install_2
  7. Następnie wskazujemy na wcześniej pobrany program Plink.
    git_install_3
  8. Zaznaczamy Checkout Windows-style
    git_install_4
  9. Kończymy instalację podstawowego środowiska Git.
    git_install_5

 

Instalacja TortoiseGit

  • Pobieramy TortoiseGit.
  • Rozpoczynamy instalację.
    tortoisegit_install
  • Cały czas klikamy Dalej. Nie zmieniamy domyślnych ustawień instalatora.

 

Generowanie kluczy SSH przez PuttyGen

W przypadku, gdy nie posiadamy istniejących kluczy skonfigurowanych w Bitbucket, generujemy nowe.

  • Pobieramy i uruchamiamy PuttyGen.
  • Zaznaczamy Type of key to generate: SSH-2 RSA.
  • Wpisujemy w polu Number of bits in a generated key: 1024.
  • Klikamy Generate.
  • Machamy myszką :)
  • Wpisujemy w Key passphrase wymyślone hasło, które potem podamy przy pierwszym request’cie z TortoiseGit, aby potwierdzić klucz prywatny.
    puttygen
  • Klikamy Save private key i zapisujemy klucz prywatny na dysku lokalnym. Potem użyjemy go w konfiguracji TortoiseGit.
  • Klucz publiczny nie zapisujemy na dysku ponieważ, gdy skopiujemy go z pliku serwis BitBucket może nam tego nie zaakceptować (więcej informacji). Pobieramy go poprzez skopiowanie w Puttygen zawartości pola Public key for pasting into…

Ważne, aby wybrać powyższe ustawienia w ten a nie inny sposób. Z inną konfiguracją generowania Bitbucket może nam nie zaakceptować klucza publicznego.

 

Konfiguracja kluczy SSH w Bitbucket

  • W serwisie Bitbucket klikamy w prawej górnej części ekranu ikonę edycji konta.
    Manage account -> SSH keys -> Add key.
  • Wpisujemy własną nazwę klucza i wklejamy jego zawartość z Puttygen.

Dopiero teraz TortoiseGit będzie mógł się komunikować po SSH dzięki kluczowi prywatnemu.

 

Import projektu

  1. Będąc zalogowanym w Bitbucket kopiujemy skrót do istniejącego repozytorium, np. git@bitbucket.org:twoje_konto/twoj_projekt.git
  2. Na dysku lokalnym wchodzimy do folderu nadrzędnego, w którym będziemy pracować nad importowanym projektem.
  3. Klikamy prawym myszy i wybieramy Git Clone…
    git_clone
  4. W polu URL wpisujemy adres do wybranego repo.
    Directory jest naszym folderem, do którego repo zostanie sklonowane.
    Branch jest nazwą naszego lokalnej gałęzi projektu. Najlepiej nazwijmy ją tak samo jak oryginalna.
    Origin jest nazwą gałęzi (branch) na Bitbucket – zdalne repo.
    Load Putty Key należy wskazać ścieżkę do klucza prywatnego wygenerowanego wcześniej z Puttygen.
    git_clone_2
  5. Po rozpoczęciu klonowania pokaże się okno postęp importu.
    git_clone_3

    Następnie…
    git_clone_4

  6. Folder z zaimportowanym projektem na dysk lokalny.
    git_clone_5

Najwięcej problemów sprawia prawidłowe wygenerowanie i konfiguracja klucza prywatnego oraz publicznego wraz z określeniem prawidłowych branch’y local/remote przy klonowaniu repo.

 

Dodatkowe informacje

  • Tutaj znajdziesz tutek jak zmienić nazwę brancha master oraz wykonać pierwszy commit.
  • Dokumentacja Git – http://git-scm.com/.
  • Nie widzisz ikon TortoiseGit ze statusami dla plików/folderów swojego repo w exploratorze Windows?
    Aby zrobić refresh wyglądu ikon:
    Wyjdź z i wejdź do folderu nadrzędnego, lub uruchom ponownie explorer.exe, lub ponownie uruchom Windows.
    Jeżeli na Windows 7 nadal nie widać ikon, należy pogrzebać w rejestrze z pomocą wujka G.:
    https://www.google.pl/search?q=tortoisegit+icon+overlays+not+showing
  • Chciałbyś logować się do Bitbucket przy pomocy Facebook lub G+?
    Wchodzisz w edycję swojego profilu na Bitbucket.
    Prawy górny róg ekranu -> Manage account -> Connected accounts.
  • Chcesz usunąć informacje o repozytorium z wybranego folderu?
    Wystarczy usunąć katalog .git w folderze wybranego repozytorium/projektu. Wówczas dany folder przestaje podlegać wersjonowaniu.

Podobne tematy

Autor wpisu: Arkadiusz Krakiewicz

Programista i właściciel sklepu jednocześnie, dzięki temu rozumie potrzeby osób prowadzących sprzedaż w internecie. Od 2006 związany z eCommerce. Zaczynał jako freelancer tworząc sklepy oraz strony www. Aktualnie zajmuje się: programowanie w PHP, Symfony 2, Android, PrestaShop, osCommerce, OpenCart, WordPress.

2 komentarzy + Dodaj komentarz

  • Przy instalacji GIT
    Jeśli chodzi o punkt 5:
    To mam oba te opcje, i widzę TortoriseGIT w menu kontekstowym Windowsa, a te opcje są bardzo przydatne
    Jeśli chodzi o punkt 7:
    Ja zaznaczyłem ‘Use OpenSSH’ i mi działa

  • Instalacja GIT, pkt.2 [URL update] https://msysgit.github.com/

Dodaj komentarz

Anti-Spam

O mnie

Arkadiusz Krakiewicz
Programista aplikacji webowych dla branży eCommerce. Jednocześnie jako właściciel sklepu zna od "podszewki" potrzeby osób prowadzących sprzedaż w internecie.
W swoich rozwiązaniach stawia na funkcjonalność i wydajność aplikacji pod kątem obsługi klienta.
[X]
Strona korzysta z plików cookies w celu realizacji usług i zgodnie z Polityką Plików cookies.
Możesz określić warunki przechowywania lub dostępu do plików cookies w Twojej przeglądarce.
Więcej w Programowanie, Tips & Tricks
Wordpress logo
WordPress – Zmiana pozycji podpisów zdjęć (captions)

Chciałbyś zmienić miejsce podpisu zdjęć na swoim blogu? Nic prostszego... :) Dodajesz swój filtr nadpisujący wbudowaną funkcję WordPressa img_caption_shortcode(). Zobacz...

Zamknij