Nexus konfigurieren

DevOps Insights wird am 31. August 2026 das Ende des Betriebs erreichen und eingestellt werden. Continuous Delivery wird am 12. Februar 2027 in den folgenden Regionen eingestellt: au-syd, ca-tor, us-east. Code Risk Analyzer wird zu diesem Zeitpunkt ebenfalls in allen Regionen eingestellt. Wenn diese Funktionen in einer Region nicht aktiv genutzt werden, können sie in dieser Region vorzeitig eingestellt werden, sodass keine neuen Instanzen mehr akzeptiert werden. Weitere Informationen

Konfigurieren Sie den Repository-Manager von Nexus zum Speichern von Buildartefakten in Ihrem Nexus-Repository (Repo).

  1. Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf Nexus.

  2. Wenn Sie über eine Toolchain verfügen und diese Tool-Integration hinzufügen möchten, klicken Sie in der IBM Cloud-Konsole auf das Menü-Symbol ( Hamburger-Symbol ) > Platform Automation > Toolchains. Klicken Sie auf der Seite 'Toolchains' auf die Toolchain, um die zugehörige Übersichtsseite zu öffnen.

    a. Klicken Sie auf Tool hinzufügen.

    b. Klicken Sie im Abschnitt mit den Toolintegrationen auf Nexus.

  3. Geben Sie einen Namen für diese Instanz der Nexus-Toolintegration ein.

  4. Geben Sie die URL für das Nexus-Repository ein, das geöffnet werden soll, wenn Sie in Ihrer Toolchain auf die Karte für Nexus klicken.

  5. Wählen Sie den Repository-Typ aus, zu dem eine Verbindung hergestellt werden soll.

  6. Wenn Sie npm-Registry ausgewählt haben, führen Sie die folgenden Schritte aus:

    a. Geben Sie die E-Mail-Adresse ein, die Ihrer Registry zugeordnet ist.

    b. Geben Sie das Authentifizierungstoken ein, das Ihrer Registry zugeordnet ist.

    c. Geben Sie die URL für Ihr Nexus-Release-Repository ein. Dieses Repository ist Ihre private Registry auf dem Nexus-Server.

    d. Geben Sie die URL für die Spiegelregistry oder die öffentliche Registry ein, die Sie verwenden, um mehrere öffentliche und private npm-Registrys miteinander zu kombinieren. Bei dieser URL kann es sich beispielsweise um die URL der virtuellen Registry auf Ihrem Nexus-Server handeln, die sowohl auf Ihre private Registry als auch auf einen Cachespeicher der globalen npm-Registry Zugriff hat.

  7. Wenn Sie Maven-Repository ausgewählt haben, führen Sie die folgenden Schritte aus:

    a. Geben Sie die Benutzer-ID ein, die Ihrem Repository zugeordnet ist.

    b. Geben Sie das Kennwort ein, das Ihrem Repository zugeordnet ist.

    c. Geben Sie die URL für Ihr Nexus-Release-Repository ein. Dieses Repository ist Ihr privates Release-Repository auf dem Nexus-Server.

    d. Geben Sie die URL für Ihr Nexus-Snapshot-Repository ein. Dieses Repository ist Ihr privates Snapshot-Repository auf dem Nexus-Server.

    e. Geben Sie die URL für das Spiegelrepository oder das öffentliche Repository ein, das Sie verwenden, um mehrere öffentliche und private Maven-Repositorys miteinander zu kombinieren. Bei dieser URL kann es sich beispielsweise um die URL des virtuellen Repositorys auf Ihrem Nexus-Server handeln, das sowohl auf Ihre privaten Repositorys als auch auf einen Cachespeicher des zentralen Maven-Repositorys Zugriff hat.

  8. Klicken Sie auf Integration erstellen.

  9. Klicken Sie auf der Übersichtsseite Ihrer Toolchain auf der Karte Tools anderer Anbieter auf das Nexus-Repository, mit dem Sie arbeiten wollen. Daraufhin wird die Nexus-Website geöffnet, auf der Sie den Inhalt des Repositorys anzeigen können.

  10. Optional: Wenn Sie eine Toolchain unter IBM Cloud Public verwenden und Sie Ihre App unter Verwendung von Nexus mit npm erstellen wollen, konfigurieren Sie Ihre Pipeline durch Hinzufügen eines npm-Buildjobs. Anweisungen zum Konfigurieren des Buildjobs enthält der Abschnitt Nexus-npm-Buildjob in Ihrer Pipeline konfigurieren.

  11. Optional: Wenn Sie eine Toolchain unter IBM Cloud Public verwenden und Sie Ihre App unter Verwendung von Nexus mit Maven erstellen wollen, konfigurieren Sie Ihre Pipeline durch Hinzufügen eines Maven-Buildjobs. Anweisungen zum Konfigurieren des Buildjobs enthält der Abschnitt Nexus-Maven-Buildjob in Ihrer Pipeline konfigurieren.

