Integration in Rational Build Forge

Sie können IBM® Rational Asset Manager und IBM Rational Build Forge verwenden, um zuverlässige Software-Builds bereitzustellen, zu verfolgen und zu steuern.

Rational Asset Manager ergänzt bestehende Buildanwendungssysteme wie Rational Build Forge. Mit Rational Build Forge können Sie einen Build erstellen, der auf Assets in Rational Asset Manager basiert. Zudem können Sie die Integration verwenden, um die Buildergebnisse als neue Assets in Rational Asset Manager zu publizieren. Mit einer Gruppe mitgelieferter Scripts können Sie Assets herunterladen, Abhängigkeiten prüfen, kompilieren, einen Build erstellen und die Ergebnisse als neue Assets bereitstellen.

Der Prozess zur Aktivierung der Integration und zur Verwendung von Rational Asset Manager als Definitive Software Library sieht wie folgt aus:
Die Abbildung zeigt ein Rechteck, das Rational Asset Manager darstellt. In diesem größeren Rechteck sind weitere, kleinere Rechtecke enthalten, die eine ANT-Bibliothek, Kompilierungstools, allgemeine Komponenten, Open-Source-Komponenten und ein Implementierungsimage darstellen. Drei weitere Rechtecke stellen Rational Build Forge, einen Build-Server und IBM Rational Team Concert dar. Pfeile zeigen von den Komponenten innerhalb von Rational Asset Manager, Rational Team Concert und Rational Build Forge zu dem Build-Server, auf dem die Kompilierung und die Tests ausgeführt werden. Anschließend wird das Ergebnis vom Build-Server in Rational Asset Manager publiziert.
  1. Kopieren Sie die erforderlichen Rational Asset Manager-Scripts und die zugehörigen JAR-Dateien der abhängigen ANT-Bibliothek auf den Build-Server.
  2. Laden Sie die erforderlichen Build-Tools (wie Compiler, Testtools und allgemeine Scripts) aus Rational Asset Manager herunter.
  3. Stellen Sie den Quellcode aus der Quellcodeverwaltung bereit.
  4. Rufen Sie abhängige Artefakte aus Rational Asset Manager ab (z. B. Open Source, Modelle, wsdls, xsds, die als Links in den Quellenprojekten markiert sind).
  5. Führen Sie die Kompilierung und Tests durch.
  6. Publizieren Sie die endgültigen Builds in Rational Asset Manager und nehmen Sie alle abhängigen Komponenten und erforderlichen Beziehungen als Abhängigkeiten auf.

In Rational Build Forge definieren Sie ein neues Buildprojekt, um Builds zu erstellen und Assets zu publizieren. Die Quellen für den Build sind Assets und Artefakte in Rational Asset Manager und die Builds können als Assets in Rational Asset Manager publiziert werden.

Nachdem die erforderlichen Dateien für den Build eingerichtet sind und nachdem Sie den Build erfolgreich ausgeführt haben, können Sie beispielsweise die Buildergebnisse (wie eine EAR-Datei) als Assets in Rational Asset Manager bereitstellen. Nachdem die Buildergebnisse als Rational Asset Manager-Assets gespeichert wurden, können Sie auch einen Prüfprozess für die neuen Assets und die zugehörigen Artefakte ausführen, um sicherzustellen, dass sie für die Bereitstellung freigegeben sind (beispielsweise bevor sie als Meilensteinbuild publiziert werden).

Sie können einen Buildtyp (wie Meilenstein oder Golden Master) in Rational Build Forge markieren, um den Typ des Prüfprozesses für die neuen Assets anzugeben, die aus den Buildergebnissen erstellt werden. Wird ein Rational Build Forge-Build ausgeführt, werden die publizierten Assets im Build aufgelistet und in Rational Asset Manager werden alle Abhängigkeiten in das neue Asset eingeschlossen.

