Si vous avez activé la bibliothèque Maven, vous pouvez créer et utiliser des actifs pouvant être utilisés avec Maven.
Avant de commencer
Pour que des actifs Maven puissent être créés et utilisés, un administrateur de référentiels doit activer la bibliothèque de modèles de Maven. Pour plus d'informations, voir Activation de la bibliothèque Maven.
Le client mvn peut s'intégrer à Rational Asset Manager, en utilisant
Rational Asset Manager comme référentiel Maven.
Une configuration supplémentaire du client Maven est requise si le serveur
Rational Asset Manager utilise le protocole HTTPS. Si vous utilisez des certificats signés par une autorité de certification, reportez-vous à la rubrique Remote repository access through authenticated HTTPS dans la documentation Maven pour obtenir de plus amples informations. Si vous utilisez des certificats autosignés, vous devez ajouter le certificat du serveur sous la forme d'un certificat sécurisé au fichier de clés de l'ordinateur client. Les détails de cette procédure ne font pas partie de la présente documentation. Vous avez la possibilité d'utiliser InstallCert.java, qui peut être téléchargé sur le Web, afin d'ajouter le certificat autosigné au fichier de clés local.
Procédure
- Créez et soumettez un actif pour chaque actif Maven. Ajoutez l'attribut Group.Id à l'actif. Pour en savoir plus sur la création et la soumission d'actifs, voir Créer et soumettre des actifs. Le nom de l'actif dans Rational Asset Manager correspond à l'élément
artifactId dans Maven. La version de l'actif correspond à l'élément version dans Maven.
- Si vous avez créé un fichier pom.xml pour le projet Maven, ajoutez le fichier pom.xml à l'actif. Pour en savoir plus sur le modèle d'objet de projet (POM), consultez la rubrique
POM Reference dans la documentation Maven.
- Exécutez la stratégie de génération de POM au niveau de l'actif. Pour en savoir plus sur les stratégies, voir Stratégies pour les cycles de vie dans Rational Asset Manager. La stratégie de génération de POM ajoute des métadonnées requises par Maven à l'actif.
- Sur l'ordinateur sur lequel vous envisagez d'exécuter Maven, ouvrez le fichier settings.xml dans le répertoire rép_utilisateur/.m2.
- Dans le fichier settings.xml, ajoutez les éléments server, profile et activeProfile pour votre serveur Rational Asset Manager, comme décrit dans l'exemple ci-dessous.
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
<servers>
<server>
<id>rational.repo</id>
<username>user</username>
<password>pass</password>
</server>
</servers>
<profiles>
<profile>
<id>assetmanager</id>
<repositories>
<repository>
<id>rational.repo</id>
<url>http://server.example.com:9080/ram.ws/maven2/Sample%20Open%20Source/Maven%20Artifact/</url>
</repository>
</repositories>
</profile>
</profiles>
<activeProfiles>
<activeProfile>assetmanager</activeProfile>
</activeProfiles>
</settings>
- id
- Il existe deux types différents d'éléments id que vous devez configurer. Les éléments id peuvent correspondre à n'importe quel identificateur unique. Comme présenté dans l'exemple de fichier, l'id de l'élément server doit correspondre à l'id de l'élément repository. L'id de l'élément profile doit correspondre à l'élément activeProfile.
- username
- Nom d'utilisateur à utiliser pour l'authentification auprès du serveur Rational Asset Manager.
- password
- Mot de passe à utiliser pour l'authentification auprès du serveur Rational Asset Manager.
- url
- Indiquez le référentiel Rational Asset Manager en tapant une URL au format suivant : http://nom_hôte:numéro_port/racine-contexte_services_Web/maven2/nom_communauté/type_actif.
L'exemple de fichier présente une URL type pour un serveur Rational Asset Manager exécuté sur le port 9080 à l'adresse server.example.com, pour les actifs de type Maven Artifact dans la communauté Sample Open Source.
- activeProfile
- L'élément activeProfile doit correspondre à l'id de l'élément profile.
Pour obtenir des informations générales sur l'édition du fichier settings.xml dans Maven, reportez-vous à la rubrique Settings Reference dans la documentation Maven.
Résultats
Lors de l'exécution de Maven (le client
mvn), celui-ci accède aux fichiers stockés dans
Rational Asset Manager.