Git: gałęzie (branch), także zdalne

Jednym z powodów, dla których zainstersowałem się Gitem jest możliwość synchronizacji repozytoriów pomiędzy komputermi. Drugim jest wygodna praca z rozgałęzieniami kodu (branch).
Oczywiście nic nie poszło tak szybko jak się spodziewałem, dlatego postanowiłem to opisać, żebym nie musiał tego odkrywać na nowo.

Cel ćwiczenia jest zatem następujący: W moim super-projekcie hello (patrz poprzedni wpis) na jednym komputerze utworzę gałąź kodu o nazwie my-hello gdzie utworzę moduł my_hello.{c|h}.
Gałęzie w ogóle są sensowną praktyką: Pracujesz nad jakąś funkcjonalnością - utwórz sobie gałąź. A jak uznasz, że jest ok, utwórz Pull-request, żeby inni mogli przejrzeć Twoje zmiany i je ewentualnie zatwierdzić.
Ale zanim zrobię pull-request, postaram się przesiąść na inny komputer, czyli będę musiał wypchnąc gałąź my-hello, a potem ją zsynchronizować na drugim komputerze.

Zaczynam od maszyny, gdzie klonuję mój projekt, co założy mi lokalne repozytorium w katalogu hello:

$ git clone https://github.com/stecenator/hello.git
Cloning into 'hello'...
remote: Counting objects: 5, done.
remote: Compressing objects: 100% (4/4), done.
remote: Total 5 (delta 0), reused 5 (delta 0), pack-reused 0
Unpacking objects: 100% (5/5), done.
$ cd hello/
$ ls -la
razem 32
drwxrwxr-x.  3 marcinek marcinek 4096 08-24 14:38 .
drwxrwxr-x. 13 marcinek marcinek 4096 08-24 14:38 ..
drwxrwxr-x.  8 marcinek marcinek 4096 08-24 14:38 .git
-rwxrwxr-x.  1 marcinek marcinek 8264 08-24 14:38 hello
-rw-rw-r--.  1 marcinek marcinek   73 08-24 14:38 hello.c
-rw-rw-r--.  1 marcinek marcinek    8 08-24 14:38 README.md
$ git status
On branch master
Your branch is up-to-date with 'origin/master'.

nothing to commit, working tree clean

Tworzę gałąź my-hello i modyfikuję kod:

$ git checkout -b my-hello
Switched to a new branch 'my-hello'
$ git status
On branch my-hello
nothing to commit, working tree clean
$ vim my_hello.h
$ vim my_hello.c
$ vim hello.c

$ git status
On branch my-hello
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

    modified:   hello
    modified:   hello.c

Untracked files:
  (use "git add <file>..." to include in what will be committed)

    my_hello.c
    my_hello.h

no changes added to commit (use "git add" and/or "git commit -a")
$ git add *.c *.h
$ git status
On branch my-hello
Changes to be committed:
  (use "git reset HEAD <file>..." to unstage)

    modified:   hello.c
    new file:   my_hello.c
    new file:   my_hello.h

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

    modified:   hello

Na koniec pracy nad modułem commit i wypycham gałąź do githuba:

$ git commit -m "Dodanie modułu my_hello"
[my-hello 6b05f85] Dodanie modułu my_hello
 3 files changed, 12 insertions(+), 2 deletions(-)
 create mode 100644 my_hello.c
 create mode 100644 my_hello.h
 
$ git push -u origin my-hello
Username for 'https://github.com': stecenator
Password for 'https://stecenator@github.com':
Total 0 (delta 0), reused 0 (delta 0)
To https://github.com/stecenator/hello.git
 * [new branch]      my-hello -> my-hello
Branch my-hello set up to track remote branch my-hello from origin.

A teraz idę do domu, odpalam drugą kompućkę i chcę znowu popracować nad tą gałęzią kodu. W tym celu muszę sobie przypomineć jakież to mam zdalne gałęzie na githubie:

Ponieważ na tej maszyne mam już repozytorium projektu hello, muszę tylko stanąć w katalogu tegoż i odświeżyć listę gałęzi kodu z githuba:

$ git fetch origin
remote: Counting objects: 5, done.
remote: Compressing objects: 100% (4/4), done.
remote: Total 5 (delta 0), reused 5 (delta 0), pack-reused 0
Unpacking objects: 100% (5/5), done.
From https://github.com/stecenator/hello
 * [new branch]      my-hello   -> origin/my-hello
$ git status
On branch master
Your branch is up to date with 'origin/master'.

nothing to commit, working tree clean

Gałąź jest już widoczna, ale git status pokazuje, że nadal pracuję na master. Ze zdalnymi gałęziami nie da się pracować. Ale można na ich podstawie utworzyć gałąź lokalną. Nawet o innej nazwie, ale to trochę szalony pomysł, więc będę się trzymał tej samej nazwy co na serwerze:

$ git checkout -b my-hello origin/my-hello
Branch 'my-hello' set up to track remote branch 'my-hello' from 'origin'.
Switched to a new branch 'my-hello'
$ ls
hello.c  my_hello.c  my_hello.h  README.md

Jak widać, w katalogu pojawiły się pliki z gałęzi my-hello utworzonej na kompie w pracy a następnie wypchniętej do Githuba.

Warto zapamiętać, że teraz mam  tak na prawdę 5 gałęzi my-hello: dwie lokalne na komputerach, dwa lokalnie zapamiętane obrazy, read-only origin/my-hello i w końcu główną origin/my-hello na Githubie.

Podsumowując, praca z gałęzią my-hello będzie wyglądać tak:

• git fetch  - żeby zakutalizować repozytorium i lokalną kopię origin/my-hello.
• git pull lub git checkout -b my-hello origin/my-hello  - utworzenie lokalnej gałęzi my-hello. git pull robimy, jeśli siedzimy już na gałęzi które jest Set to track remote branch, co się dzieje automatycznie jeśli choć raz zrobimy got checkout ze zdalnej :-D
• chrum-chrum - czyli praca na kodzie z tej gałęzi.
• git add - Wrzuca pliki do poczekalni commitu.
• git commit - zapisuje zmiany w lokalnej gałęzi my-hello.
• git push - aktualizuje lokalną i zdalną kopię origin/my-hello