Subversion (SVN) Mini HowTo
Introduzione
[http://subversion.tigris.org/ Subversion] (SVN) si propone di essere il successore di CVS, ovvero un tool (composto da client e server) per lo sviluppo collaborativo. Questo mini howto riguarda sia l'uso con il client (ad un di livello introduttivo) che l'installazione di un server che gestisce repository SVN. Per documentazione piu' completa (installazione, svnserve) ed approfondita rimandiamo alla documentazione ufficiale su http://svnbook.org/ .
Utilizzo di client SVN
Trac
[http://trac.edgewall.org/ Trac] permette di visualizzare il contenuto del repository SVN attraverso un'interfaccia web. Per esempio http://test.ninux.org/svntrac/browser .
trunk, branches, tags
Quando si utilizza svn e' usanza avere 3 directory:
- trunk - contiene il ramo di sviluppo principale
- branches - contiene rami di sviluppo secondari
- tags - contiene snapshot delle altre due directory in momenti significativi dello sviluppo
svn checkout
Esempio:
$svn checkout http://test.ninux.org/svn/pippo/trunk
oppure (abbreviato)
$svn co http://test.ninux.org/svn/pippo/trunk
scarica la revisione piu' aggiornata del contenuto della directory remota pippo/trunk nella directory locale corrente. Questo comando in genere va utilizzato una sola volta inizialmente. Possiamo iniziare a sviluppare modificando la copia di lavoro, ovvero i file scaricati.
svn status
$svn status
Mostra una lista di file. I flag principali:
- M: file modificato
- A: file aggiunto
- D: file cancellato
- ?: file non sotto il controllo di subversion (i comandi svn non hanno effetto su quel file)
svn update
Aggiorna la copia di lavoro dal repository
$svn update
Mentre svn checkout di solito viene utilizzato una sola volta all'inizio, svn update aggiorna alla revisione piu' recente la copia gia' scaricata con svn checkout. Durante l'update possono comparire alcuni flag:
- A - file aggiunto (Added)
- U - file aggiornato (Updated)
- G - cambiamenti fusi (merGed), quando modifiche locali ed aggiornamento dal repository sono compatibili
- C - conflitto (Conflict). Le modifiche locali non sono compatibili con quelle nel repository. Vedere piu' giu' come risolvere conflitti.
svn commit
$svn commit -m "risolto bug n. 12"
oppure
$svn ci -m "risolto bug n. 12"
Fa l'upload delle modifiche correnti. L'opzione -m e' obbligatoria ed e' buona regola scrivere un messaggio significativo con la descrizione delle nuove modifiche.
file: nuovi, copiare, rinominare, spostare
Quando si crea un nuovo file, questo non viene aggiunto automaticamente al controllo di subversion (ovvero i comandi svn non hanno effetto su quel file). Per aggiungere un file o una directory al controllo di subversion utilizzare svn add:
$svn add nuovofile.txt
Per le directory si puo' utilizzare
$svn mkdir nuovadirectory
che crea la nuova directory "nuovadirectory" e la aggiunge al controllo di subversion.
Per cancellare file non bisogna mai utilizzare i comandi del sistema operativo, ma il comando svn delete:
$svn delete file.c
Anche per copiare non bisogna utilizzare il sistema operativo, ma
$svn copy file.c ./nuovadir/file.c
Similmente per rinominare e spostare:
$svn move file.c file.cpp
svn help
$svn help copy
svn help mostra l'aiuto per un determinato subcomando di subversion (i subcomandi sono checkout, udpate, commit, etc)
risolvere conflitti: svn resolved
Durante l'update puo' capitare che vicino al nome di un file compaia il flag "C". In questi casi nella directory di lavoro possiamo trovare 4 file, per esempio:
- file.c.mine: file.c come era prima di fare l'update
- file.c.r75: file.c revisione 75 (quella "nuova" sul repository)
- file.c.r73: file.c revisione 73 (quella "vecchia" sulla quale si sono apportate modifiche)
file.c: file.c con dei marker <<<<<<<<<<<<, --------- e >>>>>>>>>>>>> che indicano le parti dove ci sono righe in conflitto
Per risolvere il conflitto potremmo:
- sovrascrivere file.c con la nostra versione
- sovrascrivere file.c con la revisione 75
- modificare file.c fondendo le modifiche
Finito di risolvere il conflitto diamo il comando
$svn resolved file.c
che elimina i file file.mine, file.r75 e file.r73 e marca il conflitto di file.c come "resolved".
Quando avviene un conflitto, comunque, e' buona regola contattare gli altri sviluppatori.
esempio di ciclo di lavoro
da fare
svn log
$svn log --limit 10
Mostra gli ultimi 10 messaggi di log (messaggi inseriti con l'opzione -m di svn commit).
svn diff
svn diff ciao.c
Mostra le modifiche del file ciao.c rispetto alla versione scaricata dal repository. Le righe aggiunte sono precedute da un "+", mentre le righe eliminate sono precedute da un "-". Permette anche di vedere le differenze tra varie revisioni.
svn revert
$svn revert ciao.c
usato prima del commit elimina tutte le modifiche locali facendo tornare il file all'ultima revisione scaricata (con svn update o svn checkout) dal repository.
Server Gentoo per repository SVN
prima di tutto installaliamo SVN
emerge subversion
Aggiungere un repository:
<verbatim> svnadmin create /var/svn/nuovorepos
vi /etc/apache2/modules.d/47_mod_dav_svn.conf </verbatim> ed aggiungere un nuovo blocco location usando come template i precedenti.
<verbatim> <Location /svn/repos>
- DAV svn SVNPath /var/svn/repos
AuthType Basic AuthName "Subversion repository" AuthUserFile /var/svn/conf/svnusers AuthzSVNAccessFile /var/svn/conf/svnpolicy Require valid-user SSLRequireSSL
</Location> </verbatim>
Specificare un file per gli utenti e un altro file (opzionale) per le autorizzazioni.
Tipicamente li dovete fare in <verbatim>/var/svn/nuovorepos/conf/</verbatim> chiamandoli
- svnusers
- svnpolicy
Creare il file nuovo <verbatim>svnuser</verbatim> col comando (leggete dopo prima di copiare incollare il comando) <verbatim> htpasswd2 -c /var/svn/newrepos/conf/svnusers newuser </verbatim> Se il file già esiste invece dovete fare *Altrimenti cancellerà tutto il file* <verbatim> htpasswd2 /var/svn/newrepos/conf/svnusers newuser </verbatim>
Con questi file l'utente si autentica, pero' vorrete dare diverse autorizzazioni agli utenti.
allora dovrete modificare il file svnpolicy come segue:
<verbatim> [test:/trunk] saverio = rw lorenzo = * = r </verbatim>
Con questo file diamo la possibilità all'utente Saverio di lettura e scrittura, e all'utente lorenzo, di sola lettura.
Se volete che chiunque sia autenticato sia anche autorizzato a fare tutto, basta commentare la linea presente nel file /etc/apache2/modules.d/47_mod_dav_svn.conf cambiandola da:
<verbatim>
- AuthzSVNAccessFile /var/svn/conf/svnpolicy
</verbatim>
in
<verbatim> # AuthzSVNAccessFile /var/svn/conf/svnpolicy </verbatim>
---++++ Trac
Trac è un tool web based per gestire codice di un progetto che usa SVN Per aggiungere un progetto a trac (o meglio per creare un ambiente trac per un progetto):
<verbatim> trac-admin /var/lib/trac/project1/ initenv </verbatim>
questo comando crea le pagine iniziali che vediamo dal browser quando entriamo in un nuovo ambiente trac
possiamo subito testare l'ambiente con il web-server intregrato dentro trac.. ma.. noi vogliamo usare apache che è molto meglio 
Sistemiamo i permessi:
<verbatim> chown -Rv apache /var/lib/trac/project1/ </verbatim>
A questo punto dobbiamo fare in modo che il nostro webserver apache sappia come andare a pescare le cartelle dove abbiamo inizializzato in nostro ambiente trac.
creare un file con estensione <verbatim>.conf</verbatim> in <verbatim> /etc/apache2/vhosts.d </verbatim> questo file verrà appeso alla configurazione di apache, in questo modo non roviniamo l'http.conf e manteniamo la configurazione di apache più ordinata
Qui c'è un esempio di file, che possiamo chiamare <verbatim>trac.conf</verbatim>. Il blocco Location dice ad apache che la URI /project1 corrisponde su disco alla cartella /var/lib/trac/project1 che è un trac environment Il blocco scripts alias serve ad identificare il trac.cgi Il blocco LocationMatch serve per abilitare l'autenticazione con login e password in trac <verbatim> <Location /project1>
SetEnv TRAC_ENV "/var/lib/trac/project1"
</Location>
ScriptAlias /tfc /usr/share/webapps/trac/0.10.1/hostroot/cgi-bin/trac.cgi
#<LocationMatch "/[^/]+/login"> <LocationMatch "/project1login">
AuthType Basic
AuthName "Trac" AuthUserFile /var/svn/conf/svnusers Require valid-user
</LocationMatch> </verbatim>
Riavviare apache2 con <verbatim>/etc/init.d/apache2 restart</verbatim>
Per customizzare ancora l'interfaccia trac ed attivare la gestione utenti del progetto dal web andiamo a modificare il file:
<verbatim> /var/lib/trac/project1/conf/trac.ini </verbatim>
oltre a modificare a piacere seguendo l'intuitivo template, aggiungiamo alla fine questo blocco (si da per scontato che il plug in di trac è gia installato)
<verbatim> [components] webadmin.* = enabled </verbatim>
adesso, modificate il path della variabile URL ed eseguite questo script: <verbatim> #!/bin/bash
URL=/var/lib/trac/project1/ echo $URL
trac-admin $URL permission remove anonymous BROWSER_VIEW CHANGESET_VIEW CONFIG_VIEW FILE_VIEW LOG_VIEW MILESTONE_ADMIN MILESTONE_CREATE MILESTONE_DELETE MILESTONE_MODIFY MILESTONE_VIEW REPORT_ADMIN REPORT_CREATE REPORT_DELETE REPORT_MODIFY REPORT_SQL_VIEW REPORT_VIEW ROADMAP_ADMIN ROADMAP_VIEW SEARCH_VIEW TICKET_ADMIN TICKET_APPEND TICKET_CHGPROP TICKET_CREATE TICKET_MODIFY TICKET_VIEW TIMELINE_VIEW TRAC_ADMIN WIKI_ADMIN WIKI_CREATE WIKI_DELETE WIKI_MODIFY WIKI_VIEW
trac-admin $URL permission add authenticated BROWSER_VIEW CHANGESET_VIEW CONFIG_VIEW FILE_VIEW LOG_VIEW MILESTONE_ADMIN MILESTONE_CREATE MILESTONE_DELETE MILESTONE_MODIFY MILESTONE_VIEW REPORT_ADMIN REPORT_CREATE REPORT_DELETE REPORT_MODIFY REPORT_SQL_VIEW REPORT_VIEW ROADMAP_ADMIN ROADMAP_VIEW SEARCH_VIEW TICKET_ADMIN TICKET_APPEND TICKET_CHGPROP TICKET_CREATE TICKET_MODIFY TICKET_VIEW TIMELINE_VIEW TRAC_ADMIN WIKI_ADMIN WIKI_CREATE WIKI_DELETE WIKI_MODIFY WIKI_VIEW
trac-admin $URL permission add anonymous WIKI_VIEW </verbatim>
fatto questo diamo un aggiustatina ai permessi, cosi trac può operare sui files del repository:
<verbatim> cd /var/svn chgrp -Rv apache project1/ chmod -Rv 775 project1/ </verbatim> ora possiamo editare quasi tutte le opzioni di trac dal web, ovviamente solo se siamo loggati!
se qualcosa non funziona subito riavviate apache!