< Anterior | Siguiente >

Lección 8: Jazz Team Builds

Esta sección examina la interfaz de usuario de la construcción de Jazz Team Build desde la perspectiva de un desarrollador que es un consumidor de lo que la construcción de Rational Team Concert ofrece. Sin embargo, para ello es necesario que realice ciertas configuraciones que, normalmente, llevaría a cabo su administrador de construcción o ingeniero de release. Para que la construcción de Jazz Team Build produzca lo que necesita el proyecto, es posible que sea necesario personalizar y adoptar scripts de construcción para satisfacer los requisitos de proyecto. Afortunadamente, con Jazz Team Build es fácil ejecutarla para que pueda ver su funcionamiento exactamente como si estuviera trabajando para su equipo.
Jazz Team Build es un componente fundamental de Rational Team Concert. Por sí solo no puede construir nada, pero proporciona la infraestructura necesaria para recuperar el trabajo de su equipo del repositorio de Rational Team Concert, lo pone a disposición de sus scripts de construcción y envía los resultados de vuelta a Rational Team Concert. Como usuario de Rational Team Concert y consumidor de construcciones, usted puede supervisar construcciones en ejecución y acceder a los resultados. Desde los comienzos de Rational Team Concert, Jazz Team Build se ha utilizado para construir el propio Rational Team Concert.
¿Cómo funciona Jazz Team Build? A grandes rasgos, estas son las tareas que realiza:
  1. Establecer una programación: Cada construcción funciona según una programación que usted establece. En la sección dedicada al control de origen del Rational Team Concert vimos cómo un equipo comparte su trabajo de desarrollo en una o más corrientes de equipo.
  2. Comprobar los cambios: Cuando llega el momento de ejecutar una construcción para un equipo, Jazz Team Build comprueba si hay modificaciones en el contenido de las corrientes del equipo y acepta dichas modificaciones, denominadas conjuntos de cambios, en su propio espacio de trabajo de construcción para contar con una copia actual de las corrientes.
  3. Extraer contenidos del repositorio y ejecutar la construcción: La construcción extrae entonces el contenido del espacio de trabajo de la construcción al sistema de archivos, donde los scripts de construcción ejecutan la construcción.
  4. Publicar artefactos en el repositorio: Los artefactos de la construcción se publican en el repositorio de Rational Team Concert para que los usuarios puedan acceder a ellos.
  5. Informar de la finalización de la construcción: Se informa del estado de todas las construcciones en tiempo real y se le envía automáticamente una notificación cuando la construcción se ha completado.
Jazz Team Build incluye el Jazz Build Engine y el kit de herramientas de construcción de Jazz. Instalarlos y ponerlos en funcionamiento es bastante sencillo. En el Cliente de Jazz, lleve a cabo las siguientes tareas:
  • Defina un script de construcción (deje que Cliente de Jazz de Eclipse haga la mayor parte del trabajo)
  • Defina una definición de construcción que identifique a su script de construcción
  • Defina un motor de construcción para ejecutar la construcción definida
  • Inicie el motor de construcción que responderá a las solicitudes de construcción, ejecutará las construcciones y publicará los resultados
Esto le permitirá solicitar una construcción, analizar los resultados y explorar la interfaz de usuario de la construcción como si fuera un desarrollador y consumidor de lo que produce Jazz Team Build.
Nota: Los pasos de configuración son bastante largos. Si lo desea, puede hacer una pausa ahora y volver más tarde sobre él. Si decide no continuar con la configuración de la construcción, debería leer la siguiente sección titulada Recorrido por la interfaz de usuario de construcción de Jazz Team Build. En ella aprenderá a solicitar construcciones y a analizar los resultados de construcción.

Configuración de un espacio de trabajo de Eclipse para el miembro de equipo de la construcción

En esta guía de aprendizaje, el miembro de equipo que ha creado en una lección anterior es el usuario de construcción dedicado. Configure un espacio de trabajo de Eclipse para el miembro de equipo de la construcción.
Para configurar un espacio de trabajo de Eclipse para el miembro de equipo de la construcción:
  1. Cambie a un nuevo espacio de trabajo de Eclipse.
  2. Cree una conexión al repositorio.
  3. Conéctese al área de proyecto Prelude.
Para obtener más información, consulte el apartado Lección 2: Cómo conectarse.Una vez finalizada la configuración, la vista Artefactos de equipo debe mostrarse del siguiente modo:

crear espacio de trabajo de Eclipse para miembro de equipo

Creación de un script de construcción

