Vous pouvez configurer les scripts Ant fournis avec IBM® Rational Asset Manager afin de les intégrer à une application de génération telle que 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 une intégration de la génération, paramétrez 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. Le fichier ramclient.zip contient un ensemble de fichiers .jar et de tâches et scripts Ant obligatoires, et est disponible sur la page Extensions de n'importe quelle 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 utiliser le fichier ramclient.zip, extrayez-le dans un dossier, puis définissez le paramètre de bibliothèque Ant pour inclure le fichier .jar Ant. Si vous utilisez
Ant 1.8, définissez le paramètre de bibliothèque Ant avec le fichier ramclient-ant1.8.jar
de ce dossier. Si vous utilisez
Ant 1.7, définissez le paramètre de bibliothèque Ant avec le fichier ramclient-ant.jar
de ce dossier.
Ne déplacez aucun des fichiers extraits une fois que vous extrayez l'archive ramclient.zip.
Ant recherche automatiquement les autres fichiers .jar requis par ramclient-ant1.8.jar ou ramclient-ant.jar, selon les besoins.
- 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, cliquez sur Extensions, faites défiler l'écran jusqu'à la section des services Web, puis recherchez 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 à utiliser lorsque le serveur Rational Asset Manager est utilisé.
- ram.asset.guid = 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.guid" 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 à utiliser 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 la forme d'un actif unique, afin de refléter les dépendances vis-à-vis d'autres actifs utilisés pour générer cet actif (par exemple, composants open source/communs, plateformes prises en charge et spécifications) ainsi qu'un lien vers ce qui est mis en oeuvre par cet actif généré et publié (par exemple, 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 à indiquer 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.