Jenkins v2-Spoke

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 bei der Installation der App haben, stellen Sie sicher, dass diese abhängigen Plugins installiert sind:

ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
ServiceNow IntegrationHub-Aktionsschritt – 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+ Um weitere Informationen zu den API-Token zu erhalten.

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 ServiceNowInstanz. In den Weiterleitungsrichtlinien Bedingungen, die erfüllt sein müssen, um Updates bei zu erhalten ServiceNowInstanz sind 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 einInformationen 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.
Webhook-Clientdetail	Details zu den Subflows in Jenkins v2-Spoke.

Die Jenkins v2-Spokev2 enthält diese Tabellen:

Jenkins v2-Webhook-Antwort-Subflow [sn_jenkinsv2_spoke_webhook_answer_subflow]
Jenkins-Webhook-Clientdetails [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	Empfängt Updates von Jenkins am ServiceNowInstanz.
Jenkins-Webhook-Antwort-Subflow: 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 gemäß Ihren Anforderungen.
Erstellen Sie einen Jenkins-Auftrag mit Parametern	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 Auftrags vom Jenkins-Server ab.
	Konsole Abrufen Ausgabe	Ruft die Build-Konsolenausgabe für einen bestimmten Auftrag 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 bestimmten Auftrag vom Jenkins-Server ab.
	Phasenknoten nach Build suchen	Ruft Informationen zu den Sonar-Aktionen, neu startbaren 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 zu den Testzusammenfassungen, der Gesamtzahl der ausgeführten Tests, bestandenen Tests, fehlgeschlagenen Tests, übersprungenen Tests und der 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 wurde.
Konfigurationsmanagement	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.
Auftragsmanagement	Kopieren Auftrag	Erstellt einen Auftrag, indem ein vorhandener Jenkins-Serverauftrag kopiert wird.
	Erstellen Ordner	Erstellt einen Jenkins-Serverordner zum Organisieren von Aufträgen.
	Erstellen Auftrag	Erstellt einen Jenkins-Serverauftrag aus einer XML-Datei.
	Löschen Sie Den Ordner	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.
	Ruft Die Auftragskonfiguration Ab	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.
Anwenderverwaltung	Löschen Sie Den Anwender	Löscht einen vorhandenen Jenkins-Serveranwender.
Ansichtsverwaltung	Fügen Sie Der Ansicht Einen Auftrag Hinzu	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.
	Entfernen Sie Den Auftrag Aus Der Ansicht	Entfernt einen Auftrag aus einer Jenkins-Serveransicht.

Verbindungs- und Anmeldeinformationsanforderungen

IntegrationHub Verwendet Aliasse, um Verbindungs- und Anmeldeinformationen sowie OAuth-Anmeldeinformationen zu verwalten. Durch die Verwendung eines Alias müssen bei der Verwendung mehrerer Umgebungen nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfiguriert werden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie keine Aktionen aktualisieren, die die Verbindung verwenden.

Diese Spoke verwendet den Datensatz „Jenkins v2-Alias 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 ausgeführt werden MID-Server. Verwenden Sie den Verbindungsdatensatz, der dem Jenkins-Alias zugeordnet ist, um zu konfigurieren, wo Aktionen ausgeführt und festgelegt werden MID-ServerAuswahlattribute. Weitere Informationen finden Sie unter MID-Server .