Sie sind auf Seite 1von 33

ANEXO a la Gua de

Estndares
Uso De SVN

Contenido
1 Introduccin______________________________________________5
1.1

Estructura de carpetas en SVN____________________________5

2 Utilizacin Clientes SVN__________________________________5


2.1

TortoiseSVN_________________________________________________5

2.1.1
2.1.2
2.1.3
2.1.4
2.1.5
2.1.6
2.1.7
2.1.8

2.2

Obtener repositorio con TortoiseSVN______________________________5


Aadir ficheros/carpetas al repositorio con TortoiseSVN____________6
Actualizacin de archivos en el repositorio con SVN_______________8
Bloqueo de Ficheros en SVN______________________________________9
Creacin de una rama/etiqueta con TortoiseSVN_________________10
Fusin de ramas con SVN________________________________________18
Renombrado de Ficheros/Carpetas en TortoiseSVN_______________21
Reubicacin de Ficheros/Carpetas en TortoiseSVN________________23

Plugin de Subversion para RSA__________________________24

2.2.1
2.2.2
2.2.3
2.2.4

Instalacin del Plugin____________________________________________24


Utilizacin del Plugin____________________________________________27
Importar un proyecto SVN existente_____________________________27
Importar un proyecto SVN existente con seleccin de carpetas.__29

2.3

Aadir un proyecto de RSA a SVN_______________________31

2.4

Interfaz hacia SVN desde RSA___________________________33

ndice de Ilustraciones
Ilustracin 1: Checkout con TortoiseSVN............................................................6
Ilustracin 2: Aadir carpeta con TortoiseSVN....................................................7
Ilustracin 3: Confirmar carpeta..........................................................................8
Ilustracin 4: Estado de fichero modificado en Tortoise SVN..............................8
Ilustracin 5: Actualizacin de ficheros en Tortoise SVN...................................8
Ilustracin 6: Fichero Actualizado en Tortoise SVN............................................8
Ilustracin 7: Bloqueo de ficheros en Tortoise SVN............................................9
Ilustracin 8: Desbloqueo de ficheros en Tortoise SVN....................................10
Ilustracin 9: Creacin de una etiqueta.............................................................11
Ilustracin 10: Creacin de carpeta de etiqueta................................................12
Ilustracin 11: Carpeta destino etiqueta............................................................13
Ilustracin 12: incluir carpeta a etiquetar..........................................................14
Ilustracin 13: Actualizacin de la carpeta........................................................15
Ilustracin 14: Creacin de una rama...............................................................16
Ilustracin 15: Creacin de carpeta de rama....................................................17
Ilustracin 16: Carpeta destino de la rama.......................................................18
Ilustracin 17: Fusin de ramas........................................................................19
Ilustracin 18: Seleccin de la versin..............................................................19
Ilustracin 19: Inclusin de la versin...............................................................20
Ilustracin 20: Seleccin de la rama a fusionar................................................21
Ilustracin 21: Seleccin del fichero a Renombrar............................................22
Ilustracin 22: Nuevo nombre del fichero.........................................................22
Ilustracin 23: Confirmacin del nuevo nombre del fichero..............................23
Ilustracin 24: Seleccin de la carpeta a reubicar............................................24
Ilustracin 25: Men Contextual Mover Carpeta...............................................24
3

Ilustracin 26: Configuracin del Proxy en RSA...............................................25


Ilustracin 27: Instalacin Subclipse.................................................................26
Ilustracin 28: Seleccin de mdulos...............................................................27
Ilustracin 29: Seleccin de la direccin del repositorio....................................28
Ilustracin 30: Realizar el checkout del proyecto..............................................29
Ilustracin 31: Seleccin de la direccin del repositorio....................................30
Ilustracin 32: Seleccin de las carpetas/mdulos...........................................30
Ilustracin 33: Realizar el checkout de los proyectos.......................................31
Ilustracin 34: Seleccin del repositorio donde subir el proyecto......................32
Ilustracin 35: Seleccin de archivos e introduccin de comentario.................32
Ilustracin 36: Men de opciones de SVN desde RSA.....................................33

