Wenn Sie die Maven-Bibliothek aktiviert haben, können Sie Assets erstellen und verwenden,
die mit Maven genutzt werden können.
Vorbereitende Schritte
Bevor Sie Maven-Assets erstellen und verwenden können, muss ein Repository-Administrator
die Maven-Modellbibliothek aktivieren. Weitere Informationen finden Sie unter
Maven-Bibliothek aktivieren.
Der
mvn-Client kann in
Rational Asset Manager integriert werden,
wobei Rational Asset Manager als Maven-Repository
genutzt wird.
Wenn der
Rational Asset Manager-Server
das HTTPS-Protokoll verwendet, sind zusätzliche Konfigurationsschritte für den Maven-Client
erforderlich. Bei Verwendung von Zertifikaten, die von einer Zertifizierungsstelle signiert wurden,
finden Sie weitere Informationen in der Maven-Dokumentation unter Remote repository access through authenticated HTTPS. Bei Verwendung von selbst signierten Zertifikaten müssen Sie das
Zertifikat des Servers als gesichertes Zertifikat zum Schlüsselspeicher auf dem Client-Computer
hinzufügen. Einzelheiten zu dieser Prozedur gehen über den Umfang des vorliegenden Dokuments
hinaus. Eine Möglichkeit besteht darin, das selbst signierte Zertifikat mithilfe der Datei
InstallCert.java, die im Internet herunterladen werden kann, zum lokalen Schlüsselspeicher
hinzuzufügen.
Vorgehensweise
- Erstellen und übergeben Sie ein Asset für jedes Maven-Asset. Fügen Sie das Attribut Group.Id
zum Asset hinzu. Weitere Informationen zum Erstellen und Übergeben von Assets finden Sie unter
Assets erstellen und übergeben. Der Name des Assets in
Rational Asset Manager
entspricht dem Element artifactId in Maven. Die Version des Assets entspricht dem Element
version in Maven.
- Wenn Sie für das Maven-Projekt eine Datei pom.xml erstellt haben,
fügen Sie die Datei pom.xml zum Asset hinzu. Weitere Informationen zu POM (Project Object Model) finden Sie unter
POM Reference in der
Maven-Dokumentation.
- Führen Sie die Richtlinie POM Generation für das Asset aus. Weitere Informationen zu Richtlinien finden Sie unter
Richtlinien für Lebenszyklen in Rational Asset Manager. Die
Richtlinie 'POM Generation' fügt von Maven benötigte Metadaten zum Asset hinzu.
- Öffnen Sie auf dem Computer, auf dem Maven ausgeführt werden soll, die Datei settings.xml
im Verzeichnis benutzerausgangsverzeichnis/.m2.
- Fügen Sie in der Datei settings.xml die Elemente server,
profile und activeProfile für den
Rational Asset Manager-Server
hinzu (siehe folgendes Beispiel):
<?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
- Es gibt zwei verschiedene Typen von id-Elementen, die konfiguriert werden
müssen. Die id-Elemente können beliebige eindeutige Kennungen
sein. Die id des Elements server muss mit der
id des Elements repository
übereinstimmen (siehe Beispieldatei). Die id
des Elements profile muss mit dem Element activeProfile übereinstimmen.
- username
- Der Benutzername für die Authentifizierung mit dem
Rational Asset Manager-Server.
- password
- Das Kennwort für die Authentifizierung mit dem
Rational Asset Manager-Server.
- url
- Geben Sie das Rational Asset Manager-Repository an,
indem Sie eine URL im folgenden Format eingeben:
http://hostname:portnummer/kontextstammelement_für_web-services/maven2/community-name/assettyp.
Die Beispieldatei zeigt eine typische URL für einen
Rational Asset Manager-Server,
der an Port 9080 unter server.example.com für Assets des Typs Maven
Artifact in der Community Sample Open Source ausgeführt wird.
- activeProfile
- Das Element activeProfile muss mit der id des Elements
profile übereinstimmen.
Allgemeine Informationen zur Bearbeitung der Datei
settings.xml in Maven finden Sie unter
Settings Reference in
der Maven-Dokumentation.
Ergebnisse
Bei der Ausführung von Maven (
mvn-Client) wird auf die in
Rational Asset Manager gespeicherten
Dateien zugegriffen.
Anmerkung: Nur Maven 2 wird unterstützt.