Para crear un script de construcción:
Asegúrese de haber definido una conexión al repositorio y de haber iniciado sesión.
  1. En la vista Explorador de paquetes, pulse con el botón derecho sobre un proyecto; a continuación, pulse en Exportar.
  2. En el asistente Exportar, en la página Seleccionar, vaya a General, seleccione Archivos de construcción Ant y pulse en Siguiente.
  3. En la página Exportar, compruebe que su proyecto y todos los recuadros de selección están seleccionados y pulse en Finalizar.
Se añadirá un archivo.xml a su proyecto. Este archivo utiliza el lenguaje de scripts Ant. Este script construye su proyecto y produce archivos de clase Java™. Recuerde que se identifica como un cambio saliente.

build.xml añadido a la vista Explorador de paquetes

Atención: No entregue el script Ant aún.

Creación de un espacio de trabajo de repositorio dedicado

Puede crear un espacio de trabajo de repositorio especializado para que la definición de construcción deJazz lo use en su proyecto. Durante una construcción, el Jazz Build Engine, que se conecta al repositorio Jazz con un identificador de usuario previamente asignado, utiliza el espacio de trabajo de ese repositorio para identificar el contenido que se va a construir. En primer lugar, acepta todo cambio entrante de la corriente del equipo y, seguidamente, carga el contenido del espacio de trabajo de la construcción en el sistema de archivos local para su procesamiento.
Para crear un espacio de trabajo de repositorio dedicado:
  1. En la vista Artefactos de equipo, pulse el botón derecho del ratón en Mis espacios de trabajo de repositorio; a continuación, pulse Nuevo > Espacio de trabajo del repositorio.
  2. En el asistente Espacio de trabajo de repositorio nuevo, en la página Seleccionar una corriente, pulse el botón de selección Flujo con corriente y en el panel situado más abajo, seleccione Corriente de equipo 1 (Equipo 1).
  3. Pulse Siguiente.
  4. En la página Nuevo espacio de trabajo de repositorio, escriba el nombre del espacio de trabajo de construcción Espacio de trabajo de construcción del Equipo 1 y pulse Siguiente.
  5. En la página Permiso de acceso de lectura, asegúrese de que se ha seleccionado Público y pulse Siguiente.
  6. En la página Componentes a añadir, verifique que el componente de la corriente está seleccionado y deseleccione el recuadro de selección Cargar espacio de trabajo del repositorio después de la creación.
  7. Pulse Finalizar. El espacio de trabajo de repositorio de la construcción se mostrará en la vista.

    Espacio de trabajo de repositorio de construcción añadido a la vista Mis espacios de trabajo de repositorio

Creación de una definición de construcción y un motor de construcción

Puede crear una definición de construcción de Jazz para su proyecto. La definición de construcción se configura para utilizar el nuevo espacio de trabajo de construcción, de forma que cuando se ejecute la construcción, pueda aceptar cualquier cambio de la corriente de equipo anterior al inicio de la construcción.
Cómo crear una definición de construcción:
  1. En la vista Artefactos de equipo, expanda la carpeta del proyecto.
  2. Pulse con el botón derecho sobre Construcciones y, seguidamente, pulse en Nueva definición de construcción.
  3. En el asistente Nueva definición de construcción , en la página Nueva definición de construcción, acepte los valores predeterminados y pulse Siguiente.
  4. En la página Información general, en el panel Plantillas de construcción disponibles, seleccione Ant – Jazz Build Engine y pulse Siguiente.
  5. En la página Preconstrucción, seleccione Jazz Source Control y pulse Siguiente.
  6. En la página Postconstrucción, acepte los valores predeterminados y pulse Siguiente.
  7. En la página Configuración adicional, asegúrese de que todas las opciones estén seleccionadas y pulse Finalizar. A continuación, se abrirá el editor de definiciones de construcción.
  8. Cree un motor de construcción para la definición de construcción:
    1. En el panel Motores de construcción de soporte, pulse en Crear motor.
    2. En el cuadro de diálogo Crear motor de construcción, en el campo ID de motor, escriba PreludeBuildEngine.
    3. Pulse Aceptar.
  9. Pulse sobre la pestaña Jazz Source Control del editor de definiciones de construcción.
  10. En el panel Cargar opciones, en el campo Cargar directorio, escriba extraído.
  11. Para especificar un espacio de trabajo de construcción, siga estos pasos:
    1. En el panel Espacio de trabajo de construcción, pulse Seleccionar.
    2. En el recuadro de diálogo Seleccionar una corriente o un espacio de trabajo, en el panel Elementos coincidentes, seleccione Espacio de trabajo de construcción del Equipo 1 y pulse Aceptar.
  12. Pulse sobre la pestaña Ant.
  13. En el campo Archivo de construcción, escriba la siguiente vía de acceso: fetched/projectname/build.xml, donde projectname es el nombre de su proyecto de Java.Para esta guía de aprendizaje, utilizaremos el proyecto HelloWorld.
  14. En el campo Inicio Java, especifique la vía de acceso del archivo de su compilador Java. Por ejemplo, C:\Archivos de programa\IBM\TeamConcert\jdk.
  15. Pulse Guardar.
¡La configuración ha finalizado! Si consulta la vista Artefactos de equipo, verá la definición de construcción y el motor de construcción en la lista.

Definición de construcción y motor de construcción en la vista Artefactos de equipo

Entrega del script de construcción

Antes de iniciar el motor de construcción para ejecutar las construcciones, recuerde que el script de construcción (build.xml) de su proyecto Hello Prelude no se ha entregado a la corriente. Si no lo hace, Jazz Build Engine no dispondrá de las instrucciones necesarias para ejecutar la construcción. Puede entregarlo ahora mismo.
  1. En la vista Cambios pendientes, en Componente predeterminado, pulse con el botón derecho en Sin resolver y, a continuación, seleccione Reincorporar y entregar.

    Vista Cambios pendientes

  2. En el asistente Reincorporar y entregar, en el panel Comentario de conjunto de cambios, escriba un comentario y pulse en Siguiente.
  3. En la página Asociar elemento de trabajo, seleccione un elemento de trabajo existente y pulse Finalizar.
El script de construcción ya está en la corriente. Cuando se ejecute la construcción, el script estará disponible.

Inicio del motor de construcción

Inicie el motor de construcción para estar listo para ejecutar una construcción.
Nota: Cuando inicie el motor de construcción, para asegurarse de que se utilice el Kit de desarrollo de Java (KDJ) correcto, puede especificar el JDK que está incluido en Cliente de Jazz utilizando el argumento de línea de mandatos -vm.

Para iniciar el motor de construcción:
  1. Desde una línea de mandatos, vaya hasta installdir/buildsystem/buildengine/eclipse, donde installdir es el directorio de instalación de Juego de herramientas de sistema de construcciones
  2. Escriba jbe -vm clientinstalldir/jazz/client/eclipse/jdk/bin/java -repository repositoryURL -userId build –pass password -engineId PreludeBuildEngine , donde
    • clientinstalldir es el directorio de instalación de Cliente de Jazz.
    • repositoryURL es el URL de su repositorio. Por ejemplo, http://localhost:9080/jazz/.
    • password es la contraseña del usuario de construcción.
    En esta guía de aprendizaje, el ID de usuario es build y el identificador del motor de construcción es PreludeBuildEngine.
Al iniciarse el motor, en la consola aparece algo similar a esto (es posible que vea además otros mensajes):
2009-06-11 16:08:47 Running build loop...
2009-06-11 16:08:47 Waiting for request...

Al configurar el valor Tiempo de hibernación en 1 (segundo), las peticiones de construcción se procesan inmediatamente.

El motor de construcción está preparado para recibir trabajo. Ha llegado el momento de ejecutar una construcción.

Recorrido por la interfaz de usuario de Jazz Team Build

Conozca las tareas de construcción que puede realizar con Jazz Team Build.

Cliente de Jazz permite realizar las siguientes tareas de construcción:

Veamos ahora cada una de estas tareas por separado.

Solicitud de una construcción

Puede solicitar una construcción desde la vista Artefactos de equipo. Además, puede modificar las propiedades de la construcción o bien solicitar una construcción personal que no afecte al estado de la definición de construcción y que se ejecute en el espacio de trabajo que usted especifique.
Para solicitar una construcción:
  1. En la vista Artefactos de equipo, expanda la carpeta del proyecto.
  2. Expanda a continuación la carpeta Construcciones y localice el nombre de la construcción en la lista.
  3. Pulse con el botón derecho sobre Construcción de Equipo 1 y, a continuación, seleccione Solicitar construcción.
    1. Opcional: Par solicitar una construcción personal que no afecte al estado de la definición de construcción y que se ejecute en el espacio de trabajo de repositorio que usted especifique, en el panelOpciones de construcción, seleccione Construcción personal. Si fuera necesario, actualice los campos Espacio de trabajo de repositorio y Reglas de carga de componentes.
  4. En el cuadro de diálogo Solicitar construcción, pulse Someter.
El motor de construcción procesa la solicitud de construcción. Podrá observar este proceso en la ventana de mandatos donde ha iniciado el motor de construcción.

Si la construcción no se ha ejecutado correctamente, examine el archivo de anotaciones publicado en el resultado de la construcción.

Visualización de los resultados de construcción

Abra el resultado de construcción para ver qué ha sucedido.
El editor de resultado de la construcción consta de las pestañas Visión general, Anotaciones y Propiedades. Podrá ver pestañas adicionales en función del script de construcción que contribuya al resultado de la construcción. Por ejemplo, si la contribución del script de construcción son resultados de compilación y descargas, el editor de resultados de construcción incluirá las pestañas Compilación y Descargas.

Ha completado las siguientes tareas:

  1. Ha enviado una solicitud de construcción. También podría haberse programado para que se iniciara automáticamente a una hora determinada.
  2. La solicitud se ha recibido por Jazz Build Engine junto con la definición de construcción.
  3. Con un espacio de trabajo de construcción configurado en la definición de construcción (Espacio de trabajo de construcción del Equipo 1), Jazz Build Engine ha realizado una operación de aceptar para actualizar el espacio de trabajo de la construcción desde la corriente. En la primera construcción, transfirió el script de construcción recién creado (build.xml) al espacio de trabajo de la construcción, algo esencial para ejecutar una construcción.
  4. Los contenidos del espacio de trabajo de la construcción actualizados se habían cargado en el sistema de archivos, en el directorio denominado extraído de la definición de construcción.
  5. Se llama al script de construcción especificado en la definición de construcción. El script compiló el proyecto HelloWorld y creó archivos de clase Java. Un script más sofisticado hubiera creado un archivo JAR y lo hubiera publicado en Jazz.
  6. Cuando se completa el script, el archivo de anotaciones de construcción y demás resultados publicados se almacenan en Jazz.
  7. Finalmente, se informa al equipo de que la construcción ha finalizado.

Editor de resultados de construcción

En el editor de resultados de construcción se puede modificar la siguiente información:

Análisis del archivo de anotaciones de construcción

Vamos a examinar el archivo de anotaciones de construcción para comprobar si su nueva construcción ha funcionado.
  1. Vaya a la página Anotaciones. Veamos cómo ha resultado la construcción.

    Página Anotaciones

  2. Seleccione el archivo de anotaciones y pulse Abrir. Puede ver las actividades más importantes que han tenido lugar.

    Archivo de anotaciones de construcción de ejemplo

    Puede comprobar cómo Jazz hace que la información relativa a la construcción sea muy visible para usted y para su equipo.

Supervisión del estado de las construcciones

El estado de la construcción puede obtenerse de forma activa o pasiva. La información de construcción pasiva se proporciona de dos maneras: en la vista Central de equipo, sección Construcción, y alertas de construcción que aparecen brevemente en la pantalla.

Al finalizar la construcción, en la vista Central de equipo, la sección Construcción se actualiza con el estado de las construcciones finalizadas para el equipo o los equipos en los que participa.

Puede ver los resultados de la construcción seleccionada o bien solicitar una nueva construcción.

Para personalizar la frecuencia con la que se actualiza el estado:

Búsqueda de las construcciones disponibles

Puede ver qué construcciones están disponibles, el estado de las construcciones en ejecución y las construcciones que están en cola para ejecutarse en la vista Construcciones, a la que se puede acceder utilizando el menú contextual Mostrar resultados de construcción de la carpeta Construcciones de la vista Artefactos de equipo.

Elemento Mostrar resultados de construcción

El contenido de la vista puede ordenarse con solo seleccionar una columna. Hay varias acciones de menú de contexto interesantes. Puede comparar una construcción con la corriente desde la cual se construyó o crear una nueva corriente a partir de una construcción (útil para crear una base de código nueva a partir de una ya probada).

Vista Resultados de construcción

También puede ver resultados de construcción definiendo una viewlet de construcción en el panel de instrumentos de Jazz basado en web:

Resultados de construcción de panel de instrumentos de Jazz basado en Web

El equipo de desarrollo de Jazz ha estado trabajando en la personalización de su proceso de construcción durante un tiempo. El editor de resultados de construcción de Jazz consta de una serie de pestañas adicionales con la etiqueta Compilación, JUnit, y Descargas, así como Enlaces externos. Este es una captura de pantalla de una construcción de Jazz en la que puede comprobar las posibilidades que ofrece.

Resultados de construcción personalizados de ejemplo

Punto de comprobación de la lección

En esta lección ha aprendido los conceptos básicos de la funcionalidad Jazz Team Build.
< Anterior | Siguiente >

Comentarios

¿Le ha servido de ayuda? Puede incluir sus comentarios en Jazz.net (registro obligatorio): Comentarios en el foro o envíe un error