Entwickler können nach Assets, Artefakten und Links zu Rational Asset Manager-Artefakten suchen und diese ihrem Arbeitsbereich hinzufügen. Sie können das Dienstprogramm 'Visuell durchsuchen' verwenden, um die Beziehungen und Abhängigkeiten zwischen Assets anzuzeigen. Das Script zum Herunterladen von Assets automatisiert die Bereitstellung von Dateien für einen Buildprozess. In Rational Build Forge kann ein Entwickler nach dem Anmelden und dem Erstellen eines Projekts die Buildprojekteigenschaften festlegen und weitere Schritte ausführen, die zum Bereitstellen der Buildergebnisse notwendig sind.

Eine Demonstration der Integration sowie ein Beispiel für eine Bibliothek und ein Buildprojekt finden Sie unter http://www.ibm.com/support/docview.wss?uid=swg27016509 oder http://www.ibm.com/developerworks/offers/lp/demos/summary/r-assetmanagerrbf.html.

Integration einrichten

Anmerkung: Für die Integration benötigen Sie Ant Version 1.7.x und die aktuelle Version der Client-APIs. Die Datei ramclient.zip können Sie über die Seite Hilfe > Erweiterungen aufrufen.
Rational Asset Manager stellt die folgenden Ant-Scripts zur Verfügung, die Sie in Ihren Rational Build Forge-Projekten verwenden können:
  • ramDownloadAsset.xml - Dieses Script lädt Assets in Rational Asset Manager für die Verwendung in einem Buildprojekt herunter.
  • ramDownloadArtifactLinks.xml - Dieses Script lädt zugehörige Artefakte für die Verwendung in einem Buildprojekt herunter, die erforderliche Abhängigkeiten für die heruntergeladenen Assets sind.
  • ramPublishAsset.xml - Dieses Script publiziert die Buildergebnisse (wie eine EAR-Datei) als neue Assets in Rational Asset Manager.
Sie müssen diese Scripts und die zugehörigen JAR-Dateien der abhängigen Ant-Bibliothek aus der Datei ramclient.zip kopieren, um die Bibliotheken und Scripts auf dem Build-Server zur Verfügung zu stellen. Siehe Scripts für die Integration konfigurieren. Wenn alle Tools, Bibliotheken und abhängigen Komponenten als Assets in Rational Asset Manager verfügbar sind, können Sie die mitgelieferten ANT-Scripts verwenden, um einen Build auf der Basis dieser Assets auszuführen. Diese Scripts können Sie auch mit anderen Builddienstprogrammen und -lösungen verwenden.
Führen Sie die folgenden Schritte aus, nachdem Sie die Scripts kopiert und für Ihre Umgebung konfiguriert haben:
  1. Laden Sie die erforderlichen Tools herunter, wie Compiler, Testtools und allgemeine Scripts.

    Stellen Sie die Quellcodedateien für den Build-Server zur Verfügung, indem Sie die betreffende Bibliothek für den Extraktionsbefehl verwenden, um die Quellendateien aus dem SCM-System (Software Configuration Management; Softwarekonfigurationsmanagement), z. B. Rational ClearCase oder Rational Team Concert), zu extrahieren. Sie müssen die Quellcodedateien für den Build aus dem SCM-System extrahieren, z. B. die Download-Tools einschließlich der Rational Asset Manager-Clientbibliothek, damit das Script DownloadAsset und andere Ant-Scripts auf dem Rational Build Forge-Server verwendet werden können. Sie müssen dem SCM-System Informationen zum Buildprojekt bereitstellen, beispielsweise die Server-URL, die Benutzer-ID und das Kennwort.

  2. Laden Sie die Rational Asset Manager-Clientbibliothek vom Rational Asset Manager-Server herunter und extrahieren Sie sie, damit die mitgelieferten Ant-Scripts auf dem Build-Server verwendet werden können.
  3. Rufen Sie abhängige Artefakte ab, z. B. Open Source, Modelle, wsdls, xsds, die als Links in den Quellenprojekten markiert sind. Falls Links zu erforderlichen Rational Asset Manager-Artefakten vorhanden sind, können Sie das Script DownloadArtifactLinks verwenden, um die erforderlichen Rational Asset Manager-Artefakte herunterzuladen und anzugeben, wohin sie extrahiert werden sollen.

    Mit AppScan können Sie alle Quellendateien und Bibliotheken durchsuchen, die zu dem Projekt gehören.

  4. Führen Sie die Kompilierung und Tests durch.
  5. Publizieren Sie die endgültigen Builds in Rational Asset Manager und nehmen Sie alle abhängigen Komponenten und erforderlichen Beziehungen als Abhängigkeiten auf. Sie müssen die Verzeichnisstruktur für die Assets, die Sie publizieren, und weitere Eigenschaftswerte in dem mitgelieferten ANT-Script PublishAsset angeben.

