Jenkins v2-Spoke
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)
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.
- 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 Webhook-Antwort-Subflow [sn_jenkinsv2_spoke_webhook_answer_subflow]
- Jenkins-Webhook-Client-Details [sn_jenkinsv2_spoke_webhook_client_details]
Spoke-Unterabläufe
| 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.