BAZAAR LA HERRAMIENTA DE CONTROL DE VERSIONES DISTRIBUIDA

1. INTRODUCCIN
Cuando realizamos un proyecto software es bastante habitual que vayamos haciendo pruebas, modificando nuestros fuentes continuamente, aadiendo funcionalidades, etc. Muchas veces, antes de abordar un cambio importante que requiera tocar mucho cdigo nos puede interesar guardarnos una versin de los fuentes que tenemos en ese momento, de forma que guardamos una versin que sabemos que funciona y abordamos, por separado, los cambios. Si no usamos ningn tipo de herramienta que nos ayude a hacer esto, lo ms socorrido es directamente hacer una copia de los fuentes en un directorio separado. Luego empezamos a tocar. Pero esta no es la mejor forma. Hay herramientas, los sistemas de control de versiones, que nos ayudan a guardar las distintas versiones de los fuentes de una forma mejor. Con un sistema de control de versiones hay un directorio, controlado por esta herramienta, donde se van guardando los fuentes de nuestro proyecto con todas sus versiones. Usando esta herramienta, nosotros sacamos una copia de los fuentes en un directorio de trabajo, ah hacemos todos los cambios que queramos y, cuando funcionen, le decimos al sistema de control de versiones que nos guarde la nueva versin. El sistema de control de versiones suele pedirnos que metamos un comentario cada vez que queremos guardar fuentes nuevos o modificados. Tambin, con esta herramienta, podemos obtener fcilmente cualquiera de las versiones de nuestros fuentes, ver los comentarios que pusimos en su momento e incluso comparar distintas versiones de un mismo fuente para ver qu lneas hemos modificado. Una de estas herramientas es Bazaar y es la que veremos a lo largo de este documento.

Adaptable: Orientado a la mayora de los trabajos de desarrollo de software (local y/o remoto). Amigable: Orientado principalmente apersonas que recin empiezan a hacer uso de este tipo de herramientas, enfocado principalmente a la usabilidad y eficiencia. Elegante: Soporta el renombrado de archivos y directorios Rpido: Permite obtener rpidamente sus ventajas y caractersticas sin afectar al proceso de desarrollo. Eficiente: Su almacenaje utiliza un formato altamente eficiente y limpio. Ligero: No precisa tener un servidor dedicado Extensible: Posee una arquitectura basada en plugins, aspecto que permite dotarle de mayores caractersticas especficas y acorde a cada necesidad. Embebido: Caracterstica que le permite estar presente en una serie de aplicaciones y servicios libres y/o comerciales. Seguro: Al margen de las caractersticas que posee por s mismo, cuenta con el patrocinio de Canonical tanto para su desarrollo como para su suporte Libre: Disponible bajo licencia GPL

3. DESCRIPCION DEL PROCESO DE INSTALACION Y CONFIGURACION 3.1 Instalacin

Para instalar Bazaar en Windows seguimos los siguientes pasos: Primeo tenemos que descargar el instalador de [1]. Luego que tenemos el instalador descargado en nuestro equipo lo siguiente que debemos hacer es ejecutarlo y se nos mostrara el asistente de instalacin:

2. CARACTERSTICAS DE BAZAAR
Bazaar es un sistema de control de versiones distribuido, de origen open source. Bazaar est enteramente escrito en Python. Funciona en mltiples Sistemas Operativos: Linux, MS Windows, Mac OS X, etc. Puede publicar repositorios usando HTTP, FTP, SFTP o WebDAV (HTTP), as como usando un servidor dedicado (el cual puedes usar SSH). Tiene un API para integracin con otras herramientas, como aplicativos para el control de pruebas de cdigo, sistemas de gestin de defectos, etc.

Figura 3. Paso 3 para instalar Bazaar. Figura 1. Paso 1 para instalar Bazaar. Damos clic en siguiente: Luego se nos nuestra la pantalla con informacin de la licencia de Bazaar, pulsamos en siguiente. Si es tu primera experiencia con Bazaar se recomienda instalar los componentes que por defecto vienen configurados en una instalacin tpica y pulsar en siguiente.

Figura 2. Paso 2 para instalar Bazaar. En la siguiente pantalla se nos preguntara por el directorio donde queremos instalar Bazaar, podemos cambiarlo o dejar el que viene por defecto y pulsar siguiente.

Figura 4. Paso 4 para instalar Bazaar. Luego se nos preguntar donde queremos poner el acceso directo a Bazaar, elegimos la ubicacin o dejamos la que viene por defecto y pulsamos en siguiente.

Figura 5. Paso 5 para instalar Bazaar. En la siguiente pantalla podemos seleccionar las tareas adicionales que se puede realizar mientras termina la instalacin. Dejamos las por defecto y pulsamos en siguiente.

3.2 Configuracin
Para configurar Bazaar procedemos a hacer lo siguiente: Iniciamos Bazaar.

Figura 7. Paso 1 para configurar Bazaar. Vamos a Settings|Configuration|User Configuration para configurar el nombre de usuario y el email: Figura 6. Paso 6 para instalar Bazaar. Luego ya podemos hacer clic en instalar y el asistente comenzara a instalar Bazaar en su equipo, cuando termine hacemos clic en finalizar.

Figura 8 Paso 2 para configurar Bazaar.

Configurar la integracin de seguimiento de errores de la siguiente manera:

