CONTROL DE VERSIONES CON SUBVERSION

SubVersion (en adelante SVN) es una herramienta para el control de versiones de ficheros electrónicos, como pueden ser los que integran el software o la documentación. Además es un proyecto de software libre (Open Source) consolidado, con una linea de desarrollo muy activa; y cuyo código fuente está disponible. SVN está construido sobre la librería APR (Apache Portable Runtime), de modo que puede instalarse en cualquier sistema operativo donde pueda ejecutarse el servidor web Apache (como son Windows y Linux).

SVN se basa en un repositorio central que actúa como un servidor de ficheros, con la capacidad de recordar todos los cambios que se hacen tanto en sus directorios como en sus ficheros. De esta forma, aunque SVN nos mostrará la última versión, permite recuperar viejas versiones y examinar el historial de cambios.

SVN se puede utilizar para gestionar el versionado de cualquier tipo de fichero, no sólo software. De hecho SVN sólo se encarga del control de versiones, y no de la gestión de la configuración del software.

¿Cómo resuelve SVN el problema de la compartición de ficheros? SVN no usa el modelo bloquear-modificar-desbloquear; sino el modelo copiar-modificar-fundir. ¿Qué significa ésto? Pues que SVN no bloquea un fichero mientras lo estamos modificando. Esto, que inicialmente puede parecer una carencia, realmente no lo es, todo lo contrario, mejora la productividad al tener los ficheros siempre accesibles. Además, en el caso de que dos usuarios accedan al mismo fichero y lo modifiquen, el primero que lo actualice no tendrá problemas para dejarlo en el repositorio; pero el segundo ya no podrá hacerlo, y SVN le avisará de que hay un conflicto y el fichero ha sido modificado, dándole la opción de revisar las tres versiones (la original, la suya y la del otro) y resolver el conflicto.

SVN tiene una arquitectura cliente/servidor. El repositorio reside en el servidor, y los usuarios acceden a él haciendo uso de un cliente. Para Windows existe un cliente muy bueno, llamado TortoiseSVN, que además es software libre. Hay dos clientes más, ambos de código abierto: RapidSVN (para Linux y Windows) y JSVN (hecho en Java, y por tanto, multiplataforma).

Recomendamos el uso del cliente TortoiseSVN, cuyo manejo es fácil e intuitivo. De hecho se integra con el explorador de Windows; de modo que no hay que trabajar con otra herramienta más. TortoiseSVN no es más que otra opción del menú del explorador. Además, incorpora una serie de iconos que permiten visualizar si un fichero o directorio pertenece al sistema de control de versiones, y en tal caso, conocer su estado.

SVN tiene una ventaja más, y es que se puede acceder vía web, haciendo muy fáciles las consultas; e incluso se podría actualizar vía web, usando webdav y activando el autoversionado.

¿Qué necesitamos para empezar a trabajar con SVN? En primer lugar un servidor, como es el caso de mncs.atica.um.es, donde instalar SVN y poder crear los repositorios necesarios (ver Apéndice A, Instalación del servidor SVN para instalación de la parte servidor).

¿Cómo creamos un repositorio? En el servidor donde tengamos instalado SVN, usaremos el comando svnadmin:

$ svnadmin create /SVN/MNCS

De esta forma creamos un repositorio vacío para la MNCS. El repositorio no es accesible directamente, es necesario usar un cliente SVN.

¿Cómo cargamos el repositorio con nuestro software o nuestra documentación? La carga inicial la haremos utilizando el cliente, con la opción import:

$ svn import /home/juanlu/novell/MNCS file:///SVN/MNCS -m "MNCS. Carga inicial."

En el ejemplo hemos cargado lo que tiene la MNCS en Novell (en la G), en el repositorio SVN de la propia MNCS. En este caso hemos utilizado una URL de tipo "file" porque estamos conectados al propio servidor donde está el repositorio, y lo tenemos accesible. También podíamos haber usado una URL del tipo "http", pero es más lento.

El repositorio SVN para la MNCS está en https://mncs.atica.um.es/svn/MNCS/.

¿Cómo empieza a trabajar un usuario con un repositorio SVN? En primer lugar hay que instalar el cliente SVN, por ejemplo TortoiseSVN (ver Apéndice D, Instalación del cliente TortoiseSVN). Una vez instalado, crearemos un directorio de trabajo (working directory), en el que cargaremos aquella rama (directorio) del repositorio que contiene el fichero o ficheros que queremos modificar.

Voy a explicar todo el proceso poniendo ejemplos, primero con el cliente SVN en línea de comando (Linux), y luego con el cliente TortoiseSVN (Windows).