1 Introduccin
Subversion es un sistema de control de versiones libre y de cdigo fuente
abierto. Por el hecho de ser un sistema de control de versiones maneja ficheros y
directorios a travs del tiempo. Para realizar esta tarea Subversion mantiene un
repositorio con los ficheros, directorios y las modificaciones que se han realizado en
ellos.

Estructura de carpetas en SVN


La estructura en la que se van a organizar los repositorios en SVN se
compondr de las siguientes subcarpetas:
Nombre de Repositorio
branches
tags
trunk

Ej: APIAM
branches
tags
trunk

La carpeta de trabajo ser la carpeta trunk, bajo dicha carpeta se generar la


estructura de directorios definida en la Gua de estndares, a saber, fuentes,
documentacin y despliegues.

2 Utilizacin Clientes SVN


En el IAM se proporciona la herramienta TortoiseSVN para acceder al
repositorio de Subversion.
Otra forma de acceder al repositorio es utilizar un navegador de internet
usando para ello la URL del repositorio.
En este Anexo se va a explicar el funcionamiento bsico de TortoiseSVN, y del
Plugin de Subversion para RSA.

TortoiseSVN
A continuacin se detallan las operaciones ms comunes a realizar con
TortoiseSVN

2.1.1Obtener repositorio con TortoiseSVN


Con TortoiseSVN instalado, se crea una carpeta en el sistema de ficheros local
y se realiza la operacin SVN Checkout, tras la cual aparecer la siguiente ventana:
5

Ilustracin 1: Checkout con TortoiseSVN

