Date post: | 27-Nov-2015 |
Category: |
Documents |
Upload: | juan-jose-rodriguez |
View: | 738 times |
Download: | 10 times |
Realizado por:
Juan J. Rodríguez
i
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.
1
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, 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.
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 día escribo una introducción y guardo el
archivo. En ese instante tengo la primera versión del documento. Al día siguiente le
agrego el primer capítulo al trabajo y lo vuelvo a grabar, entonces, ahí tengo la
segunda versión del archivo. Y así sucesivamente. Por lo general sobrescribo el mismo
archivo pisando la versión anterior. Resultaría muy engorroso guardar el trabajo con
un nombre diferente cada vez, para conservar los cambios entre versión y versión,
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 creación y modificación de los
distintos archivos de reportes de pruebas, la creación 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 estación de trabajo con una copia local y sin los problemas de conexión a la red
local de la empresa.
2
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 informáticos, pues un pequeño cambio en un archivo, puede
alterar el funcionamiento del software y resultaría muy práctico poder volver a un
estado anterior. Aunque esto es extensible a cualquier tipo de archivos, como
imágenes, planilla de cálculos, videos, textos, etc.
A continuación 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 modificación, 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 almacenarán las versiones de los archivos. pero con una distribución visual
que nos facilita muchísimo la tarea de administración, se llama VisualSVN Server.
Tortoise SVN
Es cliente para Subversión, el sistema de control de versiones que se usa en
Microsystem. Es muy simple de usar, y permite de hacer tanto las operaciones básicas
(bajar y subir el código fuente) como las más complejas (Creaciones de ramas, fusión
etc. ) que no serán abordadas en este documento.
3
Instalación de VisualSVN Server
Ejecutamos el instalador:
Aceptamos el acuerdo de licencia:
4
Seleccionar la primera opción: “VisualSVN Server and Management Console”.
Seleccionar la opción: “Standard Edition”.
5
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.
• Server Port: Puerto por el que se comunicarán los clientes con el servidor. Como se
utiliza una conexión segura, por defecto usamos el puerto 443, pero lo podemos cambiar
si está ocupado por otro servidor.
6
Presionamos el botón <Install>.
Al culminar la instalación presionamos el botón <Finish>.
7
Configuración de VisualSVN Server
Creación de Usuarios
1. Ingresamos al Server
8
2. En el panel izquierdo nos posicionamos sobre la carpeta Users, y hacemos click
derecho y seleccionamos “Create User”.
9
3. En el panel izquierdo nos posicionamos sobre la carpeta Users, y hacemos click
derecho y seleccionamos “Create User”.
4. Presionamos el botón <OK> de la pantalla y ya tendremos nuestro usuario creado.
Creación de Grupos
1. En el panel izquierdo nos posicionamos sobre la carpeta Groups, y hacemos click
derecho y seleccionamos “Create Group”.
10
2. Colocar el nombre del grupo.
3. Presionamos el botón <Add> para agregar los usuarios al grupo que será creado,
luego presionar el botón <OK>.
11
Creación de un Repositorio
1. Seleccionar el ícono “Repositories”, presionar click derecho y seleccionar la opción
“Create New Repository”.
2. Indicar el nombre del nuevo Repositorio y presionar el botón <Siguiente>.
12
3. Seleccionar la primera opción “Empty Repository (recommended option)”.
4. Para dar los permisos de acceso al repositorio, presionar el botón <Custom>.
13
5. Personalizar los permisos de seguridad y acceso.
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.
14
6. Presionamos el botón <Finish> y veremos el repositorio creado.
15
Crear una Nueva Carpeta o Proyecto
1. Nos paramos sobre nuestro repositorio, click derecho, y seleccionamos la opción
Nuevo Folder.
2. Asignamos un nombre, pulsamos el botón <OK> y tendremos nuestra carpeta creada.
16
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.
17
Instalación de TortoiseSVN
1. Ejecutamos el Instalador, presionamos el botón <Next>.
2. Aceptamos el acuerdo de licencia y presionamos el botón <Next>.
18
3. Dejamos las opciones de instalación por defecto y presionamos <Next>.
4. Presionamos el botón <Install>.
19
5. Luego de la instalación presionamos <Finish> y listo.
20
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 deWindows. Aparecerá un nuevo ítem TortoiseSVN : desde aquí se realizan todas lasoperaciones de TortoiseSVN.
Del menú contextual de TortoiseSVN seleccionar SVN Checkout.
En la siguiente pantalla hay que entrar la dirección del repositorio del cual se vadescargar las fuentes.
“Head Revision” significa la última revisión del código, que es la que unogeneralmente quiere.
La carpeta que acaba de recibir el archivo se ve marcada con un “check” en fondoverde. Eso significa que la copia que ésta en la carpeta tiene modificaciones localescon la que está en el repositorio local. A esta carpeta se le denomina “working copy”.
21
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 todavía el cambio no se hizo en el servidor.
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. Eso significa que este cambio todavía no ha sido mandando al
servidor.
22
Subir los Cambios al Servidor (commit)
Cuando los cambios que se realizaron estén 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.
Después 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 están sincronizados.
23
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. Es preferible hacer siempre un Update
antes de ponerse a trabajar y hacer un Commit para evitar los conflictos.
24
Glosario de Términos