Subversion hoidla kasutamine Debianiga
Sisukord
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 teekide liides
\ /
kliendi teegid
'
v
hoidlale ligipääsumoodused
DAV SNV Local
| | |
võrk (nt internet) |
| | |
| | |
v v |
|
Apache veebiserver svnserve |
' ' |
------------------------------------------------- hoidla liides
| | |
v v v
Subversion hoidla
/ \
' '
Berkeley DB FSFS
kus on esitatud
- skeemi ülaosas on kujutatud Subversioni klientprogramme, mis standadsete teekide kaudu suhtlevad hoidlaga kasutades kolme nö ühenduskanali võimalust, 1. DAV läbi Apache veebiserver, 2. SVN üle svnserve serveri ning 3. otse failisüsteemi kaudu, eeldusel, et klienti saab kasutada hoidlaga samas arvutis
- DAV ja SVN andmevahetus toimub üle avaliku võrgu kasutades TCP protokolli
- Subversioni hoidla võib esineda oma sisemise andmesalvestusformaadi mõttes kahel kujul, Berkeley DB või 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
Väljavõttega töötamine
$ svn add katalooginimi $ svn commit -m "katalooginimi kataloogi lisamine"
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 .. Enabling module dav. Enabling module dav_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
<VirtualHost 192.168.6.130:443>
ServerName svn.loomaaed.tartu.ee
DocumentRoot /srv/svn
ErrorLog /var/log/apache2/svn.loomaaed.tartu.ee-error.log
TransferLog /var/log/apache2/svn.loomaaed.tartu.ee-access.log
SSLEngine on
SSLCipherSuite HIGH:MEDIUM
SSLCertificateFile /etc/apache2/serdid/svn.loomaaed.tartu..ee-cert.pem
SSLCertificateKeyFile /etc/apache2/serdid/svn.loomaaed.tartu..ee-key.pem
SSLCertificateChainFile /etc/apache2/serdid/loomaaed-ca-chain.pem
<Location /tarkvara/svn/projektid>
DAV svn
SVNParentPath /srv/svn/projektid
AuthzSVNAccessFile /etc/svn-dav-passwd
AuthType Basic
AuthName "Subversion repository"
AuthBasicProvider ldap
AuthzLDAPAuthoritative on
AuthLDAPURL "ldaps://ldap.loomaaed.tartu.ee/DC=loomaaed,DC=tartu,DC=ee?uid?sub?(objectClass=*)"
Require valid-user
Order Allow,Deny
Allow from All
</Location>
<Directory /srv/svn/projektid>
AllowOverRide None
Order Allow,Deny
Allow from All
</Directory>
</VirtualHost>
Kaugligipääs svnserve vahendusel
TODO
