Jenkins v2-Spoke

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 5 Minuten Lesedauer

    • Verwalten Sie Builds, Benutzer, Einstellungen und Aufträge auf dem Jenkins-Server. Rufen Sie Jenkins-Daten ab, die in einem Flow verwendet werden sollen.

    Apps im Store anfordern

    Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.

    IntegrationHub-Abonnement

    Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht.

    Spoke-Version

    Jenkins v2-Spoke v1.2.0 ist die neueste Version.

    Spoke-Abhängigkeiten

    Wenn Sie Probleme beim Installieren der App haben, stellen Sie sicher, dass die folgenden abhängigen Plugins installiert sind:

    • ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
    • ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
    • ServiceNow IntegrationHub Action Template – Data Stream (com.glide.hub.action_type.datastream)
    Hinweis:
    Einige dieser Plugins sind lizenzierbare Funktionen und erfordern eine entsprechende Lizenz, wenn sie außerhalb der Spoke-Implementierung verwendet werden. Informationen zu Lizenzen erhalten Sie von Ihrem Account Manager.

    Spoke-Anforderungen

    Jenkins v2-Spoke v2 erfordert das Generieren eines API-Tokens. Weitere Informationen zu den API-Token finden Sie unter Sicherheitshärtung: Neues API-Tokensystem in Jenkins ab Version 2.129.

    Unterstützte Versionen

    Alle Versionen zwischen 2.176.2 und 2.222.1.

    Spoke-Module

    Sie können Jenkins v2-Spoke v2 so konfigurieren, dass er Updates von Jenkins in Ihrer Instanz ServiceNow ] erhält. In den -Routing-Richtlinien sind Bedingungen definiert, die erfüllt sein müssen, um Updates in Ihrer Instanz ServiceNow zu erhalten. Wenn die Bedingungen erfüllt sind, löst die Weiterleitungsrichtlinie den zugehörigen Subflow aus, der wiederum die Jenkins-Aufgaben automatisiert. Dies erfordert ein separates Setup und kann unabhängig ohne Verwendung der Spoke-Aktionen verwendet werden. Informationen zum Einrichten und Konfigurieren der Webhooks finden Sie unter Richten Sie einen Webhook ein. Informationen zur Verwendung anderer Bedingungen in der Weiterleitungsrichtlinie oder zum Anpassen der Standard-Subflows finden Sie unter Passen Sie einen Webhook an.

    Weiterleitungsrichtlinien und Subflows unterstützen diese Felder:
    • Stichwörter
    • Build-Nummer
    • Auftragsname
    • Job-Pfad
    • Zugehörige Felder anzeigen

    Standardmäßig ist die Anwendung Jenkins v2 im Jenkins v2-Spoke verfügbar und verfügt über die folgenden Module:

    Modul Beschreibung
    Webhook-Antwort-Subflows Details des Webhook-Autorisierungsschlüssels zum Autorisieren von Anforderungen von Jenkins.
    Details zum Webhook-Client Details zu den Subflows in Jenkins v2-Spoke.
    Jenkins v2-Spoke v2 enthält die folgenden Tabellen:
    • Webhook-Antwort-Subflow für Jenkins v2 [sn_jenkinsv2_spoke_webhook_answer_subflow]
    • Details zum Jenkins-Webhook-Client [sn_jenkinsv2_spoke_webhook_client_details]

    Spoke-Unterabläufe

    Jenkins v2-Spoke stellt Beispiel-Subflows bereit, um die Automatisierung von Jenkins-Aufgaben zu demonstrieren. Verfügbare Beispiel-Unterabläufe umfassen Folgendes:
    Subflow Beschreibung
    Generieren Sie den Jenkins-Auftrag Erhält Updates von Jenkins in der Instanz ServiceNow.
    Jenkins-Webhook-Antwort-Subflow: Build-Informationen verarbeiten Erstellt einen Jenkins-Job und ruft die Informationen ab. Um diesen Subflow anzupassen, erstellen Sie eine Kopie des Subflows, und ändern Sie sie entsprechend Ihren Anforderungen.
    Erstellen Sie einen Jenkins-Auftrag mit Parametern Erstellt einen Jenkins-Job mit den angegebenen Parametern und ruft die Informationen ab.

    Spoke-Aktionen

    Jenkins v2-Spoke bietet Aktionen zur Automatisierung von Jenkins-Aufgaben, wenn in ServiceNowEreignisse eintreten. Folgende Aktionen sind verfügbar:

    Kategorie Aktion Beschreibung
    Build-Verwaltung Löschen Sie Build Löscht einen Build aus einem Jenkins-Serverauftrag.
    Build IDabrufen Ruft die Build-ID eines ausgeführten Jobs vom Jenkins-Server ab.
    Build -Zeitstempel] abrufen Ruft den Build-Zeitstempel eines bestimmten Jobs vom Jenkins-Server ab.
    Konsole Ausgabe] abrufen Ruft eine Build-Konsolenausgabe für einen bestimmten Job vom Jenkins-Server ab.
    Liste Builds Ruft alle Builds für einen bestimmten Job vom Jenkins-Server ab.
    Build mit Parametern] ausführen Führt einen Job mit Parametern auf dem Jenkins-Server aus.
    Build Verlaufabrufen Ruft einen Bereich des Build-Verlaufs für einen bestimmten Job vom Jenkins-Server ab.
    Build-Informationen [ abrufen Ruft den Build-Zeitstempel, den Build-Status und vollständige Build-Informationen eines bestimmten Jobs vom Jenkins-Server ab.
    Build Nummerabrufen Ruft die Build-Nummer für einen Jenkins-Serverauftrag basierend auf einem vordefinierten Build-Filter ab, z. B. dem letzten erfolgreichen Build.
    Buildausführen Führt einen Auftrag auf dem Jenkins-Server aus.
    Builds nach Datumsbereich suchen Ruft alle Builds im Datumsbereich für einen bestimmten Job vom Jenkins-Server ab.
    Commits nach Build suchen Ruft die Commits eines bestimmten Builds für einen angegebenen Auftrag vom Jenkins-Server ab.
    Phasenknoten nach Build suchen Ruft Informationen über die Sonar-Aktionen, neustartbare Phasen und Knoten aller Phasen eines bestimmten Builds für einen bestimmten Pipeline-Auftrag vom Jenkins-Server ab.
    Phasen nach Build suchen Ruft den Build-Status, die Startzeit, die Endzeit, die Dauer und die Phasen eines bestimmten Builds für einen bestimmten Pipeline-Auftrag vom Jenkins-Server ab.
    Testbericht nach Build suchen Ruft Informationen über die Testzusammenfassungen, die Gesamtzahl der ausgeführten Tests, bestandenen Tests, fehlgeschlagenen Tests, übersprungenen Tests und die Zeit ab, die für die Ausführung von JUnit-Tests in einem bestimmten Build für einen bestimmten Job vom Jenkins-Server benötigt wurde.
    Konfigurationsmanagement Erstellen Sie den Knoten Erstellt einen Knoten, den Sie mit der Java Web Start-Software starten können. Ein Knoten ist ein Computer, der Teil der Jenkins-Umgebung ist und Jobs ausführen kann.
    Löschen Sie den Knoten Löscht einen Knoten vom Jenkins-Server.
    Rufen Sie die Version ab Ruft die Jenkins-Serverversion ab.
    Starten Sie Jenkins neu Startet den Jenkins-Server neu.
    Testen Sie die -Verbindung Testet die Verbindung zum Jenkins-Server.
    Job-Verwaltung Auftrag kopieren Erstellt einen Job durch Kopieren eines vorhandenen Jenkins-Serverjobs.
    Erstellen Sie den Ordner . Erstellt einen Jenkins-Serverordner, um Jobs zu organisieren.
    Auftrag erstellen Erstellt einen Jenkins-Serverauftrag aus einer XML-Datei.
    Ordner löschen Löscht einen vorhandenen Jenkins-Serverordner.
    Auftrag löschen Löscht einen Jenkins-Serverauftrag.
    Aufträge nach Ordner auflisten Ruft alle Aufträge für einen bestimmten Ordner vom Jenkins-Server ab.
    Auftragskonfiguration abrufen Ruft die XML-Konfiguration für einen Jenkins-Serverauftrag ab.
    Laden Sie den Auftrag neu Lädt einen Jenkins-Serverauftrag neu.
    Benennen Sie den Auftrag um Benennt einen Jenkins-Serverauftrag um.
    Anwenderverwaltung Anwender erstellen Erstellt einen Jenkins-Serveranwender.
    Anwender löschen Löscht einen vorhandenen Jenkins-Server-Anwender.
    Ansichtsverwaltung Job zur Ansicht hinzufügen Fügt der Jenkins-Serveransicht einen Job hinzu. Ansichten sind Container zum Organisieren von Aufgaben. Wenn eine Jenkins-Instanz größer wird, können Sie Ansichten für entsprechende Gruppen und Kategorien erstellen. Beispielsweise können Sie eine Build-Ansicht erstellen, die nur buildspezifische Jobs anzeigt.
    Ansicht erstellen Erstellt eine Jenkins-Serveransicht.
    Ansicht löschen Löscht eine Jenkins-Serveransicht.
    Aufträge nach Ansicht auflisten Ruft alle Aufträge aus einer Ansicht auf dem Jenkins-Server ab.
    Auftrag aus Ansicht entfernen Entfernt einen Job aus einer Jenkins-Serveransicht.

    Anforderungen an Verbindungen und Anmeldeinformationen

    IntegrationHub verwendet Aliasse, um Verbindungs- und Anmeldeinformationen sowie OAuth-Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren.

    Diese Spoke verwendet den Datensatz „Alias für Verbindungen und Anmeldeinformationen“ von Jenkins v2, um Aktionen zu autorisieren. Um den Spoke-Verbindungsalias zu verwenden, erstellen Sie einen zugehörigen Verbindungsdatensatz und einen zugehörigen Anmeldeinformationsdatensatz. Informationen zum Einrichten der Spoke finden Sie unter Richten Sie die Jenkins-Spoke ein.

    MID-Server-Anforderungen

    Diese Aktionen verwenden REST-Aufrufe, die auf einem MID-Serverausgeführt werden. Verwenden Sie den Verbindungsdatensatz, der dem Jenkins-Alias zugeordnet ist, um zu konfigurieren, wo Aktionen ausgeführt werden, und um MID-Server Auswahlattribute festzulegen. Weitere Informationen finden Sie unter MID-Server.