Manual de Altas, Listas y TortoiseSVN

ALTAS, LISTAS Y TORTOISESVN

MANUAL TÉCNICO

JOSÉ ANTONIO SALES ESTEBAN - 2.010

LLODER GROUP S.L.

USO DEL PROGRAMA ALTAS, PROGRAMA LISTAS Y DEL CLIENTE DE SUBVERSIÓN PARA WINDOWS "TORTOISESVN"

Alta de directorios en el repositorio, uso de "altas"

1. Iniciar la aplicación Putty

2. Introducir la ip del servidor PROLIANT en el apartado "Host name" -generalmente 192.168.1.3- y además seleccionar en "Connection type" SSH. Es muy recomendable seleccionar en "Translation" que la aplicación trabaje con la codificación UTF-8, para poder ver correctamente todos los mensajes que nos comunique el servidor.

Una vez esté todo configurado correctamente, procederemos a cliquear sobre el botón "open" y

2

Lloder Group S.L. · C/General Pastor, 25 piso 3 puerta 8 · 46183 · L’Eliana (Valencia) · Telf: 96 272 51 09 · Fax: 96 272 51 09


automáticamente se abrirá una consola desde la cual podremos operar en remoto.

3



3. Nada más abrirse la consola el servidor nos pedirá usuario y contraseña.

Introduciremos el usuario llodergroup cuando aparezca "login as".

Y a continuación nos pedirá la contraseña, que introduciremos y pulsaremos sobre el botón enter.

Y si todo ha ido correctamente deberemos observar lo siguiente:

4



4. Una vez logueados correctamente podemos introducir dos comandos en el prompt para la gestión de los repositorios, que son altas y listas. Vamos a ver que hace altas y más abajo veremos lo que hace listas.

El comando altas ha sido programado para poder efectuar el alta de un encargo en el repositorio de subversión (svn) para el control de versiones de los archivos.

Datos necesarios a conocer para efectuar el alta correctamente:

- Contraseña de superusuario

- Nº de cliente

- Tipo de encargo

Cabe mencionar que el comando listas lleva una llamada en el código al comando listas porque tal vez sea necesario listar los repositorios existentes una vez dado de alta el nuevo y actualizar así la lista de estos.

Ejecutamos el comando:

$ altas (enter)

5



5. En este punto se ejecutará la aplicación donde tendremos que introducir los datos que nos vaya pidiendo hasta que aparezca el mensaje de que la operación se ha efectuado correctamente y vuelva a aparecer el prompt ( $ ).

6



7



Cada vez que damos de alta un repositorio, se crea un archivo en la carpeta /media/3fa94484-8aaa-4e62-9386-760a89d1a4c9/repo_log/, que tiene la siguiente forma:

Y su contenido es:

Con lo que nos muestra el nombre de los repositorios disponibles en el momento del alta.

Como se observa en la figura anterior, no es posible que exista duplicidad en el nombre de los directorios raíces de los repositorios ya que la aplicación genera tres caracteres autonúmericos, lo cual garantiza que no puedan existir en un momento dado dos repositorios con el mismo nombre.

8



Impresión del listado de repositorios, uso de "listas".

Listas es un programa muy sencillo, que básicamente, lo que hace es hacer un listado en local del directorio donde se almacena toda la información de los diferentes repositorios existentes y genera un archivo donde se almacenan los nombres de estos y a petición del usuario lo imprime o no.

Inicialmente está concebido para que muestre la información sólo a través de la impresora, pero esto en un futuro puede cambiar.

Para ejecutar listas basta con teclear en el prompt:

$ listas

Y automáticamente se ejecutará el programa:

Como se observa, en caso de denegar la petición de impresión de la lista, no muestra ninguna información.

En un futuro es posible que se le añada la opción de listar en pantalla, pero a día de hoy creemos que no es conveniente.

9



Ya sé que repositorios tengo dados de alta, pero ¿y qué hago yo con esto? ¿cómo trabajo con ello?

Para resolver esta cuestión, deberíamos pegarle una ojeada al manual de tortoiseSVN, pero vamos a intentar simplificar las tres o cuatro ideas más básicas para empezar a trabajar.

En este punto del manual conviene introducir el concepto de "revisión" y de "repositorio".

Revisión es el número que se le asigna a un archivo cuando se efectúa sobre él un cambio o modificación, ya sea de carácter "físico" (subir al repositorio) o de la información que contiene.

