Jenkins konfigurieren

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 und es werden keine neuen Instanzen mehr akzeptiert. Weitere Informationen

Jenkins ist ein serverbasiertes Open-Source-Tool, das Software fortlaufend erstellt und testet und dabei die Verfahren von kontinuierlicher Integration und Continuous Delivery unterstützt.

Sie müssen über einen Jenkins-Server verfügen, bevor Sie eine Jenkins-Toolintegration erstellen können.

Mit der Jenkins-Toolintegration können Sie Ihre Jenkins-Jobbenachrichtigungen an andere Tools in Ihrer Toolchain senden, wie zum Beispiel an Slack und PagerDuty. Wenn Sie Code in Bereitstellungen verfolgen möchten, können Sie Bereitstellungsnachrichten zu Ihren Git-Commits und den zugehörigen Git- oder JIRA-Problemen hinzufügen. Außerdem können Sie Ihre Bereitstellungen auf der Seite für Toolchain-Verbindungen anzeigen.

Konfigurieren Sie Jenkins, um das kontinuierliche Erstellen, Testen und Bereitstellen Ihrer Apps zu automatisieren. Gehen Sie dazu wie folgt vor:

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

  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 Jenkins.

  3. Geben Sie den Namen ein, der für diese Toolintegration in Ihrer Toolchain auf der Karte für Jenkins angezeigt werden soll.

  4. Geben Sie die URL für den Jenkins-Server ein, der geöffnet werden soll, wenn Sie in Ihrer Toolchain auf die Karte für Jenkins klicken.

  5. Kopieren Sie den generierten Web-Hook der Toolchain.

  6. Führen Sie in Ihrem Jenkins-Server die folgenden Schritte aus:

    a. Installieren Sie das IBM Cloud DevOps Plug-in.

    b. Konfigurieren Sie Jenkins, um Toolchains zu benachrichtigen.

    c. Kehren Sie für die Jenkins-Toolintegration zu der Seite zum Konfigurieren der Integration zurück.

  7. Klicken Sie auf Integration erstellen.

  8. Klicken Sie auf der Übersichtsseite der Toolchain auf der Karte Tools anderer Anbieter auf Jenkins, um den Jenkins-Server anzuzeigen.

Jenkins mithilfe der API konfigurieren

Die Jenkins 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 jenkins angeben.

Parameter für die Integration desJenkins
Parameter Verwendung Typ Terraform-Argument Beschreibung
API-Token Optional, aktualisierbar Kennwort API-Token Das API-Token, das für REST-API-Aufrufe von Jenkins verwendet werden muss. Sie finden das API-Token auf der Seite Konfiguration Ihrer Jenkins-Instanz. Für diesen Parameter können Sie eine Referenz auf einen geheimen Toolchain-Schlüssel verwenden. Weitere Informationen zu geheimen Referenzen finden Sie unter Schützen Ihrer sensiblen Daten im Leitfaden Continuous Delivery.
API-Benutzername Optional, aktualisierbar Zeichenfolge API-Benutzername Der Benutzername, der mit dem API-Token des Jenkins-Servers verwendet werden soll. Ihren API-Benutzernamen finden Sie auf der Seite Konfiguration Ihrer Jenkins-Instanz.
dashboard_url erforderlich, aktualisierbar Zeichenfolge dashboard_url Das URL des Jenkins Server-Dashboards für diese Tool-Integration. In der grafischen Benutzeroberfläche öffnet der Browser dieses Dashboard, wenn Sie auf die Jenkins Tool-Integrationskarte klicken.
Name erforderlich, aktualisierbar Zeichenfolge Name Der Name dieser Toolintegration.
Web-Hook-URL Optional, aktualisierbar Zeichenfolge Web-Hook-URL Der Webhook, der in Ihren Jenkins-Jobs zum Senden von Benachrichtigungen an andere Tools in Ihrer Toolchain verwendet wird.