Subversion en Windows 2011

Instalacin y configuracin de subversin en Windows

Qu es Subversion?
Antes de saber que es Subversion debemos tener en cuenta algunos conceptos previos cmo el de versin, control de versiones y sistemas de control de revisiones. Una versin, revisin o edicin de un producto, es el estado en el que se encuentra dicho producto en un momento dado de su desarrollo o modificacin. Se llama control de versiones a la gestin de los diversos cambios que se realizan sobre los elementos de algn producto o una configuracin del mismo. Los sistemas de control de versiones facilitan la administracin de las distintas versiones de cada producto desarrollado, as como las posibles especializaciones realizadas. Un Sistema de Control de Revisiones (Revision Control System - RCS) es una implementacin de software para el control de versiones que automatiza las tareas de guardar, recuperar, registrar, identificar y mezclar versiones de archivos. Resumiendo, Subversion no es ms que un sistema de control de versiones diseado especficamente para reemplazar al popular CVS.

Instalacin de Subversion en Windows

Existen multitud de instaladores de subversion, algunos ms complicados que otros. Tenemos que tener en cuenta que un sistema de control de versiones requiere de 3 elementos fundamentales para funcionar: el propio sistema de control de revisiones, un servidor web para poder servir los archivos y un visor para gestionar los repositorios. En este manual utilizaremos el ms completo y sencillo de instalar a mi modo de ver, este software es el Collabnet Subversion Edge e instala en un solo clic subversin, Apache y ViewVC. Aunque esta es la parte que nos va a servir los archivos (la parte servidor) por tanto necesitamos algn programa en nuestros ordenadores para gestionar estos repositorios de manera sencilla, el programa elegido es el Tortoise SVN. Ambas instalaciones son las tpicas de siguiente siguiente, no es necesario configurar nada especfico, lo nico a tener en cuenta es del lado del servidor que el puerto 80 est libre para el apache, en caso de no estarlo debemos modificar este puerto una vez instalado el Collabnet Subversion Edge en su men de Administracin:

Reynier de la Rosa Gonzlez

Subversion en Windows 2011

Nota: la primera vez que instalamos subversion este no se inicia por defecto debemos iniciarlo manualmente en la pantalla de status (ver imagen siguiente) si nos da error de puerto debemos cambiarlo en la imagen anterior y adems debemos marcar el ltimo check de esta pgina para iniciarlo siempre automticamente.

Algunas notas adicionales: El Tortoise SVN se integra con el explorador de Windows por lo que es ms que probable que necesitemos reiniciar el equipo. Tambin es importante recordar la

Reynier de la Rosa Gonzlez

Subversion en Windows 2011

contrasea del usuario admin (en el proceso de instalacin nos pide crear una) en el Collabnet Subversion Edge aunque luego la podamos cambiar.

Creacin de repositorios
Aclaremos algunos conceptos primero, un repositorio se crea en el servidor y los usuarios al conectarse a este se descargan o suben archivos al mismos, un repositorio no est en local, en local slo tenemos una copia (puede que no sea actualizada) del repositorio almacenado en el servidor. Una vez aclarado esto crearemos un repositorio en nuestro servidor:

El nico paso que tenemos que hacer es darle un nombre, ms nada. Sencillo verdad? Para ver nuestro repositorio nos desplazamos hasta el listado:

De este listado con lo que tenemos que quedarnos es con la url del repositorio (recuadro rojo) para poder acceder remotamente al mismo desde nuestro ordenador.

Creacin de usuarios en Subversion

Aunque podemos acceder remotamente con el usuario admin a cualquier repositorio es muy recomendable crear usuarios remotos para estos (tambin para cada repositorio se puede denegar el acceso a unos usuarios y permitirlo a otros). Debemos tener en cuenta que los usuarios creados en la siguiente pantalla tienen acceso a todos los repositorios por defecto, para editar estos accesos en cada uno debemos ir a cada repositorio y modificar las reglas de acceso. Para crear un usuario solo debemos rellenar los datos y elegir el rol del mismo, por defecto siempre ser un usuario normal:

Reynier de la Rosa Gonzlez

Subversion en Windows 2011

Recordad que si no editamos las reglas de acceso de nuestros repositorios todos los usuarios que creemos aqu van a tener acceso a los mismos. Bien, hasta ahora todo es bastante sencillo, y la siguiente parte tambin, aunque tenemos que hacer algunos pequeos trucos para trabajar con proyectos que ya existen.

Actualizar un repositorio para un proyecto con archivos ya creados

Este pequeo truco se debe a una limitacin por parte de Subversion que impide que vinculemos un directorio local a un repositorio si este directorio no est vaco. La pregunta sera entonces como creo un repositorio para archivos que ya tengo? Cmo los incluyo en este repositorio nuevo? El truco es muy sencillo y os describo los pasos a seguir: 1. Primero debemos subir los archivos al repositorio nuevo que hemos creado 2. Luego debemos crear una carpeta local al mismo nivel que la que contiene los archivos subidos. 3. Despus vinculamos esta carpeta nueva con el repositorio (con ello tendra una copia exacta de todos los archivos subidos) 4. Finalmente borramos la carpeta original y renombramos la nueva con el nombre original. De esta forma ya tenemos un directorio local vinculado a un repositorio con los archivos antiguos. Importante: esto no es necesario para proyectos nuevos en los cuales no hayamos creado ningn archivo an.

Reynier de la Rosa Gonzlez

Subversion en Windows 2011

Veamos estos pasos uno a uno. Subir archivos antiguos a un repositorio nuevo Para importar archivos a nuestro repositorio lo podemos hacer de una manera muy simple con Tortoise SVN, como os dije anteriormente este programa se integra perfectamente con el explorador de Windows por lo que el nico paso necesario es hacer clic derecho sobre la carpeta, elegir Tortoise SVN y luego importar:

En la siguiente ventana introducimos la url del repositorio (sin usuario) y en caso de que no la tengamos cacheada en nuestro ordenador nos pedir el usuario y la clave al pulsar Aceptar, si todo est correcto se iniciar el proceso y tendremos ya subidos los archivos a nuestro repositorio.

Reynier de la Rosa Gonzlez

Subversion en Windows 2011

Nota: Este paso solo sube los archivos (los importa) a nuestro repositorio pero no vincula esta carpeta con el mismo que es lo que necesitamos para subir las modificaciones o descargarnos revisiones antiguas. Vincular una carpeta local a un repositorio Este paso si deben seguirlo todos los que quieran vincular carpetas locales a un repositorio y recordar que la carpeta local debe estar vaca y con permisos de escritura. Igualmente que en el paso anterior para obtener el cdigo de un repositorio y vincularlo a nuestra carpeta local lo nico que debemos hacer es clic derecho y pulsar la opcin Obtener:

En el dialogo siguiente seleccionamos el repositorio (nos pedir igualmente el usuario y la contrasea al pulsar aceptar si el mismo no est cacheado) y podemos descargarnos cualquiera de las revisiones existentes, para la primera vez es aconsejable descargarse la HEAD (la ltima):

Reynier de la Rosa Gonzlez

Subversion en Windows 2011

De esta forma ya tenemos vinculado nuestro directorio con un repositorio, si todo ha ido bien aparte de descargarnos los archivos al pulsar clic derecho en la carpeta veremos cmo cambian las opciones de la carpeta:

Estas dos opciones son las bsicas de Subversion, SVN Actualizar nos permite obtener los archivos del servidor mientras que SVN Confirmar nos permite importar al repositorio nuestras modificaciones que pueden estar acompaadas o no por algn mensaje identificativo de la operacin o los cambios realizados. Nota adicional: Podemos acceder y confirmar cambios en repositorios de unidades de red siempre y cuando estos se hayan creado desde la mquina real, o sea si t tienes en un servidor un directorio vinculado a un repositorio y accedes a l desde t mquina puedes confirmar los cambios desde all sin necesidad de hacerlo desde la propia mquina.

Reynier de la Rosa Gonzlez