Jenkins v2-Spoke

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 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-Spokev 1.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

    Die Jenkins v2-Spokev2 erfordert die Generierung eines API-Tokens. Siehe Sicherheitshärtung: Neues API-Token-System in Jenkins 2,129+ Für weitere Informationen zu den API-Token.

    Unterstützte Versionen

    Alle Versionen zwischen 2.176.2 und 2.222.1.

    Spoke-Module

    Sie können konfigurieren Jenkins v2-Spokev2, um Updates von Jenkins auf Ihrem zu erhalten ServiceNow Instanz. In den Weiterleitungsrichtlinien Bedingungen, die erfüllt sein müssen, um Aktualisierungen an Ihrem zu erhalten ServiceNow Instanz ist definiert. 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 verwendet werden, ohne die Spoke-Aktionen zu verwenden. Siehe Richten Sie einen Webhook für die Jenkins-Spoke ein Informationen zum Einrichten und Konfigurieren der Webhooks. 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
    • Aufgabenname
    • Job-Pfad
    • Zugehörige Felder anzeigen

    Standardmäßig ist die Anwendung Jenkins v2 in verfügbar Jenkins v2-SpokeUnd hat diese 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.
    Die Jenkins v2-Spokev2 enthält diese Tabellen:
    • Subflow für Jenkins v2-Webhook-Antwort [sn_jenkinsv2_Spoke_Webhook_answer_Subflow]
    • Jenkins-Webhook-Client-Details [sn_jenkinsv2_Spoke_Webhook_Client_Details]

    Spoke-Subflows

    Die Jenkins v2-SpokeStellt Beispielsubflows bereit, um die Automatisierung von Jenkins-Aufgaben zu demonstrieren. Verfügbare Beispiel-Subflows:
    Subflow Beschreibung
    Jenkins-Auftrag Erstellen Erhält Updates von Jenkins im ServiceNow Instanz.
    Subflow für Jenkins-Webhook-Antwort: Informationen zum Prozess-Build Erstellt den Jenkins-Auftrag und ruft die Informationen ab. Um diesen Subflow anzupassen, erstellen Sie eine Kopie des Subflows, und ändern Sie ihn entsprechend Ihren Anforderungen.
    Jenkins-Auftrag mit Parametern erstellen Erstellt einen Jenkins-Auftrag mit den angegebenen Parametern und ruft die Informationen ab.

    Spoke-Aktionen

    Die Jenkins v2-SpokeStellt Aktionen zur Automatisierung von Jenkins-Aufgaben bereit, wenn Ereignisse in auftreten ServiceNow. Folgende Aktionen sind verfügbar:

    Kategorie Aktion Beschreibung
    Build-Verwaltung Löschen Erstellen Löscht einen Build aus einem Jenkins-Serverauftrag.
    Build Abrufen ID Ruft die Build-ID eines ausgeführten Auftrags vom Jenkins-Server ab.
    Build Abrufen Zeitstempel Ruft den Build-Zeitstempel eines bestimmten Jobs vom Jenkins-Server ab.
    Konsole Abrufen Ausgabe Ruft eine Build-Konsolenausgabe für einen bestimmten Job vom Jenkins-Server ab.
    Liste Builds Ruft alle Builds für einen bestimmten Auftrag vom Jenkins-Server ab.
    Build mit durchführen Parameter Führt einen Auftrag mit Parametern auf dem Jenkins-Server aus.
    Build Abrufen Verlauf Ruft einen Bereich des Build-Verlaufs für einen bestimmten Auftrag vom Jenkins-Server ab.
    Build Abrufen Informationen Ruft den Build-Zeitstempel, den Build-Status und die vollständigen Build-Informationen eines bestimmten Auftrags vom Jenkins-Server ab.
    Build Abrufen Nummer Ruft die Build-Nummer für einen Jenkins-Serverauftrag basierend auf einem vordefinierten Build-Filter ab, z. B. letzter erfolgreicher Build.
    Durchführen Erstellen Führt einen Auftrag auf dem Jenkins-Server aus.
    Builds nach Datumsbereich suchen Ruft alle Builds zwischen dem Datumsbereich für einen bestimmten Auftrag 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 Auftrag vom Jenkins-Server benötigt wird.
    Konfigurationsverwaltung Erstellen 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 Aufgaben ausführen kann.
    Löschen Knoten Löscht einen Knoten vom Jenkins-Server.
    Abrufen Version Ruft die Jenkins-Serverversion ab.
    Starten Sie Neu Jenkins Startet den Jenkins-Server neu.
    Testen Verbindung Testet die Verbindung zum Jenkins-Server.
    Job-Verwaltung Kopieren Auftrag Erstellt einen Auftrag durch Kopieren eines vorhandenen Jenkins-Serverauftrags.
    Erstellen Ordner Erstellt einen Jenkins-Serverordner zum Organisieren von Aufträgen.
    Erstellen Auftrag 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.
    Neu Laden Auftrag Lädt einen Jenkins-Serverauftrag neu.
    Umbenennen Auftrag Benennt einen Jenkins-Serverauftrag um.
    Anwenderverwaltung Anwender erstellen Erstellt einen Jenkins-Serveranwender.
    Anwender löschen Löscht einen vorhandenen Jenkins-Serveranwender.
    Ansichtsverwaltung Job zur Ansicht hinzufügen Fügt der Jenkins-Serveransicht einen Auftrag hinzu. Ansichten sind Container zum Organisieren von Aufträgen. Wenn eine Jenkins-Instanz wächst, können Sie Ansichten für entsprechende Gruppen und Kategorien erstellen. Sie können beispielsweise eine Build-Ansicht erstellen, die nur Build-spezifische Aufträge 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 Auftrag aus einer Jenkins-Serveransicht.

    Verbindungs- und Anmeldeinformationsanforderungen

    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 für Verbindungen und Anmeldeinformationen, 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 ausgeführt werden müssen MID-Server. Verwenden Sie den Verbindungsdatensatz, der dem Jenkins-Alias zugeordnet ist, um zu konfigurieren, wo Aktionen ausgeführt und festgelegt werden MID-Server Auswahlattribute. Weitere Informationen finden Sie unter MID-Server.

    Zum Einrichten von MID-ServerInformationen zu dieser Spoke finden Sie unter Einrichten MID-Server Für eine Spoke.