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 :
- Installez un agent Build Forge sur un hôte pouvant se connecter au serveur ClearCase.
- Installez le client complet ClearCase sur l'hôte de l'agent.
- Configurez l'environnement de l'agent afin que les commandes puissent être exécutées
via le client ClearCase.
- 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.

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 permettent de consulter la dernière version des éléments dans les VOB que vous spécifiez sans les copier sur votre système local. Elles doivent être démarrées. Vous spécifiez les VOB à monter dans la vue.
- Vues instantanées : les vues instantanées sont une copie du référentiel.
Vous pouvez spécifier la version des objets à utiliser. Les vues instantanées doivent être mises à jour manuellement afin de recevoir les derniers éléments qui ont été restitué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
- Analyse un répertoire dans une vue ClearCase.
- 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
- Crée une ligne de base à partir du contenu d'une vue ClearCase.
- Compare la nouvelle ligne de base à celle de l'exécution d'adaptateur précédente afin d'identifier les activités de modification.
- Pour chaque activité de modification, consigne
les informations suivantes dans le rapport de BOM : activité, fichiers modifiés, utilisateur,
date, commentaires et version.
- 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
- Crée une ligne de base à partir du contenu d'une vue ClearCase.
- Compare la nouvelle ligne de base à celle de l'exécution d'adaptateur précédente afin d'identifier les fichiers modifiés.
- Pour chaque fichier modifié, consigne les informations
suivantes dans le rapport BOM : nom de fichier, version, date, utilisateur et
commentaires.
- 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
- 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.
- Pour chaque fichier modifié, consigne les informations
suivantes dans le rapport BOM : nom de fichier, version, date, utilisateur et
commentaires.
- 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
- Crée et applique un nouveau libellé pour le contenu d'une
vue ClearCase.
- Compare le nouveau libellé à celui de l'exécution d'adaptateur précédente afin d'identifier les fichiers modifiés.
- Pour chaque fichier modifié, consigne les informations
suivantes dans le rapport BOM : nom de fichier, version, date, utilisateur et
commentaires.
- 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.
- CLEARCASE_VIEW
- _CLEARCASE_VIEWS
- _CLEARCASE_VOBS
Voir Informations de référence sur les variables de déclenchement.