Repositorio es directorio remoto, alojado en el servidor, que almacena los cambios que hacemos en nuestra copia de trabajo (se describe más adelante) situada en nuestro ordenador. Es como si fuese un saco donde vamos metiendo todo lo que hacemos

Los repositorios, por su naturaleza, automáticamente se crean con tres carpetas:

- trunk: es el "tronco", es la carpeta donde se almacena todo el proyecto, y a partir de él, se crean, si es necesario, las ramas (branches)

- branches: son las ramas que salen del tronco, permiten el desarrollo de alguna parte del proyecto de manera independiente al desarrollo que se hace de la misma parte en el tronco. Ejemplo:

Tras una comunicación de parte del organismo competente, hay que cambiar gran parte un proyecto, e implica a todas sus partes, memoria, anejos, planos, pliego y presupuesto, con lo que básicamente hay que rehacerlo entero prácticamente. Pero como ocurre comúnmente, el cliente ya ha empezado a ejecutarlo y necesita una corrección en el plano de ferrallado del elemento constructivo sobre el que se hizo el proyecto. Pues bien, para esto, se podría crear una rama en la revisión que nos interesara, y modificar el plano de ferralla para satisfacer las necesidades de nuestro cliente sin afectar a priori, al desarrollo de los cambios de las correcciones del proyecto efectuadas por el organismo competente.

En caso de interesar plasmar este resultado en el proyecto se pueden reintroducir las ramas en el tronco de forma que los resultados son visibles.

10



- tags: podemos asemejarlo con la poda de un árbol. Tras un tiempo x trabajando en el proyecto, puede ser que se llegue al momento de tener que presentar una copia para su visado. En este caso, lo que hacen los tags, es establecer una relación de archivos y revisión en del momento en que lo efectuamos, para volver así de una forma fácil y sencilla a ese estado del proyecto de forma conjunta y no teniendo que ir archivo a archivo buscando la revisión oportuna para el estado anterior.

En la siguiente figura, las líneas rojas discontinuas, corresponderían a los tags, mientras que el trunk (tronco) sería el rectángulo central, desde el cual aparecen las branches (ramas)

Como se observa, es posible que ciertas ramas no aparezcan en la tag generada como es el caso de la rama de "anejo 5" y "plano ferralla" que no son cortadas por la tag "presentación visado".

11



Una vez introducidos estos conceptos básicos, intentaremos entrar en explicar las operaciones de día a día que vamos a ir efectuando.

Para ello, introduciremos el concepto de "carpeta de trabajo".

La filosofía de subversión (que es el programa de control de versiones) es que para trabajar sobre un proyecto en primer lugar hay que sincronizar un repositorio situado en un ordenador remoto (podría darse el caso de que fuese local) con una carpeta de trabajo, donde efectuaremos las modificaciones convenientes sobre los archivos del proyecto.

Por tanto, la primera operación que vamos a emplear es la que denominaremos "update" o llamada al repositorio.

Para ello efectuaremos las siguientes operaciones:

1. Creamos la carpeta de trabajo que puede ser cualquier carpeta y puede estar en cualquier directorio.

2. Con el botón derecho del ratón sobre esta carpeta, pulsaremos sobre "navegador de repositorios", para seleccionar el repositorio que contiene el trabajo que queremos sincronizar. Ahora bien, este paso no es obligado ya que si queremos sincronizar directamente podemos pasar al paso 3, pero este paso viene bien para explicar el funcionamiento de los repositorios.

12



Una vez hecho el paso 2 nos aparece esta ventana:

Primeramente introducimos la dirección IP del servidor, que normalmente será 192.168.1.3 y ahora es cuando viene el paso esencial.

Si queremos ver que contiene este repositorio:

Agregamos después de la barra el nombre del repositorio, de la siguiente forma:

Pulsamos en Aceptar y aparece en la pantalla una ventana que nos permitirá ver que contiene el repositorio:

13



Este paso, aunque no es necesario para trabajar con el proyecto, si que nos puede proporcionar valiosa información sobre éste ya que nos permitirá acceder al historial de revisiones, al gráfico de proyecto y aun montón de útiles más:

14



15



Perfecto, ya sé acceder al repositorio, ¿Como empiezo a trabajar?

