Zum Inhalt springen

Jenkins-Verbindung

Einführung

Eine Jenkins-Verbindung, die mit dem Jenkins-Connector erstellt wurde, ermöglicht den Zugriff auf Jenkins. Sobald eine Verbindung konfiguriert ist, können Instanzen von Jenkins-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Hinweis

Dieser Connector unterstützt die Re-Authentifizierung bei Änderung Organisationsrichtlinie. Wenn aktiviert, erfordert eine Änderung des Hosts oder Benutzernamens in dieser Verbindung, dass die Benutzer den API-Token für die Verbindung erneut eingeben.

Erstellen oder Bearbeiten einer Jenkins-Verbindung

Eine neue Jenkins-Verbindung wird mit dem Jenkins-Connector von einem dieser Standorte aus erstellt:

Eine vorhandene Jenkins-Verbindung kann von diesen Standorten aus bearbeitet werden:

Konfigurieren einer Jenkins-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Jenkins-Verbindung wird im Folgenden beschrieben.

Tipp

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Symbol für Variablen klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Jenkins-Verbindung einzigartig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Jenkins-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

  • Host: Geben Sie den Host für die Jenkins-Instanz ein. Dies kann im Jenkins-Dashboard gefunden werden, indem Sie zu Jenkins > Jenkins verwalten > System konfigurieren navigieren. Der Hostname wird unter Jenkins-Standort angegeben.

  • Benutzername: Geben Sie den Benutzernamen für die Jenkins-Instanz ein.

  • API-Token: Geben Sie das API-Token für die Jenkins-Instanz ein.

  • Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der mit der aktuellen Umgebung verbundenen Agentengruppe heruntergeladen. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisation Richtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine Jenkins-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfskanvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Designkomponenten-Palette zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

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

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

  • Job löschen: Löscht einen Job von einem Jenkins-Automatisierungsserver und ist als Ziel in einem Vorgang gedacht.

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