Realizado por: Juan J.

Rodrguez

Resumen El Repositorio es el lugar en el que se almacenan los datos actualizados e histricos de cambios, a menudo en un servidor. A veces se le denomina depsito. Puede ser un sistema de archivos en un disco duro, un banco de datos, entre otros. 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. Estas herramientas son utilizadas para llevar el control de proyectos de desarrollo de aplicaciones, pero tambin son de gran utilidad para actividades que generen ficheros digitales (documentos, ofertas, dibujos, esquemas). El departamento de Calidad y Pruebas de Software de la Organizacin Italcambio, debido al gran volumen de la informacin que manejan, ha tomado la iniciativa de utilizar estas herramientas en vista de la necesidad de tener un mejor manejo de los archivos creados e intercambiados entres sus miembros, de esta forma se reduce la perdida de informacin vital en el proceso de pruebas a los que son sometidos los distintos sistemas y mdulos que all se realizan a diario. Las herramientas utilizadas y a las que se har referencia en este manual de instalacin y configuracin son: VisualSVN Server Utilizado para el manejo del repositorio local, es un cliente grfico de Subversion para Windows, la versin para el momento de la creacin de este manual es 2.7.3. TortoiseSVN Acta como un Cliente de Control de Versiones el cual se encarga de gestionar los documentos en nuestro entorno de trabajo, en su versin 1.8.

Introduccin En todo momento las herramientas que faciliten las labores de colaboracin dentro de una organizacin o entorno de trabajo han sido de gran ayuda, es por eso que mediante la instalacin de este repositorio y control de versin se reducirn de manera significativa los errores que vienen a la hora de copiar grandes volmenes de archivos o los que se evidencian en un momento dado al trabajar de manera simultanea en un mismo documento o proyecto. Cuando se trabaja con archivos, a medida que se van modificando, estos tienen en diferentes momentos diferentes estados. Por ejemplo, supongamos que comienzo un trabajo en un documento en Word, el primer da escribo una introduccin y guardo el archivo. En ese instante tengo la primera versin del documento. Al da siguiente le agrego el primer captulo al trabajo y lo vuelvo a grabar, entonces, ah tengo la segunda versin del archivo. Y as sucesivamente. Por lo general sobrescribo el mismo archivo pisando la versin anterior. Resultara muy engorroso guardar el trabajo con un nombre diferente cada vez, para conservar los cambios entre versin y versin, entonces lo que se hace es sobrescribir el mismo archivo, perdiendo de esa forma los estados anteriores del documento. Es de vital importancia destacar que durante la creacin y modificacin de los distintos archivos de reportes de pruebas, la creacin de las diferentes regresiones de pruebas que se realizan en un determinado momento, esto y otras bondades que nos brinda el uso de las herramientas mencionadas, son posibles poder realizarlas desde su propia estacin de trabajo con una copia local y sin los problemas de conexin a la red local de la empresa.

Control de Versiones para Archivos y Documentos El control de versiones consiste en disponer de forma ordenada, cada una de las versiones o estados de esos archivos. Esto resulta muy til, por ejemplo cuando se programan sistemas informticos, pues un pequeo cambio en un archivo, puede alterar el funcionamiento del software y resultara muy prctico poder volver a un estado anterior. Aunque esto es extensible a cualquier tipo de archivos, como imgenes, planilla de clculos, videos, textos, etc. A continuacin se presentan dos herramientas, que utilizadas combinadamente nos proporciona un control de versiones excelente. Nos permite volver a cualquier estado del documento en el que estemos trabajando, ver las diferencias entre versiones, la persona que realizo una determinada modificacin, etc. Estas herramientas de uso libre son: Subversion(VisualSVN Server) y TortoiseSVN.

VisualSVN Server

Subversion es el servidor que se encarga de crear los repositorio de datos, es decir, donde se almacenarn las versiones de los archivos. pero con una distribucin visual que nos facilita muchsimo la tarea de administracin, se llama VisualSVN Server.
Tortoise SVN Es cliente para Subversin, el sistema de control de versiones que se usa en Microsystem. Es muy simple de usar, y permite de hacer tanto las operaciones bsicas (bajar y subir el cdigo fuente) como las ms complejas (Creaciones de ramas, fusin etc. ) que no sern abordadas en este documento.

Instalacin de VisualSVN Server Ejecutamos el instalador:

Aceptamos el acuerdo de licencia:

Seleccionar la primera opcin: VisualSVN Server and Management Console.

Seleccionar la opcin: Standard Edition.

En esta etapa indicamos lo siguiente: Location: Ruta donde se instalarn los archivos del server. Repositories: Ruta donde se guardarn los archivos del repositorio y por consiguiente los archivos de nuestro proyecto. Server Port: Puerto por el que se comunicarn los clientes con el servidor. Como se utiliza una conexin segura, por defecto usamos el puerto 443, pero lo podemos cambiar si est ocupado por otro servidor.

Presionamos el botn <Install>.

Al culminar la instalacin presionamos el botn <Finish>.

