Vous pouvez configurer les scripts Ant fournis avec IBM® Rational Asset Manager afin de les intégrer à une application de génération comme IBM Rational Build Forge ou d'autres utilitaires de génération.
Avant de commencer
- Vous devez définir les propriétés figurant dans les scripts de sorte qu'elles référencent vos informations système Rational Asset Manager.
- Pour exécuter les scripts Publish et DownloadArtifactLinks, le fichier .jar Ant-Contrib
doit être installé dans le chemin d'accès à la bibliothèque. Vous pouvez télécharger le fichier compressé contenant le fichier .jar et suivre les informations d'installation pour plus de détails.
Remarque : Lorsque vous configurez les scripts de génération Ant pour permettre leur intégration, vous devez utiliser Ant 1.7.0 ou version suivante sur la machine de génération pour empêcher toute erreur de chemin de classes lors de l'exécution des scripts. Définissez la variable JAVA_HOME sur le dossier Java et la variable ANT_HOME sur le répertoire d'installation Ant (dont la version doit être 1.7.0 ou ultérieure). Vous n'avez pas besoin de définir PATH ou CLASSPATH.
Procédure
- Créez un projet de génération (un projet Rational Build Forge, par exemple). Si les outils, bibliothèques et composants dépendants sont tous disponibles en tant qu'actifs dans Rational Asset Manager, vous pouvez utiliser les scripts ANT fournis pour exécuter une génération en fonction de ces actifs. Vous pouvez également utiliser ces scripts avec d'autres solutions et utilitaires de génération.
- A l'aide des scripts ANT fournis dans Rational Asset Manager pour le projet de génération, utilisez les actifs de la génération et publiez les résultats de la génération en tant que nouveaux actifs. Chaque script utilise les tâches ANT de Rational Asset Manager. Pour chaque script, vous devez télécharger le fichier ramclient.zip,
l'extraire dans un dossier et inclure ce dossier dans le chemin de bibliothèque ANT lorsque vous exécutez un des scripts ANT. Le fichier ramclient.zip contient un ensemble de fichiers .jar et de scripts ANT obligatoires, et est disponible sur la page Extensions de toute instance de serveur Rational Asset Manager déployée. Vous pouvez également y accéder directement à partir de l'adresse : http://<nomhôte>:<port>/ram/ramclient.zip (http://<localhost>:<9080>/ram/ramclient.zip, par exemple)
- Pour référencer les actifs à utiliser dans la génération, utilisez le script suivant : ramDownloadAsset.xml
Le fichier ramDownloadAsset.xml
est un exemple de script ANT qui télécharge le contenu de l'actif (tel les artefacts).
Ce script peut être utilisé dans un processus de génération où un ensemble de bibliothèques ou de fichiers exécutables approuvés est requis pour exécuter la génération (un compilateur spécial, des composants ou des scripts communs).
Dans le script DownloadAsset, les propriétés suivantes doivent être définies :
- lib.dir = répertoire dans lequel l'actif doit être copié.
- ram.url = URL de l'application de services Web de Rational Asset
Manager (sur le client Web Rational Asset Manager, cliquez
sur l'icône Aide, puis sur Extensions,
faites défiler l'écran vers la section des services Web et localisez la zone Emplacement du référentiel).
- ram.user.uid = ID utilisateur à indiquer lorsque le serveur Rational Asset Manager est utilisé.
- ram.user.passwd = mot de passe à indiquer lorsque le serveur Rational Asset Manager est utilisé.
- ram.asset.quid = identificateur unique de l'actif (à savoir l'ID unique de Rational Asset Manager de la page de l'actif).
- ram.asset.version = version de l'actif (à savoir, la version de Rational Asset Manager de la page de l'actif).
- build.id = ID de génération utilisé par Rational Asset Manager pour procéder au suivi de la génération associée au téléchargement.
Par exemple, remplacez ces valeurs par celles de votre propre actif à télécharger :
<property name="lib.dir" value="C:\libdir" />
<property name="ram.url" value="http://machine127.ibmtst01.com:9080/ram.ws" />
<property name="ram.asset.quid" value="{8141FA04-E837-FA50-7052-5269E7C6937C}" />
<property name="ram.asset.version" value="1.0" />
Voici les propriétés facultatives qui seront soumises à Rational Asset Manager pour décrire
l'objectif du téléchargement :
- build.type = le type de la génération ("RTC Daily Build" par exemple).
- build.team.area = l'équipe à laquelle ou le projet auquel cette génération est destinée (le projet
Rational Asset Manager par exemple).
- build.team.server = serveur utilisé pour la source de changement ou de contrôle de ce projet ou de cette équipe.
- Pour référencer les artefacts apparentés qui sont requis pour les actifs référencés de cette génération, utilisez ce script : ramDownloadArtifactLinks.xml
Le fichier ramDownloadArtifactLinks.xml est un exemple de script ANT qui résout les liens
d'artefacts de projet Eclipse vers Rational Asset Manager en téléchargeant les artefacts indiqués par les liens. Ce script peut être utilisé dans un processus de génération où le code source est extrait d'un système SCM et où les projets extraits comportent des liens vers des artefacts dans Rational Asset Manager. Dans Eclipse, les plug-ins client de Rational Asset
Manager traitent automatiquement ces liens.
Ce script utilise les utilitaires de tâche ANT-CONTRIB (http://ant-contrib.sourceforge.net/).
Assurez-vous que le fichier ant-contrib-XXX.jar se trouve dans le chemin d'accès à la bibliothèque.
Dans le script DownloadArtifactLinks, les propriétés suivantes doivent être définies :
- build.dir = espace de travail Eclipse dans lequel se trouvent des fichiers rambuildercontrol.xml. Chemin de répertoire dans lequel tous les projets Eclipse ont été extraits (généralement à partir d'un système SCM).
- ram.url = URL de l'application de services Web de Rational Asset
Manager (sur le client Web Rational Asset Manager, cliquez sur , faites défiler l'écran vers la section Services Web pour visualiser la zone Emplacement du référentiel).
- ram.user.uid = ID utilisateur à indiquer lorsque le serveur Rational Asset Manager est utilisé.
- ram.user.passwd = mot de passe à indiquer lorsque le serveur Rational Asset Manager est utilisé.
- ram.download.result.file = chemin de fichier facultatif. Si cette propriété est définie, la propriété "ram.downloadlist" va également contenir une liste séparée par des ";" répertoriant les actifs téléchargés. (Par exemple, GUID,version,artifact,artifact;GUID,version,artifact,artifact,artifact).
Par exemple, remplacez ces valeurs par vos propres actifs associés à télécharger :
<property name="ram.url" value="http://machine127.ibmtst01.com:9080/ram.ws" />
<property name="build.dir" value="C:\Documents and Settings\Administrator\Desktop\RTC Workspace\" />
<property name="ram.download.result.file" value="C:\BuildDir\publishresults" />
- Pour publier les résultats de la génération en tant que nouveaux actifs, utilisez le script ramPublishAsset.xml
Le fichier ramPublishAsset.xml est un exemple de script ANT qui publie le contenu d'un actif dans Rational Asset Manager. Ce script peut être utilisé dans un processus de génération, où un ensemble d'artefacts générés doit être publié dans Rational Asset Manager sous forme d'actif unique, reflétant les dépendances sur les autres actifs utilisés pour générer cet actif (par exemple, les composants open source/communs, les plateformes prises en charge et les spécifications) ainsi qu'un lien vers les éléments implémentés par cette génération et cet actif publié (une spécification, une édition ou une conception).
Ce script utilise les utilitaires de tâche ANT-CONTRIB (http://ant-contrib.sourceforge.net/).
Assurez-vous que le fichier ant-contrib-XXX.jar se trouve dans le chemin d'accès à la bibliothèque.
Dans le script PublishAsset, les propriétés suivantes doivent être définies :
- ram.url = URL de l'application de services Web de Rational Asset
Manager (voir la page d'aide/extension de Rational Asset Manager pour l'emplacement du référentiel).
- ram.user.uid = ID utilisateur à utiliser lorsque le serveur Rational Asset Manager est utilisé.
- ram.user.passwd = mot de passe à utiliser lorsque le serveur Rational Asset Manager est utilisé.
- ram.asset.version = version de l'actif (à savoir, la version de Rational Asset Manager de la page de l'actif).
- ram.asset.name = le nom unique de l'actif.
- ram.asset.community = communauté dans laquelle l'actif doit être téléchargé.
- ram.asset.type = type à utiliser pour cet actif.
- ram.asset.shortDescription = brève description.
- ram.asset.description = description de cet actif.
- ram.asset.artifacts = un fichier d'archive contenant une structure de répertoires de tous les artefacts à publier.
- ram.release.guid = l'ID unique auquel cet actif est associé comme partie d'une édition. Actif auquel s'associer à l'aide de la relation "implémentation de" (par exemple, lors de la publication d'un actif, vous pouvez associer l'actif à des spécifications, à des exigences en matière d'édition, etc.).
- ram.release.version = version de l'actif "implémentation de".
- build.id = Id de génération utilisé par Rational Asset Manager pour procéder au suivi
de la génération associée au téléchargement. Il peut s'agir de n'importe quelle chaîne.
Par exemple, remplacez ces valeurs pour publier vos actifs :
<property name="ram.url" value="http://machine127.ibmtst01.com:9080/ram.ws" />
<property name="ram.asset.version" value="1.0" />
<property name="ram.asset.name" value="Publish Script test" />
<property name="ram.release.guid" value="{7198899C-3E2A-A3CE-2E76-68BC2A637AD2}" />
<property name="ram.release.version" value="7.2" />
<property name="build.id" value="1234" />
Voici les propriétés facultatives qui seront soumises à Rational Asset Manager pour décrire
l'objectif du téléchargement.
- ram.download.result.file = chemin de fichier facultatif d'un fichier créé par le script ramDownloadArtifactLinks.xml. Si cette propriété est définie, le script va placer une relation de dépendance pour tous les actifs répertoriés dans ce fichier.
- verify.state.name = si cette propriété est spécifiée, le script vérifie que tous les fichiers répertoriés dans ram.download.result.file sont dans cet état ("Approuvé", par exemple).
Les éléments suivants seront placés en tant qu'informations sur les artefacts téléchargés :
- build.type = le type de la génération (tel que, "RTC Daily Build").
- build.team.area = l'équipe à laquelle ou le projet auquel cette génération est destinée (le projet
Rational Asset Manager par exemple).
- build.team.server = serveur utilisé pour la source de changement ou de contrôle de ce projet ou de cette équipe.
- src.repository = référentiel de la source avec laquelle/de l'origine avec lequel cet actif a été développé.
- build.id = ID de la génération à l'origine de cet actif.
- build.def.id = le type de génération utilisé pour créer cet actif.
- build.label = description de la génération.
- build.url = URL vers la génération avec laquelle cet actif a été créé.
- src.repository = URL du référentiel utilisé pour développer cet actif.