Nexus-npm-Buildjob in Ihrer Pipeline konfigurieren

Bevor Sie einen npm-Buildjob in Ihrer Pipeline konfigurieren, müssen Sie über eine funktionstüchtige Pipeline verfügen, die Ihr SCM-Build-Repository als Eingabe verwenden kann. Außerdem müssen Sie Nexus für Ihre Toolchain konfigurieren. Anweisungen zum Konfigurieren von Nexus enthält der Abschnitt Nexus.

Konfigurieren Sie Delivery Pipeline durch Hinzufügen eines npm-Buildjobs. Gehen Sie dazu wie folgt vor:

  1. Erstellen Sie eine Phase und geben Sie das entsprechende SCM-Repository für die Eingabe an.

  2. Fügen Sie in der Phase einen Buildjob hinzu.

  3. Konfigurieren Sie den Build-Job:

    npm build
    build

    a. Wählen Sie als Buildertyp npm (Artifactory oder Nexus) aus.

    b. Falls Sie mehrere Instanzen der Nexus-Toolintegration konfiguriert haben, geben Sie den Namen der Nexus-Toolintegration ein, für die Sie den npm-Buildjob konfigurieren wollen.

    c. Wählen Sie als Toolintegrationstyp den Typ Nexus aus.

    d. Geben Sie beim Buildbefehl die Befehle zum Erstellen Ihres npm-Moduls ein oder die Befehle zum Veröffentlichen des Moduls in Ihrer Registry. Das nachfolgende Beispiel zeigt die Befehle zum Erstellen (Builden) des Moduls bzw. zum Veröffentlichen.

    npm install
# or
npm publish --registry "${NPM_RELEASE_URL}"

    Sie finden die URL und die Benutzerberechtigungsnachweise, die Sie für die Verbindungsherstellung mit Ihrer Registry verwendet haben, in den Konfigurationseinstellungen für die Nexus-Toolintegration.

    e. Wenn Ihr Buildjob in der Nexus-Registry veröffentlicht wird und die Version Ihres Knotenmoduls das Format x.y.z-SNAPSHOT.w aufweist, wählen Sie das Kontrollkästchen Versionsangabe für Snapshot-Modul inkrementieren aus. Der Buildjob aktualisiert die Modulversion automatisch, bevor er die Veröffentlichung in der Nexus-Registry ausführt. Der Buildjob wählt die höchste Version des Moduls aus der npm-Registry und der lokalen package.json-Datei aus und erhöht den Wert für die Modulversion unter Verwendung von SemVer (Semantic Versioning). Der Buildjob übermittelt die Änderungen nicht an das SCM-Repository.

  4. Klicken Sie auf SPEICHERN. Wann immer Ihre Pipeline ausgeführt wird, verwendet dieser Buildjob die Konfigurationsinformationen aus der Nexus-Toolintegration, um eine Verbindung zu Ihrer npm-Registry herzustellen.

Nexus-Maven-Buildjob in Ihrer Pipeline konfigurieren

Bevor Sie einen Maven-Buildjob in Ihrer Pipeline konfigurieren, müssen Sie über eine funktionstüchtige Pipeline verfügen, die Ihr SCM-Build-Repository als Eingabe verwenden kann. Außerdem müssen Sie Nexus für Ihre Toolchain konfigurieren. Anweisungen zum Konfigurieren von Nexus enthält der Abschnitt Nexus.

