Jenkins v2-Spoke

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 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-Aktionsvorlage – Datenstrom (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 die Generierung eines API-Tokens. Weitere Informationen zu den API-Token finden Sie unter Sicherheitshärtung: Neues API-Tokensystem in Jenkins 2.129 und höher.

    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 in Ihrer Instanz von ServiceNow Updates von Jenkins erhält. In den Routing-Richtlinien werden 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 Routing-Richtlinie den zugehörigen Subflow aus, der wiederum die Jenkins-Aufgaben automatisiert. Dies erfordert ein separates Setup und kann unabhängig verwendet werden, ohne die Spoke-Aktionen zu verwenden. Informationen zum Einrichten und Konfigurieren der Webhooks finden Sie unter Richten Sie einen Webhook ein. Informationen zum Verwenden anderer Bedingungen in der Routing-Richtlinie oder zum Anpassen der Standard-Subflows finden Sie unter Passen Sie einen Webhook an.

    Weiterleitungsrichtlinien und Subflows unterstützen die folgenden Felder:
    • Stichwörter
    • Build-Nummer
    • Aufgabenname
    • 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:
    • Jenkins v2 Webhook-Antwort-Subflow [sn_jenkinsv2_spoke_webhook_answer_subflow]
    • Jenkins-Webhook-Client-Details [sn_jenkinsv2_spoke_webhook_client_details]

    Spoke-Unterabläufe

    Jenkins v2-Spoke enthält Beispiel-Subflows, um die Automatisierung von Jenkins-Aufgaben zu demonstrieren. Verfügbare Beispiel-Unterabläufe umfassen Folgendes:
    Subflow Beschreibung
    Jenkins-Job erstellen 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-Job mit Parametern Erstellt einen Jenkins-Job mit den angegebenen Parametern und ruft die Informationen ab.

    Spoke-Aktionen

    Jenkins v2-Spoke bietet Aktionen zum Automatisieren von Jenkins-Aufgaben, wenn Events in ServiceNowauftreten. Folgende Aktionen sind verfügbar:

    Kategorie Aktion Beschreibung
    Build-Verwaltung Löschen Sie Build Löscht einen Build aus einem Jenkins-Serverauftrag.
    Build-ID [ abrufen 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.
    Konsolenausgabe 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-Verlauf abrufen 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 die vollständigen Build-Informationen eines bestimmten Jobs vom Jenkins-Server ab.
    Build-Nummer [ abrufen Ruft die Build-Nummer für einen Jenkins-Serverauftrag basierend auf einem vordefinierten Build-Filter ab, z. B. dem letzten erfolgreichen Build.
    Ausführen Build 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 zum Organisieren von Jobs.
    -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 Jobs 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 Auftrag um Benennt einen Jenkins-Serverauftrag um.
    Anwenderverwaltung Benutzer erstellen Erstellt einen Jenkins-Server-Benutzer.
    Benutzer 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 wächst, können Sie Ansichten für die entsprechenden Gruppen und Kategorien erstellen. Beispielsweise möchten Sie möglicherweise eine Build-Ansicht erstellen, in der nur buildspezifische Jobs angezeigt werden.
    Ansicht erstellen Erstellt eine Jenkins-Serveransicht.
    Ansicht löschen Löscht eine Jenkins-Serveransicht.
    Aufträge nach Ansicht auflisten Ruft alle Jobs aus einer Ansicht auf dem Jenkins-Server ab.
    Auftrag aus Ansicht entfernen Entfernt einen Job aus einer Jenkins-Serveransicht.

    Anforderungen für 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 Jenkins v2-Alias-Datensatz für Verbindungen und Anmeldeinformationen, um Aktionen zu autorisieren. Um den Spoke-Verbindungsalias zu verwenden, erstellen Sie einen zugeordneten Verbindungsdatensatz und einen zugeordneten 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 dem Jenkins-Alias zugeordneten Verbindungsdatensatz, um zu konfigurieren, wo Aktionen ausgeführt werden, und um MID-Server Auswahlattribute festzulegen. Weitere Informationen finden Sie unter MID-Server.