Una vez que tenemos ya SVN instalado y más o menos, sabemos lo que es, podemos poner un caso práctico del uso de este repositorio para desarrollar una aplicación en Ruby on Rails (sería parecido para PHP u otros lenguajes). Al proyecto lo vamos a llamar “txurdi_web“.

Lo primero, crear la estructura básica de un repositorio. En muchos how-tos que he leido, borran luego la estructura, pero yo prefiero mantenerla para futuros proyectos; DRY (don’t repeat yoursef – no te repitas); osea que lo guardaremos en la home.

cd /my/homedir
mkdir repo_vacio
mkdir repo_vacio/branches
mkdir repo_vacio/tags
mkdir repo_vacio/trunk

Una vez que tenemos la estructura, creamos el repositorio y hacemos la importación inicial:

svnadmin create /usr/local/svn/repos
svn import /my/homedir/repo_vacio file:///usr/local/svn/repos/txurdi_web -m "Importación inicial desde repo_vacio"

Aquí es donde ya no necesitamos más la estructura que hemos creado en “/my/homedir/repo_vacio”, y la podemos borrar, pero si vamos a hacer otros proyectos despues, nos puede servir, osea que la voy a dejar.

Vamos a la “home” y descargamos (checkout) el repositorio:

cd /my/homedir
svn checkout file:///usr/local/svn/repos/txurdi_web/trunk txurdi_web

Esto nos creará una carpeta “txurdi_web” donde poder agregar nuestra aplicación web. Si usamos PHP, empezaríamos a crear ahí todos los archivos necesarios, a copiar las librerías etc., pero si usamos RoR: “rails txurdi_web” nos hará todo el trabajo

Cada vez que añadamos archivos, tenemos que acordarnos de subirlos al repositorio (si es que queremos mantenerlos ahí). Como en un principio hemos añadido un montón de archivos y carpetas, vamos a hacerlo:

cd txurdi_web
svn add . --force
svn commit -m "Creación inicial del proyecto"

También hemos hecho el primer commit. Acordaos que commit es como “guardame los cambios que he hecho desde la última vez”.

Y con eso ya sería funcional, pero vamos a mejorarlo un poquillo, porque no necesitamos que guarde en el repositorio los logs, ni algunos otros archivos (aunque eso es un poco para gustos):

svn propset svn:ignore "." log/
svn ci -m "Borrando los ficheros de la carpeta log, e ignorandolos en el futuro."
svn up

NOTA: “ci” es lo mismo que “commit”, pero más cortito.

Algunos, también prefieren quitar los archivos de configuración (como el “database.yml”) que tiene sentido si desarrollas en local y usas configuraciones (usuario-clave etc.) diferentes que en producción.

Para escribir esto me he basado en How To Use Subversion with a Rails Project.