La recomendación que hacemos es, una vez creado tu directorio local de trabajo, donde vas a mantener tus archivos de trabajo, créate una carpeta con el nombre que te ayude a encontrar luego la información de este repositorio. No es necesario, que esta carpeta tenga el mismo nombre, aunque si lo tiene, estaremos trabajando en una estructura de trabajo más normalizada. Por ello:

- Creamos una carpeta con el nombre del repositorio que queramos sincronizar con nuestro ordenador, en este caso 00600pruebaDO, dentro de nuestra carpeta de trabajo:

- Con el botón derecho del ratón sobre la carpeta que hemos creado pulsamos en SVN Obtener:

16



Entonces aparecerá la siguiente pantalla:

17



Para empezar a trabajar con el proyecto podemos seleccionar las opciones que aparecen, totalmente recursivo y revisión Head.

Vamos a explicarlas de una forma más detallada.

La profundidad de obtención indica qué tipo de transferencia queremos que se haga:

Totalmente recursivo: Obtener el árbol entero, incluyendo todas las carpetas hijas y subcarpetas.

Hijos inmediatos, incluyendo carpetas: Obtener el directorio especificado, incluyendo todos los ficheros y carpetas hijas, pero no rellenar las carpetas hijas.

Sólo los ficheros hijos: Obtener la carpeta especificada, incluyendo todos los ficheros pero no obtener ninguna carpeta hija.

Sólo este ítem: Obtener sólo el directorio. No rellenarlo con ficheros ni carpetas hijas.

Copia de trabajo: Retiene la profundidad especificada en la copia de trabajo. Esta opción no se utiliza en el diálogo obtener, pero es el valor por defecto para todos los demás diálogos que tengan opción de profundidad.

Excluir: Utilizado para reducir la profundidad de una copia de trabajo después de que una carpeta haya sido rellenada. Esta opción sólo está disponible en el diálogo Actualizar a la revisión.

Y en el selector de opciones de revisión elegiremos si queremos sincronizar el proyecto entero desde su desarrollo desde 0 -REVISIÓN HEAD- o por el contrario si queremos sincronizarlo en alguna revisión en concreto, donde podremos consultar el registro de revisiones pulsando sobre "MOSTRAR REGISTRO" para seleccionar la revisión indicada.

Si pulsamos ACEPTAR, sincronizaremos nuestra carpeta de trabajo con el repositorio, y si pulsamos CANCELAR no hará nada.

18



EJEMPLO PRÁCTICO:

Vamos a sincronizar la revisión HEAD con profundidad TOTALMENTE RECURSIVO del repositorio:

Tras efectuar la operación con los datos anteriormente descritos aparecerá esta pantalla:

Que nos informa de que se han añadido correctamente tres elementos, en este caso las carpetas trunk, branches y tags, con lo que ya podemos empezar a trabajar.

Como se puede observar no nos ha detectado ningún error en la transferencia.

Ahora trabajaríamos en la carpeta trunk con los archivos necesarios para desarrollar el encargo.

19



He desarrollado tres archivos y ya he terminado con el encargo ¿Ahora qué hago?

Bien, una vez finalizado el periodo de trabajo con un determinado archivo, o incluso a final de la jornada haremos lo siguiente.

Supongamos que tenemos estos tres archivos dentro de la carpeta trunk del encargo 00600pruebaDO que estamos usando a modo de ejemplo:

El icono:

Indica que se ha usado la opción "SVN Copiar y Añadir a esta copia de trabajo" que aparece en el menú contextual al arrastrar con el botón derecho del ratón archivos dentro de cualquier carpeta de trabajo:

20



Si observamos las carpetas muestran esta imagen:

Los iconos que aparecen muestran que la carpeta branches está actualizada debido a que no hemos realizado cambios en ella. Igual estado tiene la carpeta tags y por el contrario, el símbolo rojo de admiración de la carpeta trunk indica que tiene cambios y que no han sido transmitidos al repositorio.

Tras ver los estados que aparecen -Consultad el anejo de estados para ver otros tipos de iconos que nos podemos encontrar- vamos a ver como transmitimos esta información al repositorio:

1- En la carpeta de trabajo (00600pruebaDO) pulsamos con el botón derecho del ratón y aparecerá el menú contextual:

+

Veámoslo más de cerca:

21