Para acceder al repositorio y descargar un directorio, haremos un "checkout" (obtener). Esta operación convierte un directorio en un "directorio de trabajo". Básicamente carga la rama del repositorio indicada y en cada subdirectorio incluye un directorio oculto, con el nombre ".svn", donde guarda la información de sincronización con el repositorio:

$ svn checkout https://mncs.atica.um.es/svn/MNCS/proyectos/ControlVersiones /home/juanlu/svn/ControlVersiones

En el ejemplo anterior vemos la carga inicial del directorio de trabajo, con el cliente SVN desde la línea de comando. Veamos cómo hacerlo con el cliente TortoiseSVN:

Figura 1. Carga inicial del directorio de trabajo (checkout)

Figura 2. URL del repositorio y path del directorio de trabajo

Figura 3. Autenticación contra el repositorio

Figura 4. Progreso de la carga y visualización del resultado final

Una vez que tenemos en local aquella parte del repositorio con la que queremos trabajar, si queremos modificar un archivo, usaremos nuestro editor favorito. De igual modo, si queremos añadir un archivo, también usaremos nuestro editor preferido (FormsBuilder, XMLMind, Kawa, etc).

Desde la versión 1.2 de Subversion, se pueden bloquear ficheros; de modo que si dispones de un servidor 1.2 o superior, y te has instalado un cliente que implemente la funcionalidad; puedes bloquear el fichero (o ficheros) que vayas a modificar, antes de iniciar los cambios. Lo puedes hacer, seleccionando el fichero a bloquear, con la opción "Obtener bloqueo" (o desde la línea de comando con "svn lock").

Si hemos creado un archivo nuevo, antes de enviar los cambios, debemos incluirlo en el sistema de control de versiones, con "add" (añadir):

$ svn add /home/juanlu/svn/ControlVersiones/documentacion/svnAdd.bmp

Incluir un fichero nuevo en el control de versiones, con TortoiseSVN es muy fácil:

Figura 5. Añadir un fichero al sistema de control de versiones (add)

Figura 6. Revisar la lista de ficheros a añadir que hemos seleccionado (add)

Figura 7. Progreso de la carga y visualización del resultado final (add)

Una vez que hemos añadido el nuevo fichero, o hemos modificado el archivo deseado, tenemos que enviar los cambios al repositorio, con "commit" (confirmar). No olvidemos indicar un comentario explicativo de los cambios que hemos hecho:

$ svn commit -m "MNCS. ControlVersiones. Guia Rápida SVN. Imágenes."

Con TortoiseSVN, como siempre, esta operación es muy sencilla:

Figura 8. Enviar cambios al repositorio (commit)

Figura 9. Comentarios a incluir en el repositorio relativos a los cambios realizados (commit)

Figura 10. Progreso de la carga y visualización del resultado final (commit)

Dentro de las operaciones básicas, nos queda saber cómo actualizar nuestro directorio de trabajo con los cambios que hagan nuestros compañeros en el repositorio, con "update" (actualizar):

$ svn update

Figura 11. Actualizar directorio de trabajo con cambios hechos por otros (update)

Figura 12. Autenticación contra el repositorio (update)

Figura 13. Progreso de la carga y visualización del resultado final (update)

Si al hacer "update" (actualizar) de nuestro directorio de trabajo, encontramos conflictos con algún fichero, nos indicará que alguien ha subido al repositorio cambios antes que nosotros, que afectan a ficheros que estamos modificando. En tal caso, aparecerán en nuestro directorio de trabajo dos ficheros nuevos, con extensiones que indican a qué revisión corresponden; por ejemplo, r16 y r17, donde r16 es la revisión sobre la que inicié los cambios que todavía no he subido, y r17 es la revisión como consecuencia de los cambios que han subido al repositorio antes que nosotros.

En esta situación, editaremos nuestro fichero y le aplicaremos los cambios oportunos para reflejar la actualización que se nos ha adelantado (para ello seguramente necesitaremos contactar con la persona que hizo dichos cambios). Una vez que nuestro fichero incluye dichos cambios (además de los nuestros), resolveremos el conflicto:

$ svn resolved /ruta/fichero_en_conflicto

También nos podemos encontrar con un conflicto al intentar hacer un "commit" (validar) de nuestros cambios; en el caso de que otro usuario haya subido sus cambios (sobre el mismo fichero que estamos modificando) al repositorio antes que nosotros. En tal caso, tendremos que hacer un "update" (actualizar), para bajarnos la nueva revisión del fichero, y proceder como en el caso anteriormente expuesto.

Por supuesto, con el cliente gráfico para Win32 (TortoiseSVN), también tenemos el comando "resolved" (resolver conflicto), una vez que ya hemos mezclado nuestros cambios con los del usuario que se nos adelantó.