Rational Build Forge y Rational ClearQuest

BuildForge puede trabajar con Rational ClearQuest para actualizar registros de compilación.

Build Forge tiene dos integraciones con ClearQuest:

Estas prestaciones son completamente independientes entre sí. Concretamente, el adaptador está asociado a un entorno creado para él. Las variables de dicho entorno son independientes de las variables establecidas para activar registros de compilación automáticos.

Configuración de generación automática de registros de compilación

El sistema puede crear automáticamente registros de compilación en su base de datos IBM Rational® ClearQuest®, con enlaces a los datos de registro. Además, cuando un trabajo termina con éxito, el sistema puede actualizar la base de datos ClearQuest, registrando que el trabajo ha sido completado, la hora de finalización y un resumen de los pasos que se lograron concluir. Esta prestación requiere Rational ClearQuest versión 7.0 o posterior.

Cuando configure un proyecto para que actualice una base de datos ClearQuest, el sistema crea o actualiza registros de compilación según se indica a continuación:
Inicio de trabajo
Cuando el sistema lanza un trabajo, el sistema crea un registro de compilación ClearQuest. El registro de compilación se encuentra en el estado Sometido e incluye el URL de registro del trabajo, la hora de inicio, el nombre de release y el ID así como una entrada de registro indicando "Compilación XYZ iniciada". Si un adaptador de control de origen cancela el trabajo (por ejemplo, porque no se encuentran cambios de origen), no se crea ningún registro de compilación ClearQuest.
Nota: Si un proyecto encadena a otro proyecto, el nuevo proyecto obtiene su propio y único ID de compilación ClearQuest.
Éxito/anomalía del trabajo
Cuando un trabajo concluye con éxito o falla, el sistema cambia el estado de compilación dentro de ClearQuest a Completado o Anómalo, establece la hora de finalización de la compilación y almacena un resumen de los pasos del trabajo en el registro de compilación de ClearQuest. El resumen incluye el nombre, estado del resultado y servidor por cada paso.
Reinicio del trabajo
Cuando se reinicia un trabajo, el sistema cambia el estado de compilación dentro de ClearQuest a Sometido y crea una entrada de registro de compilación de ClearQuest indicando "Compilación XYZ reiniciada".

La configuración automática de registros de compilación se realiza mediante variables de entorno especiales. Para enlazar un proyecto a una base de datos ClearQuest, asegúrese de que las siguientes variables se han incluido en el entorno del proyecto.

Nota: Estas variables deben estar presentes en el entorno de proyecto. Añadirlos a un paso no es suficiente. Sin embargo, puede utilizar una variable que esté establecida en el tipo Incluir que incluya estas variables mediante otro entorno. Además, puesto que el valor CQ_RELEASE_NAME es el único que probablemente variará por proyecto, puede que desee crear un entorno que contenga otras variables y, a continuación, utilizar una variable del tipo Incluir para incluir dicho entorno en el entorno del proyecto, donde podrá especificar también CQ_RELEASE_NAME como una variable de entorno específica del proyecto.

Para activar las actualizaciones automáticas de registros de compilación desde trabajos de Build Forge, se deben establecer las variables de entorno siguientes para el proyecto. No funcionan a nivel de paso.

Variable

Descripción

CQ_DBNAME

Necesario. Nombre de la base de datos ClearQuest que quiere actualizar.

CQ_DBSET

El valor establecido de la base de datos ClearQuest. No es obligatoria. El valor predeterminado es en blanco.

CQ_INTERACTION

Si su entorno de proyecto tiene las variables correctas de entorno definidas para habilitar la creación de un registro de compilación ClearQuest y no quiere crear un registro de compilación, establezca esta variable en OFF para inhabilitar la creación de registros de compilación.

Para habilitar la creación de registros de compilación, establezca esta variable de entorno en ON.

Nota: Si está utilizando uno de los adaptadores de ClearQuest, establezca esta variable de entorno en OFF. El adaptador interactúa con los registros de compilación directamente.

CQ_PASSWORD

Necesario. Contraseña para utilizar cuando se inicia sesión en la base de datos ClearQuest. No requerido; valor predeterminado en blanco.

CQ_RELEASE_NAME

Necesario. El nombre del release dentro de la base de datos ClearQuest que quiere actualizar.

CQ_USER

Necesario. Nombre de usuario que utilizar al iniciar la sesión en la base de datos ClearQuest.

Requisitos de configuración adicionales para los adaptadores de ClearQuest

Las plantillas de ejemplo de adaptadores de ClearQuest proporcionan métodos de explorar ClearCase y actualizar los registros de compilación de ClearQuest. Esto se enlaza normalmente con el éxito o anomalía de las ejecuciones de compilación de Build Forge. Para requisitos generales, consulte Requisitos de los adaptadores. Además es necesario realizar la configuración siguiente.

Haga lo siguiente:

  1. Instale un agente de Build Forge en un host que pueda conectarse al servidor ClearCase.
  2. Instale el cliente completo de ClearCase en el host del agente.
  3. Configure el entorno para el agente de forma que se puedan ejecutar mandatos a través del cliente ClearCase.
  4. Instale el cliente completo ClearQuest en el host de la consola de Build Forge.
  5. Añada el directorio de cqperl (la API de Perl de ClearQuest) a la vía de acceso del sistema.
  6. Defina una conexión que el cliente de ClearQuest del host de Build Forge pueda utilizar para acceder a la base de datos de ClearQuest. Lleve a cabo estas acciones en el host del cliente de ClearQuest.
    1. Utilice el mandato cqreg para añadir el conjunto de la base de datos (cqreg add_dbset).
    2. Utilice la herramienta de mantenimiento de ClearQuest para definir una conexión a la base de datos de ClearQuest.
  7. Determine cómo implementar y cómo y cuándo iniciar las vistas de ClearCase necesarias.