2- Clic en "SVN Confirmar...", y aparecerá la ventana, donde tendremos que completar en el campo de "Mensaje" con la información alusiva a los cambios que hemos realizado sobre los archivos que queremos sincronizar o "Confirmar" con el repositorio.

En la página siguiente aparece una ilustración a modo de ejemplo.

22



Pulsamos en Aceptar y aparecerá una ventana que nos preguntará el usuario y la contraseña para confirmar en el repositorio:

23



Los introducimos correctamente y aceptamos y:

Aparecerá una ventana informando de que se ha enviado el contenido correctamente y del número de revisión.

Quiero consultar el historial de un encargo ¿Como lo hago?

El historial es muy práctico para recordar porque en un momento determinado se hizo un cambio en el encargo, posiblemente precedido por una serie de acontecimientos que no recordamos, por ello se considera como una herramienta indispensable y muy valiosa para el seguimiento del encargo.

24



En primer lugar abriremos el menú contextual de tortoiseSVN con el botón derecho y entraremos en el submenú "TortoiseSVN" que muestra las siguientes opciones que se muestran en la imagen de la derecha.

Después bastará con pulsar en mostrar registro y a continuación se abrirá en la pantalla la ventana que muestra el historial.

Se puede apreciar que nos muestra toda la información relativa al encargo, los mensajes de revisión que hemos puesto, el número de revisión, el autor de la revisión, fecha y hora,...

Quiero hacer el desarrollo de un archivo paralelo al del tronco, ¿Como lo hago? INTRODUCCIÓN A LOS BRANCHES O RAMAS.

Vamos a hacer el branches del desarrollo del archivo 2010DO0117 ALEG para firmar.doc

25



Análogamente al punto anterior volvemos al menú contextual de TortoiseSVN (Nuestro día a día), pero esta vez clicaremos en el apartado "Rama/Etiqueta".

Ahora seleccionamos la URL donde queremos abrir el branch pulsando el

botón , y aparecerá la siguiente ventana:

26



Entonces hacemos clic donde indica la flecha roja para ver el directorio padre de trunk:

Hacemos clic en branches y pulsamos en Aceptar para volver a la ventana de creación del branch:

27



Ahora detrás de ../branches/ ponemos el nombre de la carpeta que contendrá a la rama, en este caso, pondremos "EscritoDO0117/". Además incorporamos la información referente a la apertura de la rama en el mensaje:

28



Pulsamos en Aceptar, introducimos nuestros datos identificatorios y aparece la siguiente ventana:

29



NOTAS IMPORTANTES:

- ES MUY IMPORTANTE QUE CUANDO HACEMOS EL PASO DE PONER LA RUTA DONDE SE CREARÁ LA RAMA, NO EXISTA EL DIRECTORIO, SINO DEVOLVERÁ UN ERROR.

- SI QUEREMOS MODIFICAR EL ARCHIVO Y NO DESEAMOS QUE A PRIORI ESTAS MODIFICACIONES REPERCUTAN SOBRE EL TRUNK (TRONCO) DEBEMOS SELECCIONAR LA OPCIÓN DE:

- SI NO HACEMOS ESTE PASO, LOS CAMBIOS SE CONTINUARÁN VIENDO EN EL TRUNK.

- PODEMOS CAMBIAR A POSTERIORI LOS ARCHIVOS A LA RAMA SI NOS OLVIDAMOS DE SELECCIONAR LA CASILLA. A CONTINUACIÓN VEREMOS COMO.

30



He creado una rama (branch) pero se me ha olvidado activar la casilla de cambiar la copia de trabajo a la nueva rama. ¿Qué hago?

En primer lugar, es posible que nos demos cuenta de ello cuando creemos la rama porque en el mensaje que nos devolverá TortoiseSVN nos advertirá sobre ello:

Y como bien nos advierte, debemos usar el comando Cambiar para resolver este problema. Vamos a ello:

En primer lugar, clic derecho sobre el archivo que queremos cambiar y entramos en el submenú de TortoiseSVN como ya sabemos.

Si nos fijamos, justo debajo del comando "Rama/Etiqueta", aparece "Cambiar". Clicamos en él.

Nos aparecerá esta ventana:

Clicamos en y buscamos la ruta donde

hemos creado la rama anteriormente ../branches/EscritoDO0117

31



Y por si acaso, revisamos que nos copie la revisión que queremos comprobando primero en "Mostrar registro". Una vez esté todo correcto, clicamos en aceptar y nos debe aparecer la ventana que nos indica que se ha efectuado la operación correctamente:

Oooops! Hay un conflicto! Horror! ¿Qué hago?

Si nos aparece algún mensaje de que algún archivo ha entrado en conflicto deberemos resolverlo manualmente debido a que el programa no sabe a priori cuando dos partes han sido modificadas cual es la buena.

Generalmente aparecerá un icono con una admiración cuando esto ocurra, sobre la carpeta de trabajo y sobre el fichero que tiene el conflicto, para que lo identifiquemos correctamente:

32



33



Si hacemos clic derecho sobre el icono que tiene el conflicto y entramos en el menú de TortoiseSVN vemos que se reducen las opciones seleccionables:

En primer lugar clicaremos en Diff, que nos mostrará las diferencias entre los archivos en conflicto, en este caso las dos versiones creadas del archivo "Escrito Alegación DO0117.doc":

34



Una vez detectadas las diferencias deberemos ver en que archivo están correctamente, en el revisado o en el original -generalmente en el revisado".

Una vez vistas las diferencias, seleccionaremos la opción de "Editar conflicto" y nos mostrará una ventana con el conflicto detectado y diversas opciones para solucionarlo, en el caso que nos ocupa, nos pide la eliminación o conservación de un archivo:

En este caso, seleccionaremos la opción de mantener el fichero local.

Tras ello, abriremos el menú contextual de TortoiseSVN en cualquier lugar de la carpeta de trabajo y seleccionaremos la opción de "Resuelto..."

Con lo cual confirmaremos que hemos editado los conflictos y el programa aceptara el cambio como bueno.

35



Ahora solo queda confirmar el cambio en el repositorio y ya tendremos todo en orden:

36



Vale, llevo dos semanas peleándome con TortoiseSVN y por fin he podido acabar un encargo. ¿Cómo dejo una copia definitiva, para volver a ella en un momento dado? INTRODUCCIÓN A LOS TAGS

Para esto se usan los tags, que son, siguiendo con la analogía de los árboles, una línea de poda por donde cortamos las ramas y el trunk en un momento dado.

En este caso, nos encontramos ante un ejemplo donde tenemos un trabajo "terminado" y queremos dejar una copia.

Para ello, la forma más sencilla es:

1. Menú Contextual de TortoiseSVN

2. Clic en Mostrar Registro

37



3. Clic derecho sobre la última revisión del registro

4. Crear Rama/Etiqueta

5. Ponemos en nuestro caso en la URL de destino:

http://192.168.1.3/00600pruebaDO/tags/20100721 Copia Definitiva/

Nótese que dejaremos copia de los archivos porque tenemos la casilla activada.

6. Aceptamos, nos identificamos y ya está creada la etiqueta.

OPCIONAL: Para ver reflejado esto en nuestra copia de trabajo solo tenemos que actualizar con SVN Actualizar, en el menú contextual.

OJO! Nadie nos prohíbe editar un archivo de un tag, pero no es recomendable porque no se hace un tag para ese concepto.

38



39



CRASH! Horror! Quiero deshacer los cambios efectuados!

No pasa nada, para ello tenemos el comando "Revertir" en el menú contextual de TortoiseSVN que nos deshará los últimos cambios realizados sobre este archivo, y en el caso de que queramos volver a un estado anterior siempre podemos abrir un branch de ese archivo en la revisión que nos interese para volverlo a volcar sobre el trunk en un momento dado.

NOTAS DE INTERÉS

Nótese que un tag y un branch en realidad es casi lo mismo por lo que se puede usar este método alternativo que hemos expuesto en el punto de introducción a los tags para crear branches también.

40



ANEJO 1 - ICONOS Y SIGNIFICADO:

41



ANEJO 2 - GUIAS COMPLETAS

La presente guía solo es un "manual de campaña" del uso de la aplicación TortoiseSVN en nuestra empresa. Si en algún momento surgiera alguna duda que no puede ser resuelta por este manual podemos visitar el siguiente enlace donde está redactado el manual de TortoiseSVN:

http://tortoisesvn.net/docs/release/TortoiseSVN_es/index.html

http://ovh.dl.sourceforge.net/project/tortoisesvn/Documentation/1.6.10/TortoiseSVN-1.6.10-es.pdf

42


Manual de Altas, Listas y TortoiseSVN

Documents