Zum Inhalt springen

Jenkins-Connector in Jitterbit Studio

Zusammenfassung

Der Jenkins-Connector stellt den Zugriff auf Jenkins her.

Der Jenkins-Connector bietet eine Schnittstelle zum Erstellen einer Jenkins-Verbindung, die Grundlage für die Generierung von Jenkins-Aktivitätsinstanzen. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit Jenkins.

Man greift auf den Jenkins-Connector über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectoren) der Designkomponentenpalette zu (siehe Design component palette).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Jenkins-Verbindung verwendet. Die dieser Verbindung zugeordneten Aktivitätstypen werden dann verwendet, um Aktivitätsinstanzen zu erstellen, die als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden sollen.

Zusammen werden eine bestimmte Jenkins-Verbindung und ihre Aktivitäten als Jenkins-Endpunkt bezeichnet:

Jenkins activity types

  • Stop Job: Stoppt einen Job auf einem Jenkins-Automatisierungsserver und ist als Ziel in einem Vorgang vorgesehen.

  • Start Job: Startet einen Job auf einem Jenkins-Automatisierungsserver und ist als Ziel in einem Vorgang vorgesehen.

  • Delete Job: Löscht einen Job von einem Jenkins-Automatisierungsserver und ist als Ziel in einem Vorgang vorgesehen.

  • Get Job: Ruft einen Job von einem Jenkins-Automatisierungsserver ab und ist als Quelle in einem Vorgang vorgesehen.

Mit diesem Connector erstellte Endpunkte sind in der Endpunktnutzungsberichterstellung enthalten und werden auf die Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update ausgesetzt werden.

Der Jenkins-Connector verwendet die Jenkins Remote Access API.

Fehlerbehebung

Bei Problemen mit dem Jenkins-Connector werden folgende Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Disable Auto Connector Update verwendet wird).

  2. Überprüfen Sie die Vorgangsprotokolle auf alle während der Vorgangsausführung geschriebenen Informationen.

  3. Aktivieren Sie das Debug-Logging für Vorgänge (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung von privaten Agenten können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:

    <logger name="org.jitterbit.connector.jenkins" level="DEBUG"/>

    Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Verbose logging for connectors using Jitterbit private agents.

  5. Bei Verwendung von privaten Agenten können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Operation troubleshooting.