Subversion hoidla kasutamine Debianiga

Sissejuhatus

Subversion http://subversion.tigris.org/ on versioonihalduse tarkvara (ingl. k. version control system), mida algselt asus arendama Collabnet http://www.collab.net/, tänapäeval on Subversion nn vaba tarkvara projekt. Subversion tarkvara kasutamine toimub Apache litsentsi http://en.wikipedia.org/wiki/Apache_License alusel.

Üldiselt kasutatakse versioonikontrolli tarkvara selleks, et hõlbustada mingi tekstilist tulemust tekitava ülesandega tegelevatel osalistel, nt programmeerijatel, üksteise tegevusest osa saada ja koostööd teha. Samal ajal ei ole versioonikontroll iseenesest projektijuhtimise tarkvara.

Tavaliselt kasutavad kõik osalised ühte keskset versioonihalduse serveris asuvat repositooriumit, kus asuvad kõneksolevale projektile vastavad andmed ning iga kasutaja töökohaarvutis on keskse projekti või selle osa koopia, mida nimetatakse kasutaja tööversiooniks. Kasutajad teevad muudatusi oma tööversiooni ning sünkroniseerivad andmeid keskse repositooriumiga. Sellise sünkroniseerimise käigus kopeerivad kasutajad oma tööversiooni tehtud muudatused versioonihalduse repositooriumisse ning saavad osa teiste kasutajate poolt tehtud muudatustest eeldusel, et teised kasutajad on oma muudatused eelnevalt repositooriumisse kopeerinud. Andmevahetus toimub ainult kasutaja ja repositooriumi vahel, mitte kunagi otse kahe kasutaja tööversioonide vahel.

Käesolev tekst keskendub Subversionit kasutava versioonihalduse süsteemi käivitamisel, eriti repositooriumi ettevalmistamisel ja seetõttu pakub tõenäoliselt huvi pigem süsteemiadministraatorile kui versioonihalduse süsteemi lõppkasutajale. Lõppkasutajale sobivamaks on tõenäoliselt versioonihalduse kliendi kasutamist käsitlev tekst, nt TortoiseSVN.

Subversioni arhitektuur

Subversioni ehitust kujutab kõrgel abstraktsioonitasemel selline skeem

  svn käsureaklient                  GUI SVN kliendid
               \                        /
                   \                /  
                     kliendi teegid
                           '
                           v
              hoidlale ligipääsumoodused
  
              DAV       SNV             Local
              /          |                |
            /    avalik võrk, internet    |
           '             |                |
   Apache veebiserver    |                |
           |             v                |
           |                              |
           |          svnserve            |
           |             '                |
           v             v                v
                  Subversion hoidla
                   /               \
                 '                   '
            Berkeley DB              FSFS

Subversion tarkvara paigaldamine

Debian v. 5.0 Lenny sisaldab paketihalduses Subversion versioonikontrolli tarkvara v. 1.5.1, paigaldamiseks tuleb öelda

 # apt-get install subversion

Pakett subversion sisaldab

• svn - Subversioni klient suhtlemiseks hoidlaga
• svnadmin - Subversioni administreerimise utiliit
• svnserve - Subversioni server võrgus hoidla kättesaadavaks tegemiseks

Hoidla moodustamine

Hoidla moodustamiseks tuleb öelda

 $ svnadmin create /srv/svn/fai-config
 $ svn import /srv/fai/config file:///srv/svn/fai-confg -m "Initial import"

Ligipääsu hoidlale kontrollivad kolm faili

• /srv/svn/fai-config/conf/svnserve.conf - üldine konfiguratsioon
• /srv/svn/fai-config/conf/passwd - kasutajate paroolifail
• /srv/svn/fai-config/conf/authz - kasutajate autoriseerimine

Vaikimisi saab lokaalsest arvutist kasutaja svn'i piiramatult, üle võrgu saab anonüümne kasutaja lugeda.

Väljavõtte tegemine

Lokaalsest arvutist

 $ svn checkout file:///srv/svn/fai
 $ svn export file:///srv/svn/fai

Üle võrgu, svn kasutab porti 3690/tcp

 $ svn checkout svn://192.168.10.199/fai-config

Üle võrgu, Apache veebiserveri abil vahendatud SVN repositooriumist

 $ svn co https://snv.loomaaed.tartu.ee/tarkvara/svn/projektid/test-1

Hoidlale ligipääsu korraldamine

Selleks, et hoidla ressurssidele saaks ligi ainult autenditud kasutaja tuleb kasutada nt selliseid seadistusfaile

 $ egrep -v "^#|^$" /srv/svn/fai-config/conf/svnserve.conf 
 [general]
 anon-access = none
 auth-access = write
 password-db = passwd
 authz-db = authz
 [sasl]

 $ egrep -v "^#|^$" /srv/svn/fai-config/conf/passwd
 [users]
 imre = parool

 $ egrep -v "^#|^$" /srv/svn/fai-config/conf/authz
 [aliases]
 [groups]
 [/]
 priit = rw

Kasutamiseks tuleb öelda

 $ svn checkout svn://priit@192.168.10.199/fai-config

Apache veebiserveri kasutamine kaugligipääsuks

Hoidlale kaugligipääsu korraldamine Apache veebiserveri vahendusel on eelistatud lahendus sellistel põhjustel

• https:// kasutamise võimalus turvaliseks andmevahetuseks
• hoidla kasutajate autentimise võimalus ldap kataloogi abil

Apache veebiserveri ettevalmistamine

 # apt-get install apache2 libapache2-svn

Kasutajate autentimine vastu tekstifaili

 <Location /tarkvara/svn/projektid>
   DAV svn
   SVNParentPath /srv/svn
   AuthzSVNAccessFile /etc/svn-dav-passwd
   AuthType Basic
   AuthName "Subversion repository"
   AuthUserFile /etc/svn-dav-htpasswd
   Require valid-user
   Order Allow,Deny
   Allow from All
  </Location>

Kasutajate autentimine vastu LDAP kataloogi

TODO

Kaugligipääs svnserve vahendusel

TODO

Kasulikud lisamaterjalid

• http://blogs.open.collab.net/svn/2009/03/subversion-with-apache-and-ldap-updated.html
• http://subversion.tigris.org/
• http://kuutorvaja.eenet.ee/wiki/TortoiseSVN
• http://svnbook.red-bean.com/
• http://en.wikipedia.org/wiki/Subversion_(software)