BR

BRBR

Introduzione

Subversion è un sistema alternativo a [:Cvs: CVS] che svolge la medesima funzione di controllo di versione. Questa operazione consiste nel poter consultare, scaricare, aggiornare sorgenti di programmi salvati in remoto su un server web. In Ubuntu questa tecnologia è sfruttata mediante il client testuale svn.

Installazione

L'installazione del client è un passo banale: si può ottenere, nomchè installare il pacchetto svn tramite la [:RigaDiComando:riga di comando] con [:Apt:Apt] oppure per via grafica mediante [:SynapticHowto:Synaptic] o [:AdeptHowTo:Adept].

Per installare il pacchetto con apt-get da riga di comando è sufficiente digitare:

sudo apt-get install subversion

Il server SVN

In questa sezione vengono trattati alcuni fra gli aspetti di maggior interesse per gli utenti e per gli amministratori di server.

Anchor(protocolli)

Protocolli di accesso

I server ospiti, di norma, autorizzano l'accesso alle connessioni che fanno uso di protocolli ben definiti. Quello che segue è un elenco dei protocolli più comuni:

Creare un repository SVN

La spiegazione che segue spiega come creare un repository locale sul proprio computer. In realtà può essere utilizzato anche per crearne uno in remoto, purchè si abbia accesso mediante ssh al dominio ospite.

Creazione gruppo e utenti

Prima di tutto è necessario creare un nuovo gruppo utente (nell'esempio sarà chiamato subversion) che avrà accesso alla cartella dei sorgenti, dunque si dovrà assegnargli l'utente attuale e l'utente di apache (chiamato www-data).

Aprire una finestra di terminale e digitare:

sudo addgroup subversion
sudo adduser nomeutente subversion
sudo adduser www-data subversion

Creazione cartelle

Pur non essendo una regola, è generalmente preferibile porre la cartella svn, destinata a contenere tutti i progetti ospitati, nella cartella /home.

Per creare la nuova directory, digitare da terminale il seguente comando:

sudo mkdir /home/svn

Dunque, è necessario creare la sottocartella per il primo progetto d'esempio, che avrà come nome progetto, infine impostare come proprietario il gruppo creato:

sudo mkdir /home/svn/progetto
sudo chown -R root:subversion progetto
sudo chmod -R g+rws progetto

Creazione del repository locale

Per abilitare l'hosting del progetto nel repository appena creato, è sufficiente digitare il seguente comando:

sudo svnadmin create /home/svn/progetto

Anchor(autenticazione)

Autenticazione

L'autenticazione ad un server SVN (ad esempio per modificare, aggiungere file ecc) può non essere necessaria, bensì può venire richiesta solo in caso si richieda di effettuare delle operazioni che necessitino tale procedura (sempre nel caso che il server sia configurato per supportare tale opzione).

Ad esempio, un comando generico come il seguente:

svn [comando] [opzioni]

Restituirà in caso di necessità (se, ad esempio, sono necessari permessi di scrittura)

Username:
Password for 'nomeinserito':

In questo modo, è stato resto più facile e veloce l'utilizzo.

• {{{svn [comando] [opzioni] --username nome --password pass

}}}

Accesso diretto (file://)

È il più semplice fra i vari metodi di accesso. Consente all'utente di eseguire delle operazioni in un repository presente sulla stessa macchina, inoltre non richiede l'esecuzione in background di alcun processo server. La sintassi dei comandi è simile ai seguenti esempi:

svn co file://localhost/svn/progetto

• svn co file:///home/svn/progetto

I permessi del repository dipendono dai permessi attivi sul filesystem al momento dell'accesso. Nel caso l'utente non possieda i permessi necessari per le operazioni di lettura/scrittura, non potrà eseguire alcune operazioni, come, ad esempio, il [#checkout checkout]. Per estendere i permessi ad uno o più utenti sarà sufficiente aggiungerli al gruppo degli utenti ai quali è garantito l'accesso ai contenuti del repository.

Accesso tramite WebDAV (http://)

Per consentire l'accesso tramite il protocollo WebDAV è necessario innanzitutto configurare il proprio server apache.

Per far ciò è necessario installare il pacchetto libapache2-svn attraverso uno degli strumenti sopra citati, infine bisognerà aprire il file /etc/apache2/apache2.conf con un [:EditorDiTesto:editor di testo] qualsiasi e aggiungere queste linee alla fine del file:

  <Location /svn/progetto>
     DAV svn
     SVNPath /home/svn/progetto
     AuthType Basic
     AuthName "myproject subversion repository"
     AuthUserFile /etc/subversion/passwd
     <LimitExcept GET PROPFIND OPTIONS REPORT>
        Require valid-user
     </LimitExcept>
  </Location>

sudo /etc/init.d/apache2 restart

sudo touch /etc/subversion/passwd

sudo htpasswd2 /etc/subversion/passwd nomeutente

svn co http://hostname/svn/myproject progetto --username nomeutente

svn co svn://nomesito/progetto cartella

• co l'operazione da eseguire (in questo caso, il checkout)

• svn:// il protocollo di rete

• nomesito indirizzo del server sul quale risiede il repository dei sorgenti (i.e. progetto.sourceforge.net)

• progetto il nome del progetto del quale si desiderano scaricare i sorgenti. Normalmente, sullo stesso server risiedono più progetti ed è necessario specificare il nome del progetto desiderato. Generalmente, quando si esegue il checkout di un progetto, vengono fornite informazioni esaustive sul nome corretto da inserire.

• cartella la cartella che verrà creata all'interno della cartella corrente, nella quale verrà salvato l'intero repository, mentenendo inalterata la sua struttura.

svn list svn://dominio/cartellaremota

svn add file svn://dominio/cartellaremota
svn add cartellalocale svn://dominio/cartellaremota

svn copy file1 file2
svn copy file1 cartella/file1

svn copy cartella1 cartella2
svn copy cartella1 cartella2/cartella1

svn move file1 file2
svn move file1 cartella/file1

svn move cartella1 cartella2
svn move cartella1 cartella2/cartella1

svn rm file
svn rm cartella

svn import cartellalocale svn://dominio/cartella --username=nomeutente