Rational Build Forge y Rational ClearCase

BuildForge puede trabajar con Rational ClearCase para la gestión de código fuente.

En este tema se describen requisitos de configuración adicionales para la integración con Rational ClearCase y se resumen las características de las plantillas de adopción de ejemplo proporcionadas.

La plantilla de adaptador de ClearCase proporciona métodos para el análisis de cambios en una línea base. Para evitar compilaciones, se utiliza análisis de cambios comunes: si un componente de línea base no ha cambiado, no se vuelve a compilar

Requisitos de configuración adicionales para los adaptadores de ClearCase

Para requisitos generales, consulte Requisitos de los adaptadores. Además de completar los requisitos generales para adaptadores, siga estas instrucciones:

  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. Determine cómo implementar y cómo y cuándo iniciar las vistas de ClearCase necesarias. Las plantillas que se proporcionan asumen el uso de vistas dinámicas e incluyen vistas iniciales cuando ejecutan un mandato de cleartool. Instale el cliente completo de ClearCase en el host del agente.
Imagen que muestra la relación entre las instalaciones de Build Forge y ClearCase.

Vistas de ClearCase

ClearCase emplea vistas como forma de acceso del usuario a sus datos. Pueden usarse dos tipos de vistas:
Vistas dinámicas
Las vistas dinámicas muestran un espacio de trabajo que se actualiza constantemente cuando algo cambia en el contexto de la vista que el usuario selecciona. Solamente los elementos extraídos se copian al espacio de trabajo, y deben incorporarse para que estén disponibles para otros usuarios. Cuando se utilizan vistas dinámicas, se usan tres especificaciones para acceder a los datos deseados:
  • Vista: define la lista de versiones que deben presentarse (a través de una especificación de configuración). La vista debe iniciarse utilizando un mandato. Se representa en el disco local como un directorio raíz del contenido. También se llama vista raíz. Los directorios usados normalmente son los siguientes:
    • Windows: unidad M:, una unidad compartida
    • UNIX o Linux: /view, un sistema de archivos montado
  • Contexto de la vista: define un directorio de contenido que utilizar a través de una etiqueta de vista. La etiqueta de vista está definida en ClearCase. El directorio se hace disponible cuando se inicia la vista.
  • VOB (base de objetos versionados): define un nuevo subdirectorio del contexto de vista. Las VOB se definen en ClearCase. La VOB se monta en el contexto de la vista de manera explícita. Este subdirectorio contiene artefactos versionados (archivos fuente y otros artefactos).

Las vías de acceso de una VOB en la máquina local se construyen con los tres elementos siguientes:

  • Vía de acceso de ejemplo para sistemas Windows, utilizando el valor predeterminado: M:\view_tag\vob_name
  • Vía de acceso de ejemplo para sistemas UNIX y Linux, utilizando el valor predeterminado: /view/view_tag/vob_name
Vistas de instantánea
Cuando se utilizan vistas de instantánea debe especificarse el contexto de la vista y cargar los datos. El resultado es una copia local de todos los datos especificados. Las vistas de instantánea deben volver a cargarse para obtener los cambios que se hayan incorporado desde la última carga de datos.

Características de Rational Build Forge que dan soporte a las vistas dinámicas

Puede utilizar variables de entorno especiales para definir e iniciar vistas dinámicas desde un trabajo de Build Forge.
CLEARCASE_VIEW
Inicia la vista de ClearCase especificada. La vista especificada en esta variable debe existir, y el paso que la utiliza se debe establecer en "absoluto". En sistemas que ejecutan Microsoft Windows, esta variable debe utilizarse junto al parámetro cc_suppress_server_root para el agente de bfagent.conf.
_CLEARCASE_VIEWS
Especifica una lista de vistas de ClearCase que se deben iniciar antes de ejecutar un mandato. Defina el valor con una lista separada por comas de vistas, por ejemplo, "Vista1,Vista2,Vista3".
_CLEARCASE_VOBS
Especifica un lista de VOB de ClearCase que se deben montar antes de ejecutar un mandato. Defina el valor con una lista separada por comas de VOB, por ejemplo, "\Vob1,\Vob2,\Vob3".

También es posible que necesite utilizar los parámetros del agente para gestionar las vistas en el host del agente. Debe definir los parámetros del agente si el que está utilizando con ClearCase se ejecuta en un sistema Windows. También son útiles si la vista raíz que desea utilizar a través de este agente es distinta de la vista raíz definida por el trabajo. Esto puede ocurrir si ha utilizado el trabajo para más de un agente y las especificaciones tienen que ser diferentes en el host de cada agente.

