Ovaj vodič može da vam posluži kao podsjetnik koje korake treba da napravite pri kreiranju repository-a. Pretpostavka je da su SubVersion i TortoiseSVN ispravno instalirani na sistemu, kako je to opisano u vodiču za instalaciju SubVersion-a.

Kreiranje repository-a

U folderu koji ste definisali prilikom instalacije SubVersion-a (u vodiču za instalaciju, to je D:\SubVersion) dodajte podfolder koji ima isto ime kao i projekat / solution koji u njemu želite držati. U ovom primjeru, koristićemo ime Project1. Znači, trebali bi ste imati folder D:\SubVersion\Project1.

Sada kliknite desnim tasterom miša na taj folder i izaberite TortoiseSVN -> Create repository here.... Dobićete prozor sa dvije opcije: Native file system i Berkeley database.

Uvijek birajte opciju "Native file system". "Berkeley database" je korišten u ranim verzijama SubVersiona i zadržan je samo radi kompatibilnosti. Nakon klika na OK, vaš repository je kreiran. Unutar foldera, SubVersion je dodao svoje podfoldere i fajlove.

Korisnička autorizacija

Nakon što smo kreirali repository, potrebno je kreirati korisnike i podesiti prava pristupa. Unutar D:\SubVersion\Project1 foldera naći ćete conf podfolder. Sve izmjene se vrše na fajlovima unutar "conf" foldera.

Otvorite fajl svnserve.conf u Notepadu. Prvo ćemo definisati način pristupa. Pronađite liniju "# anon-access = read" i skinite komentar sa nje (obrišite "# "). Sada ste dozvolili anonimni pristup svom repository-u, tj. čak i korisnici koji nisu logovani mogu da pogledaju kod u vašem repository-u. Možete čak i da dozvolite anonimnim korisnicima da mijenjaju vaš kod (tako što umjesto "read" stavite "write"), ali to nije preporučljivo. Uglavnom će te željeti da onemogućite bilo kakav pristup anonimnim korisnicima, a to se postiže sa "none" umjesto "read". Takođe možete i da konfigurišete pristup koji će imati logovani korisnik. To postižete sa linijom "# auth-access = write". Pošto je "write" podrazumjevana vrijednost, ovu liniju ne morate mijenjati.

Da biste uspješno dodali korisnike, obavezno skinite komentar i sa linije "# password-db = passwd". Sada sačuvajte svoje izmjene i zatvorite Notepad.

passwd je ime fajla koji sadrži imena i lozinke korisnika. On se nalazi u istom folderu kao i svnserve.conf. Otvorite ga u Notepadu. Vidjećete slijedeći dio:

Ovdje upisujete korisničko ime i lozinku (npr. miroslav = lozinka). harry i sally su samo primjeri i možete ih obrisati. Ako kreirate repository za tim programera, svakog programera unesite u posebnu liniju.

Kreiranje trunk foldera

Prema konvenciji, kod se ne smješta direktno u root folder repository-ja, nego u folder pod imenom trunk. Prije nego što dodate svoj projekat u repository, kreirajte ovaj folder.

Najlakše ćete to uraditi pomoću TortoiseSVN -> Repo-browser. Kao URL unosite svn://localhost/Project1. "svn://" je SubVersion protokol. "localhost" upisujete ako pristupate svom računaru, a ako pristupate drugom računaru preko lokalne mreže ili Interneta, upisujete ime tog računara ili njegovu IP adresu umjesto "localhost". Poslednji dio URL-a je ime koje ste dali svom repository-ju. U našem slučaju to je "Project1". Dobićete formu za unos korisničkog imena i lozinke koje ste definisali u "passwd" fajlu. Unesite podatke i kliknite OK.

Sada kliknite desnim tasterom miša na listu i izaberite Create folder.... Kao ime foldera unesite "trunk". Obratite pažnju na velika i mala slova (izbjegavajte ime Trunk ili TRUNK).

Nakon ovog koraka vaš repository je spreman za dodavanje koda.

TortoiseSVN - dodavanje koda u repository

TortoiseSVN ima naredbu Import za ovu svrhu. Desni klik na folder koji želimo dodati u repository, pa TortoiseSVN -> Import...

Pod URL opet upisujete istu putanju, kao i u prošlom koraku, samo što sada dodajete i nastavak "/trunk". Takođe je poželjno dodati i log poruku.

VisualSVN - dodavanje koda u repository

Otvorite solution koji želite da dodate u Visual Studiu, a zatim u Solution Exploreru kliknete desnim tasterom miša na solution, pa izaberete Add Solution to Subversion....

Unutar dobijene forme birate Add to Existing Repository i pod URL unesete putanju, kao u opisu za TortoiseSVN.

Upravo ste si napravili veliku uslugu. Čuvanje source koda pomoću version control sistema kao što je SubVersion je jedna od najboljih programerskih praksi.

Par savjeta

Da bi ste se osigurali u slučaju pada sistema, često radite backup svog SubVersion foldera.

Ako imate mnogo klijenata, ili više različitih projekata koji zajedno čine jednu cjelinu, razmislite o šemi za imenovanje repository-ja. Recimo, možete da koristite tačku (.) unutar imena repository-ja da bi ste simulirali namespace-ove (npr. Klijent1.Projekat1, Klijent1.Projekat2, Klijent2.Projekat1...).

Ako radite u timu i često dodajete nove projekte, vjerovatno vam je naporno svaki put podešavati "svnserve.conf" i "passwd" i unositi ponovo sve članove tima. Umjesto toga, možete fajl "passwd" držati na jednom mjestu (najbolje u SubVersion root folderu - npr: D:\SubVersion\passwd) i koristiti ga iz svih projekata. Tada u "svnserve.conf" morate definisati relativnu putanju do "passwd" fajla - npr: "password-db = ../../passwd".