Rational Build Forge et Rational ClearCase

BuildForge est compatible avec Rational ClearCase pour la gestion du code source.

Cette rubrique décrit les exigences de configuration supplémentaires pour l'intégration à Rational ClearCase et récapitule les caractéristiques des exemples de modèles d'adaptateur fournis.

Les exemples de modèles d'adaptateur ClearCase fournissent des méthodes d'analyse des changements par rapport à une base de référence. En général, l'analyse des changements est utilisée pour les évitements de construction : si un composant de référence n'a pas été changé, il n'est pas généré une nouvelle fois.

Exigences de configuration supplémentaires pour les adaptateurs ClearCase

Pour plus d'informations sur les exigences générales, voir la section Exigences pour les adaptateurs. En plus de répondre aux exigences générales sur les adaptateurs, procédez comme suit :

  1. Installez un agent Build Forge sur un hôte pouvant se connecter au serveur ClearCase.
  2. Installez le client complet ClearCase sur l'hôte de l'agent.
  3. Configurez l'environnement de l'agent afin que les commandes puissent être exécutées via le client ClearCase.
  4. Déterminez comment mettre en oeuvre et quand et comment démarrer les vues ClearCase qui sont requises. Les modèles fournis supposent l'utilisation de vues dynamiques et comprennent le lancement de cette vue lors de l'exécution d'une commande cleartool. Installez le client complet ClearCase sur l'hôte de l'agent.
Image présentant la relation entre les installations Build Forge et ClearCase.

Vues ClearCase

ClearCase utilise les vues comme un moyen vous permettant d'accéder à des données. Deux types de vue peuvent être utilisés :
Vues dynamiques
Les vues dynamiques présentent un espace de travail constamment mis à jour chaque fois qu'un élément est modifié dans le contexte de vue que vous choisissez d'afficher. Seuls les éléments que vous extrayez sont copiés dans votre espace de travail et vous devez les restituer pour les rendre disponibles aux autres utilisateurs. Lorsque vous utilisez des vues dynamiques, vous indiquez trois spécifications pour accéder aux données de votre choix :
  • Vue : définit la liste des versions à présenter (via une spécification de configuration). La vue doit être lancée à l'aide d'une commande. Elle est représentée sur votre disque locale comme un répertoire principal pour le contenu. On parle aussi de vue principale. Les répertoires couramment utilisés sont les suivants :
    • Windows: unité M:, une unité partagée
    • UNIX ou Linux: /view, un système de fichiers monté
  • Contexte de vue : définit un répertoire de contenu à utiliser via une balise de vue. La balise de vue est définie dans ClearCase. Vous pouvez accéder au répertoire lorsque la vue est lancée.
  • VOB (versioned object base) : définit un sous-répertoire du contexte de vue. Les VOB sont définis dans ClearCase. Vous montez explicitement un VOB dans le contexte de vue. Ce sous-répertoire contient les artefacts versionnés (fichiers source et autres artefacts).

Les chemins d'accès à un VOB sur votre machine locale sont constitués à partir des trois éléments suivants :

  • Exemple de chemin pour les systèmes Windows, utilisant la valeur par défaut : M:\view_tag\vob_name
  • Exemple de chemin pour les systèmes UNIX et Linux, utilisant la valeur par défaut : /view/view_tag/vob_name
Vues instantanées
Lorsque vous utilisez des vues instantanées, vous spécifiez le contexte de vue et vous devez également charger les données. Vous disposez alors d'une copie locale de toutes les données que vous spécifiez. Les vues instantanées doivent être rechargées pour récupérer les modifications qui ont été restituées depuis la dernière fois que vous avez chargé les données.

Fonctionnalités Rational Build Forge qui prennent en charge les vues dynamiques

Vous pouvez utiliser des variables d'environnement spéciales pour définir et lancer des vues dynamiques à partir d'un travail Build Forge.
CLEARCASE_VIEW
Démarre la vue ClearCase spécifiée. La vue spécifiée dans cette variable doit exister, et l'étape utilisant cette variable doit être définie sur "absolue". Sur les systèmes exécutant Microsoft Windows, cette variable doit être utilisée avec le paramètre cc_suppress_server_root pour l'agent dans bfagent.conf.
_CLEARCASE_VIEWS
Spécifie une liste de vues ClearCase à démarrer avant l'exécution de la commande. Définissez la valeur sur une liste de vues séparée par une virgule ; par exemple, "Vue1,Vue2,Vue3".
_CLEARCASE_VOBS
Indique une liste de VOB ClearCase à installer avant l'exécution de la commande. Définissez la valeur sur une liste de VOB séparée par une virgule Set the value ; par exemple, "\Vob1,\Vob2,\Vob3".

Vous devrez peut-être également utiliser les paramètres d'agent pour gérer les vues sur l'hôte de l'agent. Les paramètres d'agent doivent être définis si l'agent que vous utilisez avec ClearCase s'exécute sur un système Windows. Ils sont également utiles si la vue principale que vous souhaitez utiliser via cet agent est différente de la vue racine définie par le travail. Cela se produirait si vous utilisiez le travail pour plusieurs agents et si les spécifications devaient être différentes sur chaque système hôte de l'agent.

ccviewroot root-path
Spécifie la vue principale pour cet hôte. Voir la documentation ClearCase sur init pour plus d'informations. Les valeurs internes par défaut sont les suivantes :
  • Systèmes Windows : ccviewroot M:
  • Systèmes UNIX ou Linux : ccviewroot /view
