Maven-Assets erstellen und verwenden

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

  1. 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.
  2. 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.
  3. 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.
  4. Öffnen Sie auf dem Computer, auf dem Maven ausgeführt werden soll, die Datei settings.xml im Verzeichnis benutzerausgangsverzeichnis/.m2.
  5. 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.

Feedback