Se
ha
de
poner
la
URL de
la
mquina
servidora
(https://polarion.munimadrid.es/) y la ruta al repositorio/carpeta que se quiere obtener.
Nos solicitar usuario y password, se ha de poner el usuario y password que se tenga
de AYRE y a partir de ese momento, se tendr una copia en el sistema de ficheros
local del repositorio seleccionado.
Si se quiere una versin diferente, se puede indicar en el cuadro
Revision cuando se hace un SVN checkout.

2.1.2Aadir ficheros/carpetas al repositorio con TortoiseSVN


Para subir un fichero/carpeta al repositorio, en el explorador de proyectos nos
posicionaremos en la ruta donde queremos incluir el archivo o carpeta y
seleccionaremos la opcin TortoiseSVN Add, tal y como se muestra en la siguiente
figura:

Ilustracin 2: Aadir carpeta con TortoiseSVN

Una vez aadida la carpeta se nos mostrar el siguiente icono


Para confirmar la subida de la carpeta al repositorio, tendremos que
confirmar la operacin con la opcin de men SVN Commit.

Ilustracin 3: Confirmar carpeta

2.1.3Actualizacin de archivos en el repositorio con SVN


Con TortoiseSVN, una vez modificado un archivo se nos mostrar el siguiente
icono:

Ilustracin 4: Estado de fichero modificado en Tortoise SVN

Para realizar la actualizacin del fichero en el repositorio se debe realizar la


operacin SVN Commit:

Ilustracin 5: Actualizacin de ficheros en Tortoise SVN

Una vez realizado el commit el fichero quedar actualizado en el repositorio.

Ilustracin 6: Fichero Actualizado en Tortoise SVN

2.1.4Bloqueo de Ficheros en SVN


En SVN, es posible trabajar con apropiacin de ficheros, de esta forma,
se evitarn los conflictos de actualizacin del mismo fichero por distintas
personas en un mismo momento.
Para realizar el bloqueo de un fichero seleccionaremos el fichero y en el
men contextual seleccionaremos la opcin Get Lock

Ilustracin 7: Bloqueo de ficheros en Tortoise SVN

nicamente cuando un fichero este bloqueado nos aparecer la opcin de


desbloquearlo:

Ilustracin 8: Desbloqueo de ficheros en Tortoise SVN

Cuando se hace un Commit y se tena bloqueado el fichero queda liberado el


lock.

2.1.5Creacin de una rama/etiqueta con TortoiseSVN


La creacin de una rama/etiqueta conlleva la creacin de una copia de toda la
carpeta seleccionada en una ubicacin diferente. La copia se hace mediante enlaces
simblicos, lo que quiere decir que no es una copia real de toda la informacin.
A continuacin se describe en detalle los pasos a seguir para la creacin de
una rama y/o de una etiqueta.
2.1.5.1Creacin de una etiqueta con TortoiseSVN

10

Existen varias maneras para realizar una etiqueta. A continuacin mostramos


una de ellas. Para crear una etiqueta, nos posicionamos en la carpeta trunk del
repositorio local, y en la carpeta o archivos que queramos etiquetar hacemos clic con
el botn derecho. Despus se selecciona la entrada de TortoiseSVN denominada
Branch/tag. Con esta opcin se nos muestra la siguiente ventana:

Ilustracin 9: Creacin de una etiqueta

En esta ventana aparecen los siguientes campos:


-

From WC at URL: Indicamos la carpeta que queremos etiquetar de nuestro


repositorio local.

To URL: Indicamos la carpeta destino de la etiqueta. Para ello vamos a seguir


los siguientes pasos:
o Se debe tener en cuenta que todas las etiquetas del repositorio se
deben ubicar en la carpeta tags, adems se debe cumplir el
estndar de etiquetado especificado en la Gua de Estndares, por
lo que el primer paso ser la creacin de la carpeta con el nombre
de la etiqueta correspondiente dentro de la carpeta tags, para la
creacin de dicha carpeta pulsaremos el botn de explorar

11

directorios de la pantalla anterior


ventana :

y se mostrar la siguiente

Ilustracin 10: Creacin de carpeta de etiqueta

Seleccionaremos la carpeta tags, pulsaremos botn derecho para


desplegar el men contextual y elegiremos la opcin Create folder.

Crearemos una carpeta con el nombre de la etiqueta (V01.01.001), y


seleccionaremos esa carpeta como destino de nuestra etiqueta.

12

Ilustracin 11: Carpeta destino etiqueta

En esta ruta, aadiremos la carpeta que queremos etiquetar


(fuentes)

Se debe elegir la opcin Working copy si se quiere etiquetar la copia


de trabajo, se debe realizar adems un commit previo, ya que si no
la etiqueta no se aplicar al contenido que no est en dicho estado.

13

Ilustracin 12: incluir carpeta a etiquetar

Pulsaremos el botn OK, y se crear la copia etiquetada en el


repositorio en el directorio tags. Para comprobar la creacin de
dicha etiqueta, solo tendremos que actualizar la carpeta tags
(realizar un SVN Update)

14

Ilustracin 13: Actualizacin de la carpeta

2.1.5.2Creacin de una rama con TortoiseSVN


Existen varias maneras para realizar una rama. A continuacin mostramos una
de ellas. Para crear una rama, nos posicionamos en la carpeta trunk del repositorio, y
en la carpeta o archivos que queramos enramar. Despus se selecciona la entrada de
TortoiseSVN denominada Branch/tag. Con sta opcin se nos muestra la siguiente
ventana:

15

Ilustracin 14: Creacin de una rama

En esta ventana aparecen los siguientes campos:


-

From WC at URL: Indicamos la carpeta de la que queremos crear la rama.

To URL: Indicamos la carpeta destino de la rama. Para ello vamos a seguir los
siguientes pasos:
Se debe tener en cuenta que todas las ramas del repositorio se deben ubicar
en la carpeta branches, adems se debe cumplir el estndar de etiquetado
especificado en la gua de estandares, por lo que el primer paso ser la creacin de la
carpeta con el nombre de la rama correspondiente dentro de la carpeta branches, para
la creacin de dicha carpeta pulsaremos el botn de explorar directorios de la pantalla
anterior

y se mostrar la siguiente ventana :

16

Ilustracin 15: Creacin de carpeta de rama

Seleccionaremos la carpeta branches, pulsaremos botn derecho para


desplegar el men contextual y elegiremos la opcin Create folder.
Crearemos una carpeta con el nombre de la rama (Rama de desarrollo), y
seleccionaremos esa carpeta como destino de nuestra rama.
En esta ruta, aadiremos la carpeta a enramar (fuentes)

17

Ilustracin 16: Carpeta destino de la rama

Pulsaremos el botn OK, y se crear la copia etiquetada en el repositorio en el


directorio branches. Para comprobar la creacin de dicha etiqueta, solo tendremos que
actualizar la carpeta branches (realizar un SVN Update)

2.1.6Fusin de ramas con SVN


Con SVN, como se explica en el apartado anterior, existe la posibilidad de
trabajar con ramas, para la fusin de dichas ramas se deben seguir los siguientes
pasos:
Nos posicionamos en la copia de trabajo, carpeta trunk, en la que queremos
actualizar los cambios de la rama y en el men contextual seleccionamos la opcin
Merge. Nos aparecer la siguiente pantalla:

18

Ilustracin 17: Fusin de ramas

Seleccionaremos la versin de la carpeta de trabajo que queremos fusionar con


la rama. Para ello, pulsaremos el botn Show log y elegiremos la versin a fusionar

Ilustracin 18: Seleccin de la versin

19

Pulsaremos el botn Ok, y volveremos a la pantalla anterior, donde ya


tendremos la Revision a fusionar.

Ilustracin 19: Inclusin de la versin

TortoiseSVN, por defecto, indica una versin menos de la seleccionada, con lo


que habr que indicar una ms de la que indica por defecto.
En el apartado To(en URL and revisin of the range to merge) , indicaremos la
carpeta de la rama que queremos fusionar con nuestra carpeta de trabajo
(seleccionaremos la rama de la carpeta branches). Para ello, desmarcaremos la casilla
Use From:URL (revisin range is selectable in the above log dialog ) , y marcaremos
la opcin HEAD revision , tal y como se indica en la siguiente imagen:

20

Ilustracin 20: Seleccin de la rama a fusionar

Una vez tengamos toda la informacin rellena, pulsaremos el botn Merge, y la


fusin se realizar en local. Una vez que la fusin se ha realizado en local, se realizar
la operacin SVN Commit para terminar el proceso.

2.1.7Renombrado de Ficheros/Carpetas en TortoiseSVN


Con TortoiseSVN existe la posibilidad de renombrar archivos y/o carpetas sin
perder el historial de los mismos. Para ello se deben seguir los siguientes pasos:
Nos posicionamos en el fichero o carpeta a renombrar, pulsamos botn
derecho, opcin TortoiseSVN, opcin Rename como se indica en la siguiente imagen.

21

Ilustracin 21: Seleccin del fichero a Renombrar

Una vez seleccionada la opcin introduciremos el nuevo nombre del fichero


carpeta.

Ilustracin 22: Nuevo nombre del fichero

22

Una vez renombrado, se realiza un SVN Commit para guardar los cambios en
el servidor.

Ilustracin 23: Confirmacin del nuevo nombre del fichero

2.1.8Reubicacin de Ficheros/Carpetas en TortoiseSVN


Con TortoiseSVN existe la posibilidad de mover archivos y/o carpetas sin
perder el historial de los mismos. Para ello se deben seguir los siguientes pasos:
Seleccionamos con el botn derecho del ratn carpeta/fichero a reubicar y sin
soltarlo lo arrastramos a la nueva ubicacin.

23

Ilustracin 24: Seleccin de la carpeta a reubicar

Una vez que soltemos la carpeta en la nueva ubicacin nos aparecer el


siguiente men contextual:

Ilustracin 25: Men Contextual Mover Carpeta

Seleccionamos la opcin marcada en la imagen anterior, SVN Export


versioned tems here, y la carpeta quedar reubicada.

Plugin de Subversion para RSA

2.1.9Instalacin del Plugin


Antes de la instalacin del plugin se debe configurar el proxy en RSA, ya que
para la instalacin necesitamos la conexin a internet desde RSA.
Para configurar el proxy se deben seguir los siguientes pasos:
Acceder al men Ventana Preferencias General Conexiones de red
24

Nos aparecer la ventana de configuracin del proxy donde deberemos indicar


los parmetros que aparecen en la siguiente imagen:

Ilustracin 26: Configuracin del Proxy en RSA

25

A continuacin se describen los pasos a seguir para realizar la instalacin de


Subclipse:
Acceder al men Ayuda Actualizaciones de Software
Aadir sitio

seleccionamos

Ilustracin 27: Instalacin Subclipse

URL: http://subclipse.tigris.org/update_1.6.x/
A continuacin, dentro la url, seleccionamos las opciones indicadas en la
siguiente imagen y pulsamos el botn instalar.

26

Ilustracin 28: Seleccin de mdulos

De esta manera, ya se tendra instalado el plugin Subclipse de SVN para RSA y


estara listo para utilizar.

2.1.10

Utilizacin del Plugin

Una vez instalado el plugin, se nos ha aadido una nueva perspectiva SVN
Repository Exploring, y ya podemos utilizar subclipse para realizar checkouts y
commits de nuestros proyectos desde el entorno de RSA. A continuacin se describe
como hacer estas tareas con el nuevo plugin.

2.1.11

Importar un proyecto SVN existente

Desde la perspectiva SVN Repository Exploring y dentro de la pestaa SVN


Repository, pulsando botn derecho del ratn elegimos new repository location e
introducimos la direccin del proyecto dentro del repositorio.

27

Ilustracin 29: Seleccin de la direccin del repositorio

Ahora en la pestaa SVN Repository habr aparecido una nueva entrada con la
nueva ruta introducida para el repositorio. Pulsando botn derecho sobre la nueva
entrada, seleccionamos checkout, para crear un nuevo proyecto en el espacio de
trabajo, pudiendo seleccionar el nmero de revisin que queremos obtener del
repositorio.

28

Ilustracin 30: Realizar el checkout del proyecto

A continuacin si accedemos a la perspectiva Java, ya dispondramos del


proyecto en el Explorador de Paquetes para poder trabajar con l.

2.1.12
Importar un proyecto SVN existente con seleccin
de carpetas.
Desde la perspectiva SVN Repository Exploring y dentro de la pestaa SVN
Repository, pulsando botn derecho del ratn elegimos new repository location e
introducimos la direccin del proyecto dentro del repositorio.

29

Ilustracin 31: Seleccin de la direccin del repositorio

Ahora en la pestaa SVN Repository aparecer una nueva entrada con la


nueva ruta introducida para el repositorio. Pulsando sobre la nueva entrada, se
expandirn las carpetas existentes que podrn ser seleccionadas por el usuario a su
conveniencia.

Ilustracin 32: Seleccin de las carpetas/mdulos

30

Con la seleccin realizada pulsamos la opcin checkout sobre el men de


contextual, para crear el conjunto de proyectos en el espacio de trabajo, pudiendo
seleccionar el nmero de revisin que queremos obtener del repositorio.

Ilustracin 33: Realizar el checkout de los proyectos

A continuacin si accedemos a la perspectiva Java, ya dispondramos de los


proyectos en el Explorador de Paquetes para poder trabajar con ellos.

Aadir un proyecto de RSA a SVN


Igual que se puede importar a RSA un proyecto de SVN, tambin se puede
hacer lo contrario: crear un proyecto en un repositorio de SVN desde un proyecto local
de RSA. Para ello se seguirn los siguientes pasos:
En el Explorador de Paquetes, pulsando el botn derecho sobre el proyecto
que queremos exportar, seleccionamos EquipoCompartir proyecto.
Seleccionamos como tipo de repositorio SVN e introducimos una nueva URL
para el repositorio en el que queremos subir el proyecto. Esto nos pedir usuario y
password.

31

Ilustracin 34: Seleccin del repositorio donde subir el proyecto

Aparecer una pantalla que nos permitir seleccionar los archivos del proyecto
que queremos subir as como de incluir un comentario que haga referencia a la subida.

Ilustracin 35: Seleccin de archivos e introduccin de comentario

32

Interfaz hacia SVN desde RSA


Una vez que se dispone de una copia local del proyecto vinculada a un
repositorio, el manejo de svn es directo. Se trabaja con los ficheros del proyecto en
local hasta que se quiera hacer un update para actualizar la copia local o un commit
para subir los cambios. Para tener acceso a las acciones que permite SVN, desde el
Explorador de Paquetes pulsamos el botn derecho sobre el archivo, conjunto de
archivos o el proyecto completo y seleccionamos Equipo. Se nos mostrara un men
con las opciones de la siguiente figura:

Ilustracin 36: Men de opciones de SVN desde RSA

Bsicamente esto es todo lo necesario para poder utilizar SVN desde RSA
mediante el plugin de Subclipse.

33

Das könnte Ihnen auch gefallen