Realizado por: Juan J.Rodríguez Resumen El Repositorio es el lugar en el que se almacenan los datos actualizados e históricos de cambios, a menudo en un servidor. A veces se le denomina depósito. Puede ser un sistema de archivos en un disco duro, un banco de datos, entre otros. Se llama Control de Versiones a la gestión de los diversos cambios que se realizan sobre los elementos de algún producto o una configuración del mismo. Estas herramientas son utilizadas para llevar el control de proyectos de desarrollo de aplicaciones, pero también son de gran utilidad para actividades que generen ficheros digitales (documentos, ofertas, dibujos, esquemas). El departamento de Calidad y Pruebas de Software de la Organización Italcambio, debido al gran volumen de la información 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 información vital en el proceso de pruebas a los que son sometidos los distintos sistemas y módulos que allí se realizan a diario. Las herramientas utilizadas y a las que se hará referencia en este manual de instalación y configuración son: • VisualSVN Server – Utilizado para el manejo del repositorio local, es un cliente gráfico de Subversion para Windows, la versión para el momento de la creación de este manual es 2.7.3. • TortoiseSVN – Actúa como un Cliente de Control de Versiones el cual se encarga de gestionar los documentos en nuestro entorno de trabajo, en su versión 1.8. i Y así sucesivamente. para conservar los cambios entre versión y versión. En ese instante tengo la primera versión del documento. Es de vital importancia destacar que durante la creación y modificación de los distintos archivos de reportes de pruebas. Resultaría muy engorroso guardar el trabajo con un nombre diferente cada vez. a medida que se van modificando. ahí tengo la segunda versión del archivo. 1 . el primer día escribo una introducción y guardo el archivo. entonces lo que se hace es sobrescribir el mismo archivo. estos tienen en diferentes momentos diferentes estados.Introducción En todo momento las herramientas que faciliten las labores de colaboración dentro de una organización o entorno de trabajo han sido de gran ayuda. perdiendo de esa forma los estados anteriores del documento. Por lo general sobrescribo el mismo archivo pisando la versión anterior. la creación de las diferentes regresiones de pruebas que se realizan en un determinado momento. son posibles poder realizarlas desde su propia estación de trabajo con una copia local y sin los problemas de conexión a la red local de la empresa. Por ejemplo. es por eso que mediante la instalación de este repositorio y control de versión se reducirán de manera significativa los errores que vienen a la hora de copiar grandes volúmenes de archivos o los que se evidencian en un momento dado al trabajar de manera simultanea en un mismo documento o proyecto. esto y otras bondades que nos brinda el uso de las herramientas mencionadas. Cuando se trabaja con archivos. entonces. supongamos que comienzo un trabajo en un documento en Word. Al día siguiente le agrego el primer capítulo al trabajo y lo vuelvo a grabar. cada una de las versiones o estados de esos archivos. Tortoise SVN Es cliente para Subversión. que utilizadas combinadamente nos proporciona un control de versiones excelente. Estas herramientas de uso libre son: Subversion(VisualSVN Server) y TortoiseSVN. Es muy simple de usar. planilla de cálculos. textos. como imágenes. Aunque esto es extensible a cualquier tipo de archivos. la persona que realizo una determinada modificación. y permite de hacer tanto las operaciones básicas (bajar y subir el código fuente) como las más complejas (Creaciones de ramas. se llama VisualSVN Server. 2 . VisualSVN Server Subversion es el servidor que se encarga de crear los repositorio de datos. A continuación se presentan dos herramientas. Esto resulta muy útil. ) que no serán abordadas en este documento. puede alterar el funcionamiento del software y resultaría muy práctico poder volver a un estado anterior. Nos permite volver a cualquier estado del documento en el que estemos trabajando. es decir. etc. etc. donde se almacenarán las versiones de los archivos. fusión etc. pues un pequeño cambio en un archivo. pero con una distribución visual que nos facilita muchísimo la tarea de administración. el sistema de control de versiones que se usa en Microsystem.Control de Versiones para Archivos y Documentos El control de versiones consiste en disponer de forma ordenada. por ejemplo cuando se programan sistemas informáticos. ver las diferencias entre versiones. videos. Instalación de VisualSVN Server Ejecutamos el instalador: Aceptamos el acuerdo de licencia: 3 . 4 .Seleccionar la primera opción: “VisualSVN Server and Management Console”. Seleccionar la opción: “Standard Edition”. En esta etapa indicamos lo siguiente: • Location: Ruta donde se instalarán los archivos del server. • Repositories: Ruta donde se guardarán los archivos del repositorio y por consiguiente los archivos de nuestro proyecto. por defecto usamos el puerto 443. Como se utiliza una conexión segura. 5 . • Server Port: Puerto por el que se comunicarán los clientes con el servidor. pero lo podemos cambiar si está ocupado por otro servidor. Al culminar la instalación presionamos el botón <Finish>.Presionamos el botón <Install>. 6 . Configuración de VisualSVN Server Creación de Usuarios 1. Ingresamos al Server 7 . 8 . En el panel izquierdo nos posicionamos sobre la carpeta Users. y hacemos click derecho y seleccionamos “Create User”.2. y hacemos click derecho y seleccionamos “Create Group”. En el panel izquierdo nos posicionamos sobre la carpeta Groups. Presionamos el botón <OK> de la pantalla y ya tendremos nuestro usuario creado. y hacemos click derecho y seleccionamos “Create User”. 4. 9 .3. Creación de Grupos 1. En el panel izquierdo nos posicionamos sobre la carpeta Users. 3.2. luego presionar el botón <OK>. 10 . Colocar el nombre del grupo. Presionamos el botón <Add> para agregar los usuarios al grupo que será creado. Creación de un Repositorio 1. Seleccionar el ícono “Repositories”. presionar click derecho y seleccionar la opción “Create New Repository”. 11 . Indicar el nombre del nuevo Repositorio y presionar el botón <Siguiente>. 2. 3. 4. Seleccionar la primera opción “Empty Repository (recommended option)”. presionar el botón <Custom>. Para dar los permisos de acceso al repositorio. 12 . 5. 13 . Se procede a agregar el grupo o usuarios que tendrán acceso a este. de igual manera se puede restringir el acceso a un grupo o usuario en particular si es necesario. Personalizar los permisos de seguridad y acceso. Presionamos el botón <Finish> y veremos el repositorio creado.6. 14 . click derecho.Crear una Nueva Carpeta o Proyecto 1. Asignamos un nombre. 2. y seleccionamos la opción Nuevo Folder. pulsamos el botón <OK> y tendremos nuestra carpeta creada. 15 . Nos paramos sobre nuestro repositorio. Todas las tareas Manage Security 4.3. Asignar permisos y usuarios a nuestra carpeta. Para ello nos paramos en la carpeta. 16 . presionamos click derecho y seleccionamos. Ahí podremos ver los Usuarios y/o Grupos con sus correspondientes permisos. 2.Instalación de TortoiseSVN 1. presionamos el botón <Next>. 17 . Aceptamos el acuerdo de licencia y presionamos el botón <Next>. Ejecutamos el Instalador. Presionamos el botón <Install>.3. 4. 18 . Dejamos las opciones de instalación por defecto y presionamos <Next>. 19 . Luego de la instalación presionamos <Finish> y listo.5. Eso significa que la copia que ésta en la carpeta tiene modificaciones locales con la que está en el repositorio local. aparece el menú contextual del explorador de Windows.Bajar un Proyecto y Enviar Modificaciones al Repositorio Global (checkout) Crear un carpeta que va a recibir el proyecto o documento. que es la que uno generalmente quiere. En la siguiente pantalla hay que entrar la dirección del repositorio del cual se va descargar las fuentes. Al hacer clic derecho encima de ella. La carpeta que acaba de recibir el archivo se ve marcada con un “check” en fondo verde. 20 . Del menú contextual de TortoiseSVN seleccionar SVN Checkout. “Head Revision” significa la última revisión del código. A esta carpeta se le denomina “working copy”. Aparecerá un nuevo ítem TortoiseSVN : desde aquí se realizan todas las operaciones de TortoiseSVN. El archivo (o la carpeta por agregarse) ahora tiene un signo “más” o también (depende de las versiones de Tortoise SVN) un punto de exclamación bajo fondo rojo. Aparece una ventana que dice que el archivo (o la carpeta) esta por agregarse. Eso significa que este cambio todavía no ha sido mandando al servidor. Eso significa que todavía el cambio no se hizo en el servidor. Ponerse encima y hacer clic derecho >> Tortoise SVN >> Add.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. 21 . 22 . Hacer clic en OK. hay que subir esos cambios (archivos / carpetas borrados. Se mandan los cambios en el servidor.Subir los Cambios al Servidor (commit) Cuando los cambios que se realizaron estén completados. modificados o agregados) al servidor. Se puede (y es muy aconsejado) ingresar un comentario describiendo los cambios que se hicieron. 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. Después Tortoise SVN >> Commit. o En la carpeta global para subir todos los cambios de la misma. y ahora los archivos enviados aparecen en la copia local con un “tic” bajo fondo verde: ahora el servidor y la copia local están sincronizados. 23 . Es preferible hacer siempre un Update antes de ponerse a trabajar y hacer un Commit para evitar los conflictos.Actualizar su Copia Local (update) Para obtener la última versión del código 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. Glosario de Términos 24 .
Report "Manual de Instalación y Configuración de VisualSVN y TortoiseSVN"