Repozytorium służy do przechowywania plików - e-Swoi

Repozytorium służy do przechowywania plików powstających przy pracy nad projektami
we w miarę usystematyzowany sposób. Sam mechanizm repozytorium jest zbliżony do działania
systemu plików, czyli składa się z podkatalogów a w nich z plików będących częściami projektu.
Oprócz przechowywania plików, repozytorium służy także do ich wersjonowania. Co to oznacza?
Że zapisując po raz kolejny ten sam plik w danym podkatalogu, nie powodujemy nadpisania starego
pliku zawartością nowego, lecz nowy staje się najnowszą jego wersją a stara wersja wraz ze swoją
zawartością staje się wersją poprzednią do której zawsze możemy sięgnąć. Jest to bardzo przydatna
cecha, gdy coś co poprawialiśmy okazało się kompletnie błędną koncepcją i chcemy cofnąć się do
wersji, kiedy jeszcze mieliśmy w miarę poprawną implementację bądź wersję pliku. Dla tego
właśnie zapis do repozytorium powinien dotyczyć plików znajdujących się na jakimś bardziej
znaczącym etapie (powszechnie w projektach IT nazywa się je kamieniami milowymi).
Użytkownik sam właściwie określa co jest kamieniem milowym, mogą być duże etapy projektów,
które wdrażają nową funkcję w projekcie, między nimi zaś mniejsze kamienie milowe np.:
„implementacja biblioteki do sortowania tablicy z danymi użytkownika”, na które mogą składać się
jeszcze mniejsze jednostki, na przykład dla wymienione wyżej sortowania, kamieniem milowym
może być: „implementacja metody sortowania bez używania rekurencji”.
Tak więc, określenie co jest ważne i wartościowe na tyle, że opłaca się tworzyć nowy
kamień milowy a więc i nową wersję pliku jest dosyć rozmyte i zależne od użytkownika. Jeżeli
jestem grafikiem i wrzucam kolejną wersję pliku jpg to oczywiście nie tworzę kolejnych wersji
pliku po zmianie pojedynczych pikseli, tylko po znaczących zmianach, których powtórzenie byłoby
dla mnie trudne i czasochłonne.
Zacznijmy więc pracę z repozytorium.
Pierwsza konieczna rzecz do rozpoczęcia pracy z repozytorium, to zalogowanie się w serwisie:
Po pomyślnym zalogowaniu się, przechodzimy do zakładki znajdującej się w górnej części serwisu
- zatytułowanej „Repo”, klikamy w jej tytuł przechodząc jednocześnie do części serwisu
odpowiedzialnej za repozytorium:
Widok na razie jest pusty, nie odświeżyliśmy widoku repozytorium oraz nie stworzyliśmy jeszcze
żadnego. Aby zobaczyć co mamy na liście naszych repozytoriów, klikamy w przycisk znajdujący
się poniżej ramki zatytułowany „Pokaż repozytoria”. Widzimy na razie pustą listę swoich
repozytoriów:
Teraz możemy stworzyć swoje pierwsze repozytorium. W tym celu wybieramy przycisk „Dodaj
nowe repozytorium”. Otwiera się okienko z formularzem parametrów nowego repozytorium:
W polu „Nazwa repozytorium” wpisujemy jak nasze repozytorium ma się nazywać. Nazwa
repozytorium nie może być krótsza niż 5 znaków, nie powinno zawierać polskich liter, spacji
znaków specjalnych typu „@!#$%^&*(){}[]'”;,?/”. Pole komentarz służy do głębszego opisu
repozytorium ale nie jest wymagane. Klikamy „OK”. Stworzyliśmy właśnie swoje pierwsze
repozytorium:
Jakie są zasady tworzenia repozytoriów i przechowywania w nich własnych projektów. Otóż nie ma
jednej narzuconej z góry metody w jaki sposób przechowywać projekty w repozytoriach.
Generalnie każdy projekt ma swoje specyficzne wymagania i strukturę katalogów plików i
właściwie pod ten konkretny projekt tworzy się pewien standard. Można na przykład przyjąć, że
każdy nowy projekt znajduje się w osobnym repozytorium a wszystko co związane z pojedynczym
projektem znajduje się w podkatalogach danego repozytorium. Można stworzyć jedno repozytorium
a każdy z projektów to jeden podkatalog w ramach tego jednego repozytorium. Wszystko to zależy
od przyjętej konwencji, od złożoności projektów (ilości plików i katalogów które wchodzą w skład
projektu) w końcu jeżeli projekt, który był mało skomplikowany po jakimś czasie ewoluuje w
kierunku bardziej złożonego i jego repozytorium już nie przystaje do tak skomplikowanej struktury,
zmienia się strukturę jego repozytorium. Jest to więc, rzecz dosyć luźna. Na potrzeby serwisu, jako
że tworzone projekty nie będą aż tak złożone, możemy przyjąć zaś, że tworzymy jedno
repozytorium a w nim podkatalogi, które przechowują projekty.
Stwórzmy zatem pierwszy katalog projektu w nowo utworzonym repozytorium „moje_kody”.
Klikamy prawym przyciskiem myszy na pozycję wyświetlającą nowo stworzone repozytorium i
menu kontekstowym wybieramy pozycję „Dodaj podkatalog”.
Stworzona jest nowa pozycja w naszym drzewie w którą wpisujemy nazwę katalogu. Enter
potwierdza wpisaną nazwę.
Wybierając w menu kontekstowym tworzenie kolejnych podkatalogów, odtwarzamy strukturę
drzewa naszego projektu. Przy wybieraniu z drzewa katalogów, poniżej przycisków dodawania
repozytorium i pokazywania repozytoriów, zauważyć można żółte pole. Pokazuje się ono tylko w
przypadku wybrania pozycji w drzewie, która jest katalogiem. Służy ono do dodawania plików do
repozytorium:
Aby dodać plik do repozytorium należy wybrać katalog, do którego chcemy dodać plik i kliknąć w
żółte pole. Otworzy się standardowe okno wyboru pliku. Wybieramy plik z dysku lokalnego, który
chcemy umieścić w repozytorium. Po załadowaniu pliku plik pokaże się w drzewie w kontekście
podkatalogu, który wybraliśmy podczas klikania w żółte pole. Poniżej widok przykładowego
repozytorium z podkatalogiem – projektem „SRU Autoinstall” i czterema podkatalogami: „bin”,
„etc”, „mount” i „docs” oraz załadowanymi do nich plikami:
Przy każdym z plików widoczny jest numer w nawiasach okrągłych. Numer ten to numer wersji
danego pliku. Jak widać na powyższej ilustracji, większość plików ma tę wartość równą 1. Oznacza
to, że jest tylko jedna pierwsza rewizja (wersja) tego pliku w repozytorium. Plik docs/README ma
dla tego parametru wartość 2. Co oznacza, że są dwie wersje tego pliku w repozytorium.
Mamy więc stworzone w miarę kompletne repozytorium. Jak pracujemy z repozytoriami? Samo
repozytorium służy do przechowywania własnych prac i prac zespołu, który pracuje nad różnymi
częściami projektu. Projekt zazwyczaj znajduje się na dysku twardym, komputera na którym
pracujemy, zmieniamy pliki projektu, testujemy projekt. Jest to tak zwana kopia lokalna projektu.
W momencie kiedy uznamy, że jakąś część projektu nad którą pracowaliśmy, warto zamieścić w
repozytorium, wrzucamy zmienione pliki ze swojej kopii lokalnej do odpowiednich podkatalogów
w projekcie na repozytorium. Tworząc jednocześnie jak to określiliśmy wcześniej kolejne wersje
tych plików. Repozytorium umożliwia pracę grupową użytkowników, jeden z użytkowników może
pracować nad graficzną częścią projektu, podczas gdy inny zajmuje się pisaniem kodu jakiegoś
innego fragmentu projektu. Przy czym każdy z nich może pobrać cały projekt wraz ze zmianami
załączonymi przez innych użytkowników.
Załóżmy, że jestem nowym użytkownikiem i chciałbym pobrać całe drzewo projektu, który już
istnieje. Chcę aby pobrana kopia stała się moją kopią lokalną nad którą będę pracować na własnym
komputerze. Klikam więc na katalogu z repozytorium prawym przyciskiem myszki i wybieram
pozycję „informacja”. Otwiera się okno dialogowe, w którym oprócz informacji o klikniętym
katalogu, mam także link do archiwum przechowującym cały projekt ze wszystkimi plikami i
podkatalogami, link ten jest zatytułowany „Link do katalogu”. Klikając w ten link pobieram
standardowe archiwum tar spakowane przez bzip2. Mogę je rozpakować w dowolne miejsce na
swoim komputerze. Wewnątrz znajdują się wszystkie pliki projektu, mogę dodawać własne i
zmieniać istniejące. Przy czym należy zwrócić uwagę, że jeżeli jakiś podkatalog nie istnieje w
repozytorium a jest w mojej kopii lokalnej. Muszę ten podkatalog w odpowiednim miejscu
repozytorium stworzyć tak aby odwzorować strukturę drzewa swojej kopii lokalnej w drzewie
repozytorium. Poniżej zrzut ekranu dla okna z informacją o katalogu:
W skrócie jak wyglądają poszczególne kroki w pracy z repozytorium od jego stworzenia.
1. Na swoim komputerze w wybranym miejscu, tworzę drzewo projektu czyli podkatalog z
nazwą projektu wewnątrz którego znajdują się wszystkie pliki i podkatalogi będące częścią
projektu. To jest moja kopia lokalna projektu.
2. Tworzę repozytorium w serwisie a w nim podkatalog o nazwie takiej samej jak katalog
mojej kopii lokalnej. Odtwarzam całe drzewo podkatalogów w repozytorium w serwisie
aby wyglądało jak drzewo mojej kopii lokalnej.
3. Z mojej kopii lokalnej dla każdego katalogu i podkatalogu wrzucam wszystkie pliki z kopii
lokalnej, które powinny znaleźć się w odpowiednich katalogach do repozytorium.
4. Pracuję nad plikami, wprowadzam zmiany w swojej kopii lokalnej. Jeżeli uznaję, że pewien
etap zmian jest już gotowy do opublikowania w repozytorium, wrzucam zmienione pliki w
odpowiednie podkatalogi na repozytorium w serwisie.
1. Jeżeli dołączam do istniejącego projektu, wtedy wchodzę na interesujące mnie
repozytorium, klikam w jego katalog prawym przyciskiem myszki i pobieram archiwum ze
wszystkimi jego plikami.
2. Archiwum rozpakowuję u siebie na dysku do wybranego katalogu. Staje się on moją kopią
lokalną.
3. Dalsza praca wygląda jak w punkcie 4 poprzedniej listy.
Uwaga!
Usunięcie pliku lub katalogu z repozytorium jest bezpowrotne, nie da się odzyskać usuwanego
pliku jeżeli nie masz zrobionej kopii lokalnej. Dla tego trzeba rozważnie posługiwać się usuwaniem
plików i katalogów oraz co jakiś czas pobierać archiwum z kopią projektu aby w razie
przypadkowego usunięcia móc odtworzyć usuwany plik z kopii.