Musiałem utworzyć do firmy mały poradnik, jak korzystać z branchy i tagów w Subversion, a że pisałem to w miarę (jak mi się zdaje) łopatologicznie, to stwierdziłem że umieszczę to i tutaj dla szerszego grona :)
Nie jest to pozycja dla osoby nie mającej dotychczas styczności z Subversion, nie jest więc wytłumaczone co to jest commit i w ogóle Subversion czy też system kontroli wersji, są za to informacje jak ja i kilka osób na świecie widzą korzystanie z tak ważnych rzeczy jakimi są branche i tagi :)
Generalnie, podstawową strukturą katalogów jest układ:
/
|-trunk
|-branches
|-tags
W trunk przechowywana jest aktualna rozwojowa wersja systemu. Tutaj nanoszone są bieżące zmiany, poprawki etc. Branches służą do przechowywania oddzielnych gałęzi systemu, które niosą zbyt rewolucyjne zmiany, żeby umieszczać je w drzewku głównym, które musi być czasem gotowe do natychmiastowej synchronizacji z systemem głównym. W katalogu tags tworzone są aktualne snapshoty systemu produkcyjnego – każda wersja, która idzie na system produkcyjny, powinna najpierw zostać przeniesiona (zamrożona) do konkretnego taga, i dopiero później system powinien zostać zsynchronizowany.
Najpierw troszkę samej teorii:
Zarówno branche, jak i tagi, tworzone są poprzez skopiowanie dowolnej z gałęzi
rozwijanego systemu (może to być zarówno system trunk, jak i dowolna gałąź utworzona przez któregokolwiek użytkownika) poleceniem cp (copy):
svn cp svn://repo/trunk svn://repo/branches/moja_galaz
Powyższe polecenie tworzy nową gałąź o nazwie moja_galaz którą można dowolnie sobie rozwijać, testować, modyfikować według własnych potrzeb, a następnie, gdy przyjdzie odpowiedni czas/ochota, dołączyć do aktualnego systemu.
W podobny sposób tworzy się konkretne tagi (tagi zwyczajowo oznacza się wielkimi literami):
svn cp svn://repo/trunk svn://repo/tags/HOME_20071210_1
Utworzy to aktualny snapshot repozytorium w katalogu /tags/HOME_20071210_1 (ostatnia
cyfra oznacza rewizję w ciągu tego samego dnia – oczywiście schemat nazewnictwa jest umowny).
Po utworzeniu własnej gałęzi, powinniśmy się na nią przełączyć, ponieważ domyślnie ciągle pracujemy na poprzedniej wersji repozytorium. Do przełączania się między gałęziami służy polecenie sw (switch):
svn sw svn://repo/branches/moja_galaz
W tym momencie pracujemy już na naszej gałęzi, i wszelkie commity, zmiany etc będą się odnosić do naszej wersji.
Co dalej?
Podstawowe prace i rozwijanie systemu powinno odbywać się na gałęzi trunk, która w razie puszczania zmian na system produkcyjny, powinna zostać skopiowana do odpowiedniego tagu, a następnie zsynchronizowana. Pozostaje jeszcze jeden problem: jak połączyć zmiany dokonane na osobnej gałęzi z tym, co dzieje się w aktualnym drzewku?
Tutaj pomoże nam komenda merge. Załóżmy hipotetyczną sytuację:
W repozytorium, w gałęzi trunk, znajduje się plik index.php. Ma on zawartość:
<?php
include 'some_file.php';
?>
W tej chwili tworzymy osobnego brancha:
svn cp svn://repo/trunk svn://repo/branches/mysz1
svn sw svn://repo/branches/mysz1
Od tego momentu pracujemy już na branchu mysz1. Sprawdzić to możemy za pomocą
komendy info:
svn info
[...]
URL: svn://repo/branches/mysz1
[...]
Dokonujemy zmiany w pliku index.php, tak że zawiera on teraz:
<?php
include 'some_file.php';
echo date ('Ymdhis'); // branches/mysz1
?>
Wykonujemy commit pliku, po czym przenosimy się na trunka:
svn sw svn://repo/trunk
svn info
[...]
URL: svn://repo/trunk
[...]
Sprawdzamy zawartość pliku index.php:
svn cat index.php
<?php
include 'some_file.php';
?>
Dokonujemy zmian, żeby plik wyglądał tak:
<?php
include 'some_file.php';
print strftime ('%Y%m%d %H%M%S', time ()); // trunk
?>
Commit, i wracamy na mysz1:
svn sw svn://repo/branches/mysz1
svn info
[...]
URL: svn://repo/branches/mysz1
[...]
svn cat index.php
<?php
include 'some_file.php';
echo date ('Ymdhis'); // branches/mysz1
?>
No to teraz próbujemy nanieść zmiany z branches/mysz1 na główną gałąź systemu:
svn merge -r 6:HEAD svn://repo/branches/mysz1 .
(na końcu jest kropka).
Co znaczą poszczególne części, wyjaśniam poniżej:
- svn merge
- polecenie
- -r 6:HEAD
- wersje która mają zostać połączone: najpierw numer wersji na której aktualnie pracujemy (w tym wypadku 6), później wersji do której chcemy się uaktualnić (HEAD, oznaczający najbardziej aktualną wersję, ale może to również być liczba oznaczająca konkretną rewizję)
- svn://repo/branches/mysz1
- branch który łączymy z trunkiem
- .
- (kropka) aktualna ścieżka (równie dobrze mogło to być svn://repo/trunk)
W tym wypadku powstanie nam konflikt, który rozwiązujemy tradycyjnym sposobem (kasując, dodając i poprawiając konkretne linie), a na końcu, po rozwiązaniu wszystkich problemów, robimy tradycyjny commit.
Więcej informacji znaleźć można na:
