Opzioni
Gestire un sistema di versioning per TS
- Gestire un sistema di versioning per TS
-
Gestire un sistema di versioning per TS
da strawberryfield » 8 apr 2013, 23:43
Recentemente molti di voi avranno installato sul loro pc un programma chiamato TortoiseSVN al solo scopo di scaricare le build di sviluppo di OpenRails.
Questo programma è il client di un sofisticato sistema che consente di gestire tutte le versioni di un progetto ed anche uno sviluppo collaborativo.
Non pensiate che questo serva solo a chi sviluppa software, ma può essere utilizzato anche per gestire siti web, documenti in genere e... anche i progetti di TS!
Con le metodologie che descriverò sarà possibile prelevare dall'archivio una versione precedente del progetto (route, activity, rotabili..) permettendo di "tornare indietro" dopo una modifica errata o uno "scherzetto" dei vari editor.
I dati verranno presi dalle cartelle gestite con TortoiseSVN e copiati in un database situato in un'altra cartella chiamata "repository". Facendo il backup del repository faremo il backup di tutti i progetti gestiti dal sistema con tutte le loro versioni.
Non serve uno spazio gigantesco per il repository: il sistema è abbastnza furbo da registrare solo le differenze fra una versione e l'altra. In un progetto composto da molti file, specie se di testo, è sorprendentemente efficiente.
Se il repository è gestito su un server, ma anche su un semplice hd usb, può essere utilizzato per tenere sincronizzati più PC senza dover copiare svariati megabyte ogni volta (vengono aggiornate solo le differenze).
Già due anni fa accennavo alla cosa parlando dello sviluppo della Taufererbahn (http://www.trainsimhobby.com/forum/topic.asp?whichpage=-1&TOPIC_ID=5954&REPLY_ID=152758).
Ho ripreso in mano gli appunti che avevo preparato e, vista la grande popolarità di TortoiseSVN, ho pensato di riproporli in questo piccolo tutorial.
Do per scontato che abbiate TortoiseSVN già installato, se così non fosse potete scaricarlo da http://tortoisesvn.net/downloads.html. L'installazione è banale e consiste semplicemente nel cliccare due volte sul file .msi scaricato e confermare i pannelli successivi.
Siccome TS ha file testo codificati in unicode a 16bit che TortoiseSVN non gestisce direttamente è necessario procurarsi anche il programma WinMerge a questo indirizzo: http://winmerge.org/downloads/.
Anche in questo caso l'installazione consiste nel lanciare l'eseguibile scaricato e confermare i vari pannelli.
Fate solo attenzione ad installarlo [b]dopo[/b] TortoiseSVN altrimenti non verrà fatto il collegamento come mostrato in questa schermata:
Per il momento basta così, la prossima volta ci occuperemo dell'installazione della parte server (non serve un vero server, basta anche un netbook!)
roberto -
da RobitailleFan » 9 apr 2013, 10:02
Aspetto i prossimi passi per poi condividere con chi so io una certa linea da finire ...
-
da RobitailleFan » 9 apr 2013, 21:08
AlbertoA ha scritto:
Come mai mi fischiano le orecchie ?
Ma no, è solo una tua impressione ...
-
da strawberryfield » 9 apr 2013, 23:04
Intanto ringrazio tutti quanti per l'attenzione, mi scuso se a qualcuno ho fatto venire degli acufeni
, e dico che ho meditato di utlizzarlo dopo aver letto la guida alla costruzione delle route di Peppe Iannuzzi che nel centro della pagina ha scritto:
[b]TSE NON PERDONA[/b]
Ovviamente ho preso delle contromisure che sono quelle che sto descrivendo....
In questa seconda puntata vedremo come installare la parte server.
Dovremo innanzitutto scaricare Subversion, ne esistono varie versioni compilate, alcune con estensioni grafiche, ma noi useremo quella molto spartana preparata dal gruppo di Apache.
La trovate qui: http://sourceforge.net/projects/win32svn/
Il pacchetto si installa facilmente confermando tutti i pannelli; l'ultimo form dell'installazione ci preannuncia che sarà necessario un altro po' di lavoro...
Ci sono tre possibilità: leggere il manuale che trovate installato (in inglese), leggere una versione non aggiornatissima ma in italiano (http://svnbook.red-bean.com/) oppure seguire questo post...
Iniziamo con il creare un repository.
Io sono abituato a creare un nuovo repository per ogni progetto, tutti all'interno di una unica cartella da posizionare su un disco con una buona quantità di spazio libero.
Assumiamo che questa cartella sia C:repos
Aprite il prompt comandi (si, lo schermo nero con scritto C:)
Scrivete
Codice: Seleziona tutto
svnadmin create "c:reposnomeprogetto"
ovviamente nomeprogetto va personalizzato: evitate spazi punteggiatura e simili, siate concisi.
se andate a guardare nella cartella [b]c:reposnomeprogetto[/b] troverete
Codice: Seleziona tutto
Il volume nell'unit… D non ha etichetta.
Numero di serie del volume: 00B2-CF12
Directory di D:svn_repositorytures
23/01/2011 16.38 <DIR> .
23/01/2011 16.38 <DIR> ..
23/01/2011 16.37 <DIR> conf
23/01/2011 16.37 <DIR> db
23/01/2011 16.37 2 format
23/01/2011 16.37 <DIR> hooks
23/01/2011 16.37 <DIR> locks
23/01/2011 16.37 234 README.txt
3 File 236 byte
6 Directory 32.139.325.440 byte disponibili
andiamo nella cartella [b]CONF[/b] dove troviamo
Codice: Seleziona tutto
Il volume nell'unit… D non ha etichetta.
Numero di serie del volume: 00B2-CF12
Directory di D:svn_repositoryturesconf
09/04/2013 21.44 <DIR> .
09/04/2013 21.44 <DIR> ..
25/01/2011 21.44 1.112 authz
25/01/2011 21.44 317 passwd
25/01/2011 21.44 2.347 svnserve.conf
4 File 3.776 byte
2 Directory 23.653.621.760 byte disponibili
apriamo il file [b]snvserve.conf[/b] e assicuriamoci che l'unica riga senza commento sia
Codice: Seleziona tutto
anon-access = write
Se non ci fosse aggiungetela
[b]Questa configurazione va bene solo per uso personale in quanto disabilita ogni forma di sicurezza[/b]
Un'ultima raccomandazione: non pasticciate gli altri file all'interno del repository se non volete rogne.
Per oggi ci fermiamo qui
roberto -
da strawberryfield » 10 apr 2013, 22:30
Il nostro server sarebbe gia utilizzabile, ma solo in locale, dallo stesso PC.
Ci sono essenzialmente due modi per rendere condivisibile il server da altri PC:
- tramite il web server Apache
- attraverso un servizio specifico
La prima soluzione, a prezzo di una maggiore complessità di installazione, permette di vedere i files con un normale browser, la seconda invece richiede un client specifico come Tortoise SVN (per la verità, assieme al server dedicato, subversion mette a disposizione un client a riga di comando, ma non mi sembra il caso...)
Dobbiamo quindi installare il server di subversion come servizio di Windows (per chi non lo sapesse un "servizio" è un programma senza intefaccia utente che viene attivato automaticamente all'avvio di Windows)
Per fare ciò dal prompt comandi scrivete:
Codice: Seleziona tutto
sc create svnserver binpath= "c:programmisubversionbinsvnserve.exe --service -r c:repos" displayname= "Subversion" depend= Tcpip start= auto
Non starò certo a spiegare che cosa significa tutto ciò, ma vorrei segnalarvi una serie di cose a cui fare attenzione:
- Il comando deve essere scritto tutto su una sola riga
- [b]c:programmisubversion[/b] è il percorso dove è stato installato subversion e scritto così va bene per XP, per Vista/7/8 deve diventare
Codice: Seleziona tutto
"c:Program Filessubversionbinsvnserve.exe"
(vanno inserite anche le barre e le virgolette supplementari)
e nei sistemi a 64bit:
Codice: Seleziona tutto
"c:Program Files (x86)subversionbinsvnserve.exe"
- [b]c:repos[/b] è la cartella che conterrà i nostri repository
Per maggiore chiarezza vi riporto il comando così come dovrebbe essere su un sistema a 64bit installato senza variare i percorsi e con i repository in c:repos
Codice: Seleziona tutto
sc create svnserver binpath= ""c:Program Files (x86)subversionbinsvnserve.exe" --service -r c:repos" displayname= "Subversion" depend= Tcpip start= auto
Il nostro servizio è installato, senza riavviare il pc (che lo farà partire automaticamente) lo possiamo attivare scrivendo dal prompt
Codice: Seleziona tutto
net start svnserver
Il servizio è ora operativo e utilizzabile da tutti i pc collegati in rete.
Anche per oggi basta così, la prossima volta vedremo come popolare il nostro repository.
roberto -
da strawberryfield » 13 apr 2013, 16:30
Ricapitolando:
- abbiamo installato il server Subversion
- abbiamo installato il client TortoiseSVN
- abbiamo creato un repository vuoto
Oggi vediamo come popolare il nostro repository
create una cartella temporanea, all'interno di questa cartella create tre cartelle;
[b]branches[/b]
[b]tags[/b]
[b]trunk[/b]
cliccate con il tasto destro del mouse sulla cartella temporanea, scegliete TortoiseSVN e qui Import
vi apparirà una finestra come questa
il campo in alto dovrà contenere
Codice: Seleziona tutto
svn://localhost/nomeprogetto
Quanto alla descrizione scriveteci pure quello che vi pare
A questo punto potreste anche eliminare la cartella temporanea, ma se pensate di creare altri repository, per altri progetti potete anche tenerla e riciclarla.
Tutta questa struttura non è indispensabile al funzionamento del sistema, ma è consuetudine averla, con quei nomi, per cui non fatevi troppe domande sul suo significato.
Preparata la struttura è arrivato il momento di importare i dati veri.
cliccate con il tasto destro del mouse sulla cartella del vostro progetto, come prima scegliete TortoiseSVN e qui Import
vi apparirà nuovamente questa finestra
il campo in alto questa volta dovrà contenere
Codice: Seleziona tutto
svn://localhost/nomeprogetto/trunk
in pratica va aggiunto solo il [b]/trunk[/b]
Per la descrizione, al solito, scriveteci quello che vi pare.
Il repository è adesso caricato con tutti i dati del vostro progetto, ma la vostra cartella di lavoro non è ancora collegata al sistema.
Rinominate la cartella esistente del progetto e createne un'altra, vuota, con il nome originale.
Cliccate con il tasto destro del mouse sulla cartella appena creata e scegliete SVN Checkout
Vi apparirà questa finestra
il campo in alto dovrà contenere, come prima,
Codice: Seleziona tutto
svn://localhost/nomeprogetto/trunk
il secondo la cartella dove dovranno arrivare i dati (dovrebbe già essere a posto), tutto il resto va bene così come si vede nell'immagine
al termine dell'operazione la nostra cartella sarà evidenziata da un simbolino verde ad indicare che è versionata e allineata all'ultima versione.
Il nostro repository è ora completamente funzionante, ci resta solo da impare come si usa.
roberto -
da strawberryfield » 16 apr 2013, 22:33
Abbiamo costruito, riempito e attivato il repository: e adesso?
Adesso dobbiamo caricare le varie versioni del nostro progetto.
Facciamo pure le nostre modifiche, ad esempio con il route editor, salviamo e andiamo a vedere cosa è successo nella cartella: i files modificati sono identificati da un pallino rosso che sta ad indicare che sono in versione diversa da quella presente nel repository.
Se invece abbiamo aggiunto dei files non ancora presenti nel repository questi sono evidenziati da un punto interrogativo.
Il controllo viene effettuato grazie ad una cartella nascosta [b].svn[/b] presente in tutte le cartelle versionate.
E' altamente sconsigliabile andare a pasticciare all'interno di questa cartellina; se la cancellate ottenete il risultato di scollegare la cartella dal repository.
Per allineare il repository alla nostra directory di lavoro clicchiamo con il tasto destro del mouse sulla cartella (che dovrebbe avere il pallino rosso) e scegliamo [b]SVN Commit[/b]
Ci verrà chiesto anche di descrivere quali sono i cambiamenti apportati in modo da creare un log di tutte le modifiche apportate
Fate attenzione che nel caso di aggiunta di nuovi files questi non vengono aggiunti automaticamente, ma vanno selezionati nella griglia in basso (eventualmente tutti assieme con select/Deselect All
Completato il commit il simbolino della cartella deve tornare verde e anche tutti i files (e cartelle) all'interno devono essere verdi segno che repository e directory di lavoro sono allineati.
Tutto quello che abbiamo detto fino a questo punto vale per qualsiasi tipo di progetto, la prossima volta invece ci occuperemo di un aspetto specifico di MSTS: i files unicode a 16bit.
roberto -
da strawberryfield » 22 apr 2013, 22:28
Come anticipato qualche giorno fa oggi ci occuperemo di un "problema" legato ai file di MSTS.
In effetti non è un vero e proprio problema; il sistema potrebbe funzionare benissimo così come l'abbiamo installato, ma perderemmo la sua maggiore efficinza nel gestire i files di testo.
MSTS è basato su una grande quantità di files di testo, ma si tratta di testo unicode con rappresentazione dei caratteri a 16bit che TotroiseSVN non è in grado di gestire e quindi li tratta come file binari ricaricando ad ogni modifica l'intero file.
Abbiamo però installato una estensione che ci permette di gestire questi file così codificati.
Dobbiamo però informare il sistema su quali file devono essere trattati come testo.
Andiamo nella cartella del nostro progetto e selezioniamo uno o più files da gestire come testo (i path, i .sd, il .tdb...) poi dal menu contestuale (tasto destro del mouse) scegliamo TortoiseSVN e properties
ci apparirà una finestra come questa
[
se non è presente una property [b]svn:mime-type[/b] aggiungiamola con new, altrimenti editiamola con edit
il tipo mime da inserire dovrà essere [b]text/plain[/b]
una volta modificato il mime-type salviamo le modifiche con un commit come già visto.
Da questo momento questi files verranno trattati come testo ed ogni volta salvate solo le differenze.
Per completare ci resta solo da capire come estrarre una particolare versione dei file o esportare i dati per la distribuzione finale; ma questo la prossima volta.
roberto -
da Alpiblu » 23 apr 2013, 0:44
Ti sto seguendo Roberto , non nego una certa curiosità per la cosa .
Alla fine proverò a cimentarmi con il tuo metodo , anche perchè il backup con RE ho visto per esperienza diretta è meglio farlo il piu frequente possibile , onde evitare l'inutile perdita di ore di lavoro .
RE è molto permaloso e bisogna stare in campana continuamente , gli scherzetti mancini li fa quando meno te lo aspetti a tradimento ovviamente !
-
da strawberryfield » 23 apr 2013, 21:30
AlbertoA ha scritto:
Ti sto seguendo Roberto , non nego una certa curiosità per la cosa .
Alla fine proverò a cimentarmi con il tuo metodo...
Luciano intanto puoi già cominciare ad archiviare, mancano solo le procedure di recupero che si spera non siano di uso così frequente
roberto -
da strawberryfield » 26 apr 2013, 22:44
Dunque abbiamo caricato i nostri salvataggi nel repository, ed bel giorno ci accorgiamo che ci serve un file (o anche tutti) di un salvataggio precedente.
Esiste il modo di aggiornare la nostra copia di lavoro ad una versione precedente, ma io uso un approccio differente: scarico la vecchia versione in una cartella di comodo e poi copio i files che mi servono nella working copy facendo credere ad svn che si tratta di files modificati.
In questo modo evito di dover gestire branch che nell'utilizzo che noi facciamo non servono a molto.
creiamo la cartella di appoggio clicchiamo con il tasto di destra e scegliamo TortoiseSVN poi export, ci apparirà questa maschera:
(non fate caso alla caption le due form sono identiche)
Spostate il check da [b]Head[/b] a [b]Revision[/b], nella casella a fianco potete scrivere la versione che vi serve; se non la conoscete premete [b]Show Log[/b] e vi troverete l'elenco dei commit (i salvataggi) con le note che avete scritto
scegliete la versione desiderata dall'elenco e poi procedete con l'export.
Nella cartella di appoggio troverete il progetto completo alla versione richiesta; copiate i files che vi interessano nella copia di lavoro, fate le eventuali modifiche e quindi il solito commit: verrà salvata una nuova versione con i "nuovi" files.
Potete tranquillamente buttare la cartella temporanea.
Lo stesso procedimento, ma lasciando [b]Head[/b] come revisione vi creeerà la distribuzione del vostro progetto all'ultima versione e senza le cartelline .svn che a chi scaricherà il progetto proprio non servono...
Con questo direi che è tutto, ma se ci sono domande chiedete pure
roberto