Sie können die Beispieldateien verwenden, um ein neues Projekt mit einer Bibliothekengruppe und Konfigurationsinformationen zu definieren, indem Sie (durch Importieren der Datei eligibility.xml) den Inhalt der ZIP-Datei importieren. Die Beispieldateien finden Sie unter der folgenden Adresse: http://www.ibm.com/developerworks/offers/lp/demos/summary/r-assetmanagerrbf.html. Rational Build Forge erstellt das Projekt 'eligibility' erneut, wenn Sie die Datei eligibility.xml laden. Wählen Sie Libraries (Bibliotheken) und anschließend eine Bibliothek, z. B. GetRamLibraries, aus, um die Datei ramclient.zip abzurufen. Ändern Sie anschließend diese Dateien für Ihre Konfiguration. Sie müssen außerdem die Ant-Scripts ändern und dem Rational Build Forge-Projekt hinzufügen.

Rational Build Forge-Projekte zu bestimmten Zeitpunkten im Assetlebenszyklus ausführen

Rational Asset Manager umfasst eine Richtlinie, die Sie zum Ausführen eines Rational Build Forge-Projekts zu bestimmten Zeitpunkten im Assetlebenszyklus verwenden können. Wenn ein Software-Asset z. B. von einem Entwicklungsstatus in einen stufenweisen Status zur Vorbereitung des Tests übergeht, dann ist es eventuell sinnvoll, ein Rational Build Forge-Projekt auszuführen, das die Software automatisch erstellt und sie so implementiert, dass sie für andere Benutzer sichtbar ist.

Diese Richtlinie ist standardmäßig nicht installiert, jedoch im Lieferumfang des Produkts enthalten. Gehen Sie wie folgt vor, um die Richtlinie zu installieren:
  1. Klicken Sie im Web-Client auf das Symbol Hilfe und dann auf Erweiterungen.
  2. Laden Sie im Abschnitt für die Build Forge-Richtlinie die Datei buildforge.zip herunter. Extrahieren Sie die Datei nicht.
  3. Klicken Sie auf Administration.
  4. Klicken Sie in der Seitenleiste 'Repositoryadministration' auf Angepasste Erweiterungen.
  5. Klicken Sie im Abschnitt 'Richtlinienerweiterungen' auf Neue Richtlinienerweiterung.
  6. Geben Sie im Fenster 'Neue Erweiterung' im Feld Klassenname die Zeichenfolge com.ibm.ram.buildforge.policy.BuildGovernor ein.
  7. Klicken Sie im Feld JAR/ZIP-Datei auf Durchsuchen und navigieren Sie zur Datei buildforge.zip, die Sie heruntergeladen haben. Klicken Sie dann auf OK.

Weitere Informationen zu Richtlinien und Lebenszyklen finden Sie unter Richtlinien für Lebenszyklen, Assetentwicklung und -lebenszyklen und unter Angepasste Lebenszyklen erstellen.


Feedback