Konfigurieren Sie Delivery Pipeline durch Hinzufügen eines Maven-Buildjobs. Gehen Sie dazu wie folgt vor:

  1. Erstellen Sie eine Phase und geben Sie das entsprechende SCM-Repository für die Eingabe an.

  2. Fügen Sie in der Phase einen Buildjob hinzu.

  3. Konfigurieren Sie den Build-Job:

    caption-side=bottom"
    Maven-Build-JobMaven-Build-Job

    a. Wählen Sie als Buildertyp Maven (Artifactory, Nexus, SonarQube) aus.

    b. Falls Sie mehrere Instanzen der Nexus-Toolintegration konfiguriert haben, geben Sie den Namen der Nexus-Toolintegration ein, für die Sie den Maven-Buildjob konfigurieren wollen.

    c. Wählen Sie als Toolintegrationstyp den Typ Nexus aus.

    d. Geben Sie beim Buildbefehl die Befehle zum Erstellen Ihres Maven-Moduls ein oder die Befehle zum Veröffentlichen des Moduls in Ihrer Registry. Das nachfolgende Beispiel zeigt die Befehle zum Erstellen (Builden) des Moduls bzw. zum Veröffentlichen.

    mvn -B clean package
# or
mvn -DaltDeploymentRepository="snapshots::default::${MAVEN_SNAPSHOT_URL}" deploy

    Sie finden die URL und die Benutzerberechtigungsnachweise, die Sie für die Verbindungsherstellung mit Ihrer Registry verwendet haben, in den Konfigurationseinstellungen für die Nexus-Toolintegration.

  4. Klicken Sie auf SPEICHERN. Wann immer Ihre Pipeline ausgeführt wird, verwendet dieser Buildjob die Konfigurationsinformationen aus der Nexus-Toolintegration, um eine Verbindung zu Ihrem Maven-Repository herzustellen.

Konfigurieren von Nexus mithilfe der API

Die Nexus-Tool-Integration unterstützt die folgenden Konfigurationsparameter, die Sie mit der HTTP Toolchain-API und den SDKs verwenden können, wenn Sie Tool-Integrationen erstellen, lesen und aktualisieren.

Sie müssen die Eigenschaft tool_type_id im Anforderungshauptteil mit dem Wert nexus angeben.

Parameter für die Integration des Nexus-Werkzeugs
Parameter Verwendung Typ Terraform-Argument Beschreibung
dashboard_url Optional, aktualisierbar Zeichenfolge Server-URL Das URL des Nexus-Server-Dashboards für diese Tool-Integration. In der grafischen Benutzerschnittstelle ruft der Browser dieses Dashboard auf, wenn Sie auf die Integrationskarte des Nexus-Tools klicken.
spiegel_url Optional, aktualisierbar Zeichenfolge spiegel_url Das URL Ihres virtuellen Nexus-Repositorys, in dem Sie Ihre privaten Repositorys und einen Cache der öffentlichen Repositorys anzeigen können.
Name erforderlich, aktualisierbar Zeichenfolge Name Der Name dieser Toolintegration.
Release-URL Optional, aktualisierbar Zeichenfolge Release-URL Das URL Ihrer Nexus-Release-Repo.
Momentaufnahme-URL Optional, aktualisierbar Zeichenfolge Momentaufnahme-URL Das URL Ihres Nexus-Snapshot-Repositorys.
Token Optional, aktualisierbar Kennwort Token Das Kennwort oder Token für die Authentifizierung beim Nexus-Repository. Für diesen Parameter können Sie eine Referenz auf einen geheimen Toolchain-Schlüssel verwenden. Weitere Informationen zu Referenzen auf geheime Schlüssel finden Sie unter Schützen Ihrer sensiblen Daten in Continuous Delivery.
Typ erforderlich, aktualisierbar Zeichenfolge Typ Der Repository-Typ für Ihre Nexus-Toolintegration.
Benutzer-ID Optional, aktualisierbar Zeichenfolge Benutzer-ID Die Benutzer-ID oder E-Mail-Adresse für die Authentifizierung bei Ihrem Nexus-Repository.