ccviewroot vía-de-acceso-raíz
Especifica la raíz de la vista predeterminada para este host. Consulte la documentación de ClearCase sobre init para obtener más información. Los valores predeterminados internos son los siguientes:
  • Sistemas Windows: ccviewroot M:
  • Sistemas UNIX o Linux: ccviewroot /view
cc_suppress_server_root
Si está establecido, la vía de acceso de la vista será la vía de acceso establecida por ccviewroot. Si no está establecido, la vía de acceso establecida en la definición de servidor se añade a la vía de acceso establecida por ccviewroot. Este valor no necesita valor. Si se encuentra en bfagent.conf, entonces está establecido.

Ejemplos de plantillas de adaptador de ClearCase

Se proporcionan los ejemplos de plantillas de adaptador siguientes.

ClearCaseBaseline
  1. Explora un directorio en una vista ClearCase.
  2. Registra la información de versión y ramificación facilitada por ClearCase en el informe BOM.

Variables utilizadas:

  • INT_STREAM
  • VIEW
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
ClearCaseByBaselineActivities
  1. Crea una nueva línea base a partir del contenido de una vista ClearCase.
  2. Compara la nueva línea base y la línea base desde la ejecución de adaptador previa para identificar un cambio de actividad.
  3. Por cada cambio de actividad, registra la siguiente información en el informe BOM: actividad, archivos cambiados, usuario, fecha, comentarios y versión.
  4. Por cada archivo cambiado, registra los detalles del cambio (desde la salida del mandato diff) en el informe BOM.

Variables utilizadas:

  • CurDate
  • LAST_RUN
  • BASELINE
  • VIEW
  • VOB_PATH
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
ClearCaseByBaselineVersions
  1. Crea una nueva línea base a partir del contenido de una vista ClearCase.
  2. Compara la nueva línea base y la línea base desde la ejecución de adaptador previa para identificar los archivos cambiados.
  3. Por cada archivo cambiado, registra la siguiente información en el informe BOM: nombre de archivo, versión, fecha, usuario y comentarios.
  4. Por cada archivo cambiado, registra los detalles del cambio (desde la salida del mandato diff) en el informe BOM.

Variables utilizadas:

  • CurDate
  • LAST_RUN
  • LABEL
  • BASELINE
  • VIEW
  • VOB_PATH
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE
ClearCaseByDate
  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, registra la siguiente información en el informe BOM: nombre de archivo, versión, fecha, usuario y comentarios.
  3. Por cada archivo cambiado, registra los detalles del cambio (desde la salida del mandato diff) en el informe BOM.

Variables utilizadas:

  • CurDate
  • LAST_RUN
  • LABEL
  • BASELINE
  • VIEW
  • VOB_PATH
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE
ClearCaseByLabel
  1. Crea y aplica una nueva etiqueta en el contenido de una vista ClearCase.
  2. Compara la nueva etiqueta y la etiqueta registrada desde la ejecución de adaptador previa para identificar los archivos cambiados.
  3. Por cada archivo cambiado, registra la siguiente información en el informe BOM: nombre de archivo, versión, fecha, usuario y comentarios.
  4. Por cada archivo cambiado, registra los detalles del cambio (desde la salida del mandato diff) en el informe BOM.

Variables utilizadas:

  • CurDate
  • LAST_RUN
  • LABEL
  • BASELINE
  • VIEW
  • VOB_PATH
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE

Variables de adaptador de ClearCase

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

Nombre de la variable de entorno Descripción
BASELINE Para los adaptadores ByBaseline, cuando utiliza un adaptador para generar diferencias según la línea base, el sistema utiliza este valor como línea base.
CCSERVER Establezca esta variable en el nombre del host que tiene el cliente ClearCase y el agente Build Forge instalados.
CurDate Pone la fecha actual al adaptador. Utiliza un mandato .date para generar la fecha con el formato esperado por ClearCase. No cambie este valor.
LABEL Para los adaptadores ByLabel, cuando utiliza un adaptador para generar diferencias según la etiqueta (con el adaptador ByLabel), el sistema utiliza este valor como etiqueta.
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.
PROJECT_VOB Cuando utilice el adaptador ByBaseline, defina esta variable con el nombre de su proyecto VOB (sólo utilizado con UCM ClearCase). Ejemplo: \ProjectVob
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.

Las variables de desencadenantes siguientes también se pueden utilizar para iniciar vistas y vobs de montaje. No obstante, son independientes de las vistas y vobs que se establecen en las variables de adaptador.

Consulte Referencia de variables de desencadenantes.


Comentarios