Configuracin de VisualSVN Server Creacin de Usuarios 1. Ingresamos al Server

2. En el panel izquierdo nos posicionamos sobre la carpeta Users, y hacemos click derecho y seleccionamos Create User.

3. En el panel izquierdo nos posicionamos sobre la carpeta Users, y hacemos click derecho y seleccionamos Create User. 4. Presionamos el botn <OK> de la pantalla y ya tendremos nuestro usuario creado.

Creacin de Grupos
1. En el panel izquierdo nos posicionamos sobre la carpeta Groups, y hacemos click derecho y seleccionamos Create Group.

2. Colocar el nombre del grupo.

3. Presionamos el botn <Add> para agregar los usuarios al grupo que ser creado, luego presionar el botn <OK>.

10

Creacin de un Repositorio 1. Seleccionar el cono Repositories, presionar click derecho y seleccionar la opcin Create New Repository.

2. Indicar el nombre del nuevo Repositorio y presionar el botn <Siguiente>.

11

3. Seleccionar la primera opcin Empty Repository (recommended option).

4. Para dar los permisos de acceso al repositorio, presionar el botn <Custom>.

12

5. Personalizar los permisos de seguridad y acceso.

Se procede a agregar el grupo o usuarios que tendrn acceso a este, de igual manera se puede restringir el acceso a un grupo o usuario en particular si es necesario.

13

6. Presionamos el botn <Finish> y veremos el repositorio creado.

14

Crear una Nueva Carpeta o Proyecto 1. Nos paramos sobre nuestro repositorio, click derecho, y seleccionamos la opcin Nuevo Folder.

2. Asignamos un nombre, pulsamos el botn <OK> y tendremos nuestra carpeta creada.

15

3. Asignar permisos y usuarios a nuestra carpeta.

Para ello nos paramos en la carpeta, presionamos click derecho y seleccionamos, Todas las tareas Manage Security

4. Ah podremos ver los Usuarios y/o Grupos con sus correspondientes permisos.

16

Instalacin de TortoiseSVN 1. Ejecutamos el Instalador, presionamos el botn <Next>.

2. Aceptamos el acuerdo de licencia y presionamos el botn <Next>.

17

3. Dejamos las opciones de instalacin por defecto y presionamos <Next>.

4. Presionamos el botn <Install>.

18

5. Luego de la instalacin presionamos <Finish> y listo.

19

Bajar un Proyecto y Enviar Modificaciones al Repositorio Global (checkout)

Crear un carpeta que va a recibir el proyecto o documento. Al hacer clic derecho encima de ella, aparece el men contextual del explorador de Windows. Aparecer un nuevo tem TortoiseSVN : desde aqu se realizan todas las operaciones de TortoiseSVN. Del men contextual de TortoiseSVN seleccionar SVN Checkout. En la siguiente pantalla hay que entrar la direccin del repositorio del cual se va descargar las fuentes. Head Revision significa la ltima revisin del cdigo, que es la que uno generalmente quiere. La carpeta que acaba de recibir el archivo se ve marcada con un check en fondo verde. Eso significa que la copia que sta en la carpeta tiene modificaciones locales con la que est en el repositorio local. A esta carpeta se le denomina working copy.

20

Agregar un Archivo o una Carpeta Nueva (add)

Poner el archivo o la carpeta a agregar en la carpeta inicial donde se bajo el proyecto. Ponerse encima y hacer clic derecho >> Tortoise SVN >> Add. Aparece una ventana que dice que el archivo (o la carpeta) esta por agregarse. Eso significa que todava el cambio no se hizo en el servidor. El archivo (o la carpeta por agregarse) ahora tiene un signo ms o tambin (depende de las versiones de Tortoise SVN) un punto de exclamacin bajo fondo rojo. Eso significa que este cambio todava no ha sido mandando al servidor.

21

Subir los Cambios al Servidor (commit)

Cuando los cambios que se realizaron estn completados, hay que subir esos cambios (archivos / carpetas borrados, modificados o agregados) al servidor. Para eso hay que hacer un clic derecho: o Sobre un archivo o una carpeta si solo se quiere subir los cambios relativos a este. o En la carpeta global para subir todos los cambios de la misma. Despus Tortoise SVN >> Commit. Se puede (y es muy aconsejado) ingresar un comentario describiendo los cambios que se hicieron. Hacer clic en OK. Se mandan los cambios en el servidor, y ahora los archivos enviados aparecen en la copia local con un tic bajo fondo verde: ahora el servidor y la copia local estn sincronizados.

22

Actualizar su Copia Local (update)

Para obtener la ltima versin del cdigo fuente hay que hacer un clic derecho sobre la carpeta (o archivo) que se quiere actualizar y seleccionar TortoiseSVN >> Update . Eso permite bajar todos los cambios que realizaron los otros colaboradores. Es preferible hacer siempre un Update antes de ponerse a trabajar y hacer un Commit para evitar los conflictos.

23

Glosario de Trminos

24