262012-12-12 12:08:24ClauzClauztrac con WSGI252010-10-15 11:17:55ZioPRoTo242009-09-08 09:51:29ZioPRoTo232009-09-08 09:45:39ZioPRoTo222009-02-09 13:54:31ZioPRoTo212009-02-09 13:42:21ZioPRoTo202008-11-04 01:10:05OrazioPirataDelloSpazio192008-10-23 10:03:01ZioPRoTo182008-03-18 17:28:14localhostconverted to 1.6 markup172008-01-29 17:34:25ZioPRoTo162007-12-11 11:40:05ZioPRoTo152007-11-13 13:34:26ZioPRoTo142007-05-26 18:22:51ZioPRoTo132007-05-26 18:08:35ZioPRoTo122007-05-26 17:44:42ZioPRoTo112007-05-26 17:38:00ZioPRoTo102007-05-26 17:29:33ZioPRoTo92007-05-26 17:20:26ZioPRoTo82007-05-26 17:16:29ZioPRoTo72007-04-29 13:42:22ClauzClauz62007-04-29 13:40:51ClauzClauz52007-04-29 08:08:50ClauzClauz42007-04-28 19:55:42ClauzClauz32007-04-28 19:54:47ClauzClauz22007-04-28 19:41:15ClauzClauz12007-04-28 18:47:16ClauzClauz

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 .

Trac permette di visualizzare il contenuto del repository SVN attraverso un'interfaccia web. Per esempio .

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

Esempio: oppure (abbreviato) 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.

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)

Aggiorna la copia di lavoro dal repository 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.

oppure 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.

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: Per le directory si puo' utilizzare 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: Anche per copiare non bisogna utilizzare il sistema operativo, ma Similmente per rinominare e spostare:

svn help mostra l'aiuto per un determinato subcomando di subversion (i subcomandi sono checkout, udpate, commit, etc)

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 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.

da fare

Mostra gli ultimi 10 messaggi di log (messaggi inseriti con l'opzione -m di svn commit).

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.

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.

In questo capitolo viene spiegato come configurare apache per gestire diversi servers SVN e le relative piattaforme Trac

prima di tutto emergere SVN poi modificate /etc/conf.d/apache2 ed assicuratevi di avere tutte queste cose:

ed aggiungere un nuovo blocco location usando come template questo: 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 ]]>Specificare un file per gli utenti e un altro file (opzionale) per le autorizzazioni (policy). Tipicamente li dovete fare in /var/svn/nuovorepos/conf/ chiamandoli svnusers svnpolicy

Creare il nuovo file svnuser con questo comando: Se il file già esiste invece dovete fare Altrimenti l'opzione -c cancellerà tutto il file

Con questi file l'utente si autentica, pero' vorrete dare diverse autorizzazioni agli utenti. allora dovrete modificare il file svnpolicy come segue: Altro esempio di file delle policy con gruppi: 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: in Se invece volete permettere la lettura (il checkout) anche a chi non è autenticato allora fate cosi: DAV svn SVNPath /var/svn/rastayaqosa AuthType Basic AuthName "Subversion repository" AuthUserFile /var/svn/rastayaqosa/conf/svnusers #AuthzSVNAccessFile /var/svn/rastayaqosa/conf/authz #Require valid-user ]]> Require valid-user #SSLRequireSSL ]]>

Trac è un tool web based per gestire codice di un progetto che usa SVN. Su Gentoo amd64 Trac non è ancora un pacchetto stabile, quindi in /etc/portage/package.keywords Se usate una architettura x86 non questo passaggio non è necessario Per aggiungere un progetto a trac (o meglio per creare un ambiente trac per un progetto): 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: 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 .conf in 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 trac.conf. 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 SetEnv TRAC_ENV "/var/lib/trac/project1" SetEnv LC_TIME "it_IT" Allow from All ]]> AuthType Basic AuthName "Project 1 Trac" AuthUserFile /var/svn/conf/svnusers Require valid-user ]]>Riavviare apache2 con /etc/init.d/apache2 restart

WSGI ha performance molto migliori sia del cgi che dell'fcgi. Per usarlo bisogna creare un file trac.wsgi eseguibile e con il seguente contenuto: Ed inserirlo nella directory dei cgi del trac (/usr/share/webapps/trac/0.12.2/hostroot/cgi-bin/). Configurazione di apache (analoga a quella sopra): SetEnv TRAC_ENV "/var/lib/trac/project1" SetEnv trac.env_path "/var/lib/trac/project1" SetEnv LC_TIME "it_IT" Allow from All ]]> AuthType Basic AuthName "Project 1 Trac" AuthUserFile /var/svn/conf/svnusers Require valid-user ]]>

Apriamo il file /var/lib/trac/project1/conf/trac.ini e modifichiamo quello che serve per l'smtp, altrimenti Trac non sarà in grado di spedire l'email di conferma ad i nuovi utenti che si registrano

Per customizzare ancora l'interfaccia trac ed attivare la gestione utenti del progetto dal web Da Trac 0.11 il pacchetto trac-wedadmin è stato assorbito nel core di Trac quindi non c'è più bisogno di installarlo. Andiamo direttamente a modificare il file: /var/lib/trac/project1/conf/trac.ini 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 con emerge la passo prima) Andate a vedere sul web del vostro trac Ora dobbiamo installare l'account manager plugin. Controllate qui: le istruzioni di installazione, a me è bastato fare cosi:

Installate questo plugin per modificare il file delle policy direttamente da web Poi nella sezione 'admin' del Trac, nel menu 'Plugins' trovate questa nuova feature installata e la potete attivare.

Ho preparato uno script per modificare velocemente i permessi di trac. Modificate il path della variabile URL ed eseguite questo script: fatto questo diamo un aggiustatina ai permessi, cosi trac può operare sui files del repository: ora possiamo editare quasi tutte le opzioni di trac dal web, ovviamente solo se siamo loggati! se qualcosa non funziona subito riavviate apache! More info here: