Muokataan sivua Subversion

Subversion on kehittynyt [[versionhallintajärjestelmä]]. Monet projektit ovat viime aikoina siirtyneet [[CVS]]:stä Subversioniin. Lyhennetään yleensä SVN.

== Asiakasohjelma ==
Subversion-asiakasohjelma tulee yleensä [[Jakelu|jakelupaketin]] [[Paketinhallintajärjestelmä|paketinhallinnasta]] subversion-nimisessä paketissa. Tämän jälkeen subversionia käytetään komennolla <tt>svn</tt>.

*Projektista voidaan ottaa työkopio komennolla <tt>svn checkout osoite projekti</tt>, esimerkiksi
 svn checkout svn://palvelin.example/vapaaprojekti/trunk munprojekti
Hakisi palvelin.example-palvelimen svn-varastosta projektin vapaaprojekti päähaaran, sijoittaen sen paikalliseen munprojekti-hakemistoon.
*Työhakemistossa voi projektiin lisätä tiedostoja komennolla <tt>svn add</tt>, esimerkiksi
 svn add uusfilu.cpp
Vastaavasti <tt>svn rm tiedosto</tt>
*Tiedostoja voidaan muokata tämän jälkeen työhakemistosta millä tahansa tekstieditorilla.
*Muokkausten jälkeen muutokset päivitetään komennolla svn ci, esimerkiksi
 svn ci -m "kommentti"
Jonka jälkeen näet tiedostot, joihin tehdään muutoksia. Tämän jälkeen svn kysyy, suoritetaanko svn-varaston päivitys.

Jos jossain vaiheessa tarvitaan käyttäjätunnusta ja salasanaa (etenkin muutoksia tehtäessä kirjautumista vaaditaan lähes aina), svn kysyy tarvittavat tiedot.

== Palvelin ==
Samassa subversion-paketissa tulee yleensä myös subversion-palvelinohjelma. Subversion-palvelimen käyttöönotto on yksinkertaista.

*Aluksi luodaan koneelle svn-varasto. Esimerkiksi luomme svn-varaston polkuun /var/svn nimellä varasto:
 # mkdir /var/svn
 # cd /var/svn
 # svnadmin create --fs-type bdb varasto
Joka luo bdb-tyyppisen varaston nimelle varasto, ja /var/svn-hakemistoon ilmestyy hakemisto varasto.
*Luotuun varastoon voidaan myös hakea valmiiksi vähän pohjaa seuraavalla tavalla
 svn import /var/svn/kivasvnpohja file:///var/svn/varasto/projektinnimi            
*Seuraavaksi tehdään varastoon tarvittavat asetukset. Avaa tiedosto /var/svn/varasto/conf/svnserve.conf. Tiedostossa pitäisi olla useita kommentoituja rivejä joilla on ohjeita asetusten tekemistä varten. Tiedostosta pitäisi tehdä kutakuinkin tällainen (valmiit kommentit napsastu pois):
 [general]
 #Anonyymit saavat lukea (laita read:n tilalle none jos et halua antaa lukuoikeutta)
 anon-access = read
 #Kirjautuneille lukuoikeus
 auth-access = write
 #käyttäjätunnustiedosto
 password-db = passwd
 realm = Varastosi nimi

*Käyttäjätunnukset määriteltiin edellä tiedostoon passwd. Luo siis tiedosto /var/svn/conf/passwd ja lisää sinne rivejä muodossa:
 [users]
 kayttaja1 = salasana
 kayttaja2 = salasana2
Kun käyttäjän toimet vaativat kirjautumista, kirjautumistiedot tarkistetaan tästä tiedostosta.

*Nyt kun asetukset on tehty, voidaan käynnistää itse svn-palvelin komennolla
 svnserve -d -r /var/svn/varasto
-d tarkoittaa, että ajetaan palvelinta taustalla (nk. daemoni). -r-parametri kertoo, missä svn-varasto sijaitsee.

=== WebSVN ===
WebSVN on ohjelma, jolla svn-varastoa voi selata suoraan selaimella. Selailun lisäksi onnistuu mm. eri versioiden vertailu keskenään.

Monissa jakeluissa WebSVN löytyy suoraan paketinhallinnasta. Esimerkiksi Debianissa komento <tt>apt-get install websvn</tt> asentaa WebSVN:n paikoilleen /var/www-hakemistoon (tai vastaavaan). Asetustiedosto sijaitsee tämän jälkeen yleensä joko polussa /etc/websvn/config.inc, tai polussa websvn:n hakemisto/include/config.inc. Ainakin Debianin paketinhallinnasta asennettu versio käyttää oletuksena svn-varastoon polkua /var/svn. Varaston polun voi asettaa rivillä:
 $config->parentPath("/var/svn/");


WebSVN:llä tulee olla lukuoikeudet svn-varastoon, ja lisäksi kirjoitusoikeudet varaston db-hakemistoon.

== Linkkejä ==

* [http://subversion.tigris.org Subversionin kotisivu]
*[http://subclipse.tigris.org/files/documents/906/8847/file_8847.dat?filename=subclipse%20%2d%20install%2c%20use%20and%20compile%2epdf Subversionin dokumentaatio (PDF)]
* [http://svnbook.red-bean.com/ Version Control with Subversion (kirja)]
* [http://www.onlamp.com/pub/a/onlamp/2005/01/06/svn_homedir.html Keeping Your Life in Subversion]


[[Luokka:Ohjelmistokehitys]]
[[Luokka:Palvelimet]]
[[Luokka:Kehitystyökalut]]
[[Luokka:Ohjeet]]