Figura 9 Paso 3 para configurar Bazaar. Para configurar [2] como herramienta de Merge, lo configuramos en el mismo Windows. Para nuevas versiones de Bazaar (a partir de 1.2.2 en adelante) agrega nuevas herramientas de merge con el siguiente comando: "C:\Program Files (x86)\KDiff3\kdiff3.exe" {base} {this} {other} -o {result}) Figura 11 Crear un proyecto en Bazaar.

Una vez seleccionada la carpeta se tiene 5 opciones de proyecto: - Feature branchs: Crea un repositorio compartido en el directorio seleccionado y crea la rama principal (trunk) - Shared tree: Crea un repositorio compartido, crea la rama principal (trunk) y un rbol de trabajo separado. - Plain branchs: Crea una rama plana en el directorio seleccionado, si es parte (o est adentro) de un repositorio compartido (Shared repository) las revisiones sern almacenadas all, de lo contrario (no est dentro de un repositorio compartido) las revisiones se almacenan en la rama - Shared repository: Crea un repositorio compartido en el directorio seleccionado. Las ramas creadas dentro de este repositorio se usaran para almacenar las revisiones. - Shared repo with treeless branch: Crea un repositorio compartido en el directorio seleccionado, configura al repositorio y sus ramas crean das sin un rbol de trabajo. Los repositorios en los servidores suelen estar configurados de esta manera.

Figura 10 Paso 3 para configurar Bazaar.

4. EXPLICACIN DEL MANEJO DE LAS FUNCIONES 4.1 Crear Proyecto

En la tercera pestaa ("Iniciar nuevo proyecto") permite seleccionar la carpeta donde estar la carpeta principal ("trunk") del proyecto.

Se mostraran todos los archivos "sin versionar" y hay que aadirlos a la rama principal.

Figura 14 Ramas sin versionar. Figura 12 Inicializar proyecto bazaar.

4.1. Cual elegir?

Segn la documentacin de bazaar "Para la mayora de los proyectos pequeos y medianos, se recomienda el modelo de Feature branchs. Para los proyectos grandes (como GIT) se prefiere a menudo el modelo Shared tree.

4.2 Administrando el proyecto

Hay que copiar el cdigo (si es que existe) dentro de la carpeta trunk. Bazaar explorer abrir un nuevo tab con el nombre del directorio seleccionado, se debe cerrar esta y entrar a la cuarta pestaa ("Abrir una ubicacin existente") seleccionando la carpeta trunk.

Figura 15 Aadir ramas. Hay que hacer la primera revisin (commit) se puede hacer de forma automtica seleccionando la flecha verde que est en la parte inferior de la pantalla.

Figura 13 Administrar el proyecto.

Figura 16 Hacer commit. Ahora ya se tiene el proyecto listo controlar los cambios en el cdigo de forma ordenada. Para crear nuestra propia branch en caso de que estemos trabajando en un repositorio remoto, debemos registrarnos primero en [3], luego: Usted necesita decirle a su instalacin local de bazar tu nombre de usuario de Launchpad. Esto se puede hacer en el Bazaar Explorer: Menu Bazaar / All Commands. The 'Run bzr command' Dialog will be opened (ver la imagen de abajo)."Directorio de trabajo" puede ser cualquier directorio vlido, no importa. Seleccionar Categora "launchpad" Seleccione Comando 'launchpad-login'. Introduzca su ID de plataforma de lanzamiento en 'Opciones y argumentos para el comando' Haga clic en 'Aceptar'. Este proceso slo es necesario hacerlo una vez.

Figura 17 Crear nuestras propias branch.

Para crear un repositorio local Slo necesita hacer esto una vez. Ahora debe configurar un directorio donde almacenar todas las branches. Ir a "Inicio de un nuevo proyecto" y haga clic en "Initialize". Asegrese de seleccionar las opciones de " Shared repository" y marcar las opciones " Create parent directories of location, if required" y " Branches in the repository will default to not having a working tree". En el ejemplo siguiente hemos elegido el directorio <Mis documentos> / openpetra / bzr /. Sin embargo, Especialmente cuando se utiliza Windows 7, se recomienda crear el repositorio en un directorio local (por ejemplo, C: \ openpetraorg \) y no uno en la red como por lo dems se compila con Nant puede dar problemas. Compilar desde una unidad de red dio el siguiente error en Windows 7: System.Security.SecurityException: Request for the permission of type 'System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.0.0, Mediante el uso de un directorio, cerca de la raz de una unidad local (por ejemplo C: \ openpetraorg \) que son menos propensos a tener problemas con las combinaciones de ruta + archivos superiores a 250 caracteres, lo que es un lmite fsico en los sistemas operativos Windows.

Puede usarse en solitario, as como en grupos pequeos o grandes ya sea colaborando en forma distribuido como centralizada. Permite el recuperarse fcilmente de errores, desde el borrar algo por equivocacin, hasta el haber registrado incorrectamente algo. Manejar versiones puede ser complicado, pero Bazaar provee las herramientas para hacerlo sencillo. Bazaar es independiente de la plataforma y de que contienen los archivos. Su utilidad es universal.

6. REFERENCIAS
[1] Bazaar WebSite http://wiki.bazaar.canonical.com/WindowsDownloads [2] KDiff3 - Home (http://kdiff3.sourceforge.net/) http://doc.bazaar.canonical.com/en/ http://www.slideshare.net/estebansaavedra/bazaar-laherramienta-para-el-control-de-versiones-de-formadistribuida Figura 18 Crear repositorio local. http://doc.bazaar.canonical.com/explorer/en/ [3] Collaboration platform https://launchpad.net/

5. Conclusiones

Bazaar es un VCS que permite el manejo simple y robusto de rboles de directorios y archivos.