cc_suppress_server_root
Si cette option est définie, le chemin d'accès à la vue est celui qui est défini par ccviewroot. Si cette option n'est pas définie, le chemin d'accès à la vue défini dans la définition du serveur est annexé au chemin défini par ccviewroot. Ce paramètre ne nécessite pas de valeur. S'il est présent dans bfagent.conf, il est défini.

Exemples de modèles de l'adaptateur ClearCase

Les exemples de modèles d'adaptateurs suivants sont disponibles.

ClearCaseBaseline
  1. Analyse un répertoire dans une vue ClearCase.
  2. Consigne les informations de branche et de version transmises par ClearCase dans le rapport de nomenclature.

Variables utilisées :

  • INT_STREAM
  • VIEW
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
ClearCaseByBaselineActivities
  1. Crée une ligne de base à partir du contenu d'une vue ClearCase.
  2. Compare la nouvelle ligne de base à celle de l'exécution d'adaptateur précédente afin d'identifier les activités de modification.
  3. Pour chaque activité de modification, consigne les informations suivantes dans le rapport de BOM : activité, fichiers modifiés, utilisateur, date, commentaires et version.
  4. Pour chaque fichier modifié, consigne les détails de modification (à partir de différents résultats de commande) dans le rapport BOM.

Variables utilisées :

  • CurDate
  • LAST_RUN
  • BASELINE
  • VIEW
  • VOB_PATH
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
ClearCaseByBaselineVersions
  1. Crée une ligne de base à partir du contenu d'une vue ClearCase.
  2. Compare la nouvelle ligne de base à celle de l'exécution d'adaptateur précédente afin d'identifier les fichiers modifiés.
  3. Pour chaque fichier modifié, consigne les informations suivantes dans le rapport BOM : nom de fichier, version, date, utilisateur et commentaires.
  4. Pour chaque fichier modifié, consigne les détails de modification (à partir de différents résultats de commande) dans le rapport BOM.

Variables utilisées :

  • CurDate
  • LAST_RUN
  • LABEL
  • BASELINE
  • VIEW
  • VOB_PATH
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE
ClearCaseByDate
  1. Recherche les modifications effectuées entre deux dates dans une vue ClearCase. Les dates par défaut sont l'horodatage en cours et l'horodatage de l'exécution d'adaptateur précédente.
  2. Pour chaque fichier modifié, consigne les informations suivantes dans le rapport BOM : nom de fichier, version, date, utilisateur et commentaires.
  3. Pour chaque fichier modifié, consigne les détails de modification (à partir de différents résultats de commande) dans le rapport BOM.

Variables utilisées :

  • CurDate
  • LAST_RUN
  • LABEL
  • BASELINE
  • VIEW
  • VOB_PATH
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE
ClearCaseByLabel
  1. Crée et applique un nouveau libellé pour le contenu d'une vue ClearCase.
  2. Compare le nouveau libellé à celui de l'exécution d'adaptateur précédente afin d'identifier les fichiers modifiés.
  3. Pour chaque fichier modifié, consigne les informations suivantes dans le rapport BOM : nom de fichier, version, date, utilisateur et commentaires.
  4. Pour chaque fichier modifié, consigne les détails de modification (à partir de différents résultats de commande) dans le rapport BOM.

Variables utilisées :

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

variables de l'adaptateur ClearCase

Cette table sert de référence pour les listes de variables des modèles d'adaptateur.

Nom de variable d'environnement Description
BASELINE Pour les adaptateurs ByBaseline, lorsque vous utilisez l'adaptateur pour créer des différences par ligne de base, le système utilise cette valeur comme ligne de base.
CCSERVER Définissez cette variable sur le nom de l'hôte où le client ClearCase et l'agent Build Forge sont installés.
CurDate Fournit la date actuelle à l'adaptateur, à l'aide d'une commande .date afin de générer la date au format attendu par ClearCase. Ne modifiez pas cette valeur.
LABEL Pour les adaptateurs ByLabel, lorsque vous utilisez votre adaptateur pour créer des différences par libellé (avec l'adaptateur ByLabel), le système utilise cette valeur en tant que libellé.
LAST_RUN Pour les adaptateurs ByDate, le système utilise cette valeur afin de déterminer si des modifications ont été effectuées ; il s'agit de la date de la dernière exécution réussie. Vous pouvez régler cette valeur lorsque vous testez l'adaptateur pour provoquer son exécution, en sélectionnant une date dont vous savez qu'elle est antérieure à certaines modifications. Si l'adaptateur autorise la poursuite de l'exécution, il met automatiquement cette valeur à jour sur la date actuelle. La valeur par défaut est 1-Jan-05.00:00:00.
PROJECT_VOB Lorsque vous utilisez un adaptateur ByBaseline, définissez cette variable sur le nom de votre projet VOB (uniquement utilisé avec UCM ClearCase). Exemple : \ProjectVob
UNIXCLIENT Permet de définir les informations spécifiques à la plateforme. Définissez sur la valeur 0 si le client est en cours d'exécution sur Windows. Définissez sur la valeur 1 si le client est en cours d'exécution sur UNIX ou Linux.
VIEW Définissez cette variable sur le nom de la vue ClearCase que vous souhaitez utiliser avec l'adaptateur.
VOB_PATH Définissez cette valeur sur le nom de votre composant VOB et éventuellement, de ses sous-répertoires. Utilisez une liste séparée par des virgules en cas de noms multiples.
_CHAR_NATIVE Utilisé en interne et toujours défini sur la valeur 1.

Les variables de déclenchement suivantes peuvent également permettre de lancer des vues et monter des VOB. Toutefois, elles sont indépendantes des vues et des VOB définis dans les variables d'adaptateur.

Voir Informations de référence sur les variables de déclenchement.


Feedback