Imagen que muestra la relación entre las instalaciones de Build Forge, ClearCase y ClearQuest.

No es necesario instalar el agente. El adaptador ClearQuest se comunica directamente con ClearQuest por medio del cliente, usando la API de Perl de ClearQuest.

Importante: el adaptador de ClearQuest se puede invocar sólo con un mandato de punto en un paso. No es un adaptador de origen, por lo que no se puede utilizar un enlace de adaptador.

Ejemplos de plantilla de adaptador de ClearQuest

Se proporcionan los ejemplos de plantilla de adaptador siguientes:

ClearQuestBaseClearCaseByDate
  1. Consulta en una vista ClearCase si ha habido cambios entre dos fechas. Las fechas predeterminadas son la indicación de fecha actual y la indicación de fecha de la ejecución de adaptador previa.
  2. Por cada archivo cambiado, busca un atributo de hiperenlace de CrmRequest que identifique un ID de cambio de ClearQuest. Intenta resolver el cambio de ID añadiendo información del trabajo con el fin de resolver el registro defectuoso en ClearQuest, siempre que el estado de ClearQuest lo permita resolver.
  3. Por cada archivo cambiado, registra la siguiente información en el informe BOM: el nombre del archivo, ID de defecto, estado de defecto y cualquier error de ClearQuest.

Variables definidas en la plantilla de adaptador:

  • CurDate
  • LAST_RUN
  • VIEW
  • VOB_PATH
  • CQ_USER
  • CQ_PASSWORD
  • BFSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE
ClearQuestClearCaseByActivity
  1. Encuentra los registros defectuosos de ClearQuest asociados con una lista de actividades de ClearCase.
  2. Por cada registro defectuoso encontrado, añade información del trabajo para resolver el registro defectuoso dentro de ClearQuest, siempre que el estado de ClearQuest lo permita resolver.
  3. Registra la siguiente información en el informe BOM: archivos asociados con los ID de actividad de ClearCase y el estado defectuoso de ClearQuest.

Variables definidas en la plantilla de adaptador:

  • CurDate
  • VIEW
  • VOB_PATH
  • ACTIVITIES
  • CQ_USER
  • CQ_PASSWORD
  • PROJECT_VOB
  • BFSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE
ClearQuestUCMClearCaseByDate
  1. Consulta en una vista ClearCase si ha habido cambios entre dos fechas. Las fechas predeterminadas son la indicación de fecha actual y la indicación de fecha de la ejecución de adaptador previa. Utiliza la Gestión unificada de cambios (UCM) de Rational para producir estos resultados.
  2. Por cada archivo cambiado, registra la siguiente información en el informe BOM: el nombre del archivo, ID de defecto, estado de defecto y cualquier error de ClearQuest.

Variables definidas en la plantilla de adaptador:

  • CurDate
  • LAST_RUN
  • VIEW
  • VOB_PATH
  • CQ_USER
  • CQ_PASSWORD
  • BFSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE

Variables de adaptador de ClearQuest

Esta tabla es una referencia para las listas de variables para las plantillas de adaptador.

Tabla 1. Variables de entorno requeridas para la integración de Rational ClearQuest

Variable

Descripción

ACTIVITIES Para el adaptador ClearQuestClearCaseByActivity, un conjunto de ID de actividad delimitados según el espacio. Ejemplo: SAMPL0001@\ProjectVob
BFSERVER Establezca esta variable en el nombre del host para la consola de Build Forge.

CQ_PASSWORD

Necesario. Contraseña para utilizar cuando se inicia sesión en la base de datos ClearQuest. No requerido; valor predeterminado en blanco.

CQ_USER

Necesario. Nombre de usuario que utilizar al iniciar la sesión en la base de datos ClearQuest.

CurDate Pone la fecha actual al adaptador. Utiliza un mandato .date para generar la fecha. No cambie este valor.
LAST_RUN Para los adaptadores ByDate, el sistema utiliza este valor para determinar si se han producido cambios; el valor es la fecha de la última ejecución con éxito. Puede manipular este valor al probar el adaptador para forzarlo a que se ejecute tomando como referencia una fecha que sabe que es anterior a algunos cambios. Si el adaptador permite que a ejecución continúe, actualiza automáticamente este valor a la fecha actual. El valor predeterminado es 1-Enero-05.00:00:00.
UNIXCLIENT Se utiliza para establecer la información específica de plataforma. Establecer en 0 si el cliente se ejecuta en Windows. Establecer en 1 si el cliente se ejecuta en UNIX o Linux.
VIEW Defina esta variable con el nombre de la vista ClearCase que quiere utilizar con el adaptador.
VOB_PATH Defina este valor con el nombre del componente VOB, y opcionalmente, sus subdirectorios. Usar una lista separada por comas para varios nombres.
_CHAR_NATIVE Se utiliza internamente, y siempre se establece en 1.

Reinicio de trabajos integrados con ClearQuest

Una vez se ha completado un trabajo integrado con ClearQuest, normalmente no es posible reiniciarlo en Rational Build Forge. Como método alternativo simple, puede iniciar el trabajo como un nuevo trabajo.

Para poder habilitar el reinicio, debe editar el esquema de ClearQuest con la herramienta ClearQuest Designer. El flujo de trabajo para los registros de Build se debe modificar para permitir un estado de transición entre Completado y Enviado.


Comentarios