Verwendung von „ Jenkins “ mit „ IBM App Connect Enterprise “

Jenkins ist eine Open-Source-Software, die Continuous Integration und Continuous Delivery (CI/CD) unterstützt. Mit Jenkins können Sie das Erstellen und Testen Ihrer Projekte automatisieren und Ihre DevOps -Prozesse verwalten.

1. Erstellen Sie im „ IBM App Connect Enterprise “-Toolkit einen Ablauf, der einen Knoten vom Typ „ Jenkins -Anfrage“ enthält.
2. Wählen Sie den Jenkins Request -Knoten im Flow aus, damit die Knoteneigenschaften im Editor angezeigt werden.
3. Klicken Sie auf der Registerkarte Basis auf Connectorerkennung starten.
   Es erscheint eine Anzeige, in der Sie den Namen des Richtlinienprojekts und die Vaultdetails angeben können, die während der Connectorerkennung verwendet werden.
4. Geben Sie die Details des Richtlinienprojekts und der Vault an, die während der Connectorerkennung verwendet werden sollen:
   1. Geben Sie im Feld Richtlinienprojekt das Richtlinienprojekt an, in dem die Richtlinien gespeichert werden, die während der Connectorerkennung erstellt werden.
      Alternativ können Sie ein neues Richtlinienprojekt erstellen, indem Sie auf Neu klicken und dann den Namen des neuen Richtlinienprojekts angeben. Klicken Sie anschließend auf Fertigstellen.
   2. Geben Sie die Vault an, die während der Connectorerkennung verwendet wird. Berechtigungsnachweise, die während der Connector-Erkennung verwendet werden, werden standardmäßig in einer externen Verzeichnisvaultgespeichert. Dies ist eine App Connect Enterprise -Vault, die von jedem Integrationsserver verwendet werden kann. Alternativ können Sie die Berechtigungsnachweise in einer Integrationsserver-Vault speichern, die im Arbeitsverzeichnis des Integrationsservers erstellt und nur von diesem Integrationsserver verwendet werden kann.
      Um die Vault anzugeben, die zum Speichern der Berechtigungsnachweise verwendet werden soll, führen Sie die Schritte im Abschnitt Connectorerkennungsassistenten verwenden in einem der folgenden Abschnitte aus:

      • Konfigurieren eines externen Verzeichnistresors
      • Vault für Integrationsserver konfigurieren
   3. Geben Sie im Feld Vaultschlüssel den Vaultschlüssel ein, der für den Zugriff auf die in der Vault gespeicherten Berechtigungsnachweise verwendet wird. Der Vaultschlüssel muss mindestens 8 Zeichen lang sein.
   4. Optional: Standardmäßig werden die angegebene Vaultposition und der angegebene Vaultschlüssel als Vorgaben im Toolkit gespeichert, sodass die Werte beim Starten der Connectorerkennung voreingestellt sind. Wenn Sie die Vorgaben nicht sichern wollen, wählen Sie In Vaultvorgaben speichernab.
5. Klicken Sie auf Erkennung starten , um den Connectorerkennungsassistenten für den Jenkins -Connector zu starten.
   Das Fenster Connectorerkennung wird angezeigt. Wenn vorhandene Jenkins -Verbindungen (Konten) vorhanden sind, wird eine Liste dieser Verbindungen angezeigt. Sind keine Verbindungen vorhanden, wird der Status des Jenkins -Connectors als Not connectedangezeigt.
   • Wenn Jenkins -Verbindungen (Konten) verfügbar sind, führen Sie die folgenden Schritte aus:
     1. Wählen Sie die Verbindung (das Konto) aus, die Sie verwenden möchten, indem Sie darauf klicken.
     2. Klicken Sie auf den erforderlichen Objekttyp und wählen Sie die Aktion aus, die Sie für das Objekt ausführen möchten. Um beispielsweise Builds aus Jenkinsabzurufen, klicken Sie auf Builds und anschließend auf Builds abrufen.
   • Wenn keine Verbindungen (Konten) vorhanden sind, führen Sie die folgenden Schritte aus:
     1. Klicken Sie auf den erforderlichen Objekttyp und wählen Sie dann die Aktion aus, die Sie für dieses Objekt ausführen möchten. Um beispielsweise Builds aus Jenkinsabzurufen, klicken Sie auf Builds und anschließend auf Builds abrufen.
     2. Klicken Sie auf Verbinden.
        Es wird ein Fenster angezeigt, in das Sie die Verbindungsdetails für Ihr Konto Jenkins eingeben. Geben Sie die folgenden Informationen ein:

        • Anwendung URL : Die Anwendung URL der Jenkins instanz im Format <https>://<hostname>.
          Beispiel: https://123.25.132.75.
        • Benutzername: Der Benutzername des Jenkins -Kontos.
        • Kennwort: Das Kennwort für den angegebenen Benutzernamen.

        Weitere Informationen zum Ermitteln dieser Verbindungsdaten finden Sie im Abschnitt „Verwendung von IBM App Connect mit Jenkins “ in der Dokumentation zu Continuous Delivery (CD) unter IBM App Connect in containers.

     3. Klicken Sie auf Verbinden.
6. Legen Sie die erforderlichen Connectoreigenschaften im Assistenten fest.
   Sie können Bedingungen für den Datenabruf hinzufügen, indem Sie auf Bedingung hinzufügen klicken und anschließend die Eigenschaft auswählen, nach der gefiltert werden soll. Sie können auch Eigenschaften festlegen, die die maximale Anzahl der abzurufenden Datensätze und die Aktion angeben, die ausgeführt werden soll, wenn dieser Grenzwert überschritten wird.
7. Wenn Sie die Eigenschaften im Connectorerkennungsassistenten angegeben haben, klicken Sie auf Speichern.
   Der Berechtigungsnachweis, der für die Verbindung zu Jenkins verwendet wird, wird in der Vault gespeichert und die anderen Verbindungsdetails werden in der Jenkins -Richtlinie gespeichert. Die Werte der Eigenschaften, die Sie im Assistenten festgelegt haben, werden an den Knoten „ Jenkins -Anfrage“ im „ IBM App Connect Enterprise -Toolkit“ zurückgegeben.
8. Wenn Sie die Erkennung abgeschlossen und die Eigenschaftswerte gespeichert haben, verlassen Sie den Connectorerkennungsassistenten, indem Sie auf das X in der rechten oberen Ecke des Fensters klicken oder die Tastenkombination Alt+F4drücken.
9. Zurück zur Bearbeitung des Knotens „ Jenkins -Anfrage“ im „ IBM App Connect Enterprise “-Toolkit.
   Die Connectoreigenschaften, die im Assistenten für Connectorerkennung (in Schritt 6) festgelegt wurden, sind jetzt im Eigenschafteneditor auf dem Jenkins Anforderung sichtbar. Auf der Registerkarte Basis werden die Werte der Eigenschaften Aktion und Objekt angezeigt, die Sie im Assistenten festlegen. Wenn Sie beispielsweise im Assistenten Builds > Builds abrufen ausgewählt haben, werden die folgenden Eigenschaften auf der Registerkarte Basis des Knotens angezeigt:

   • Aktion - RETRIEVEALL
   • Objekt - Build

   Die Werte der Eigenschaften Aktion und Objekt werden schreibgeschützt angezeigt. Wenn Sie diese Werte ändern wollen, können Sie dies tun, indem Sie erneut auf Connectorerkennung starten klicken und im Assistenten für die Connectorerkennung neue Werte festlegen.

   Die Eigenschaft Schemabasisname gibt den Basisnamen der Schemadateien an, die das Format der Anforderungs-und Antwortnachrichten beschreiben, die vom Jenkins -Connector gesendet und empfangen werden. Der Basisname des Schemas wird automatisch bei der ersten Ausführung der Erkennung für den Knoten festgelegt und basiert auf dem aktuellen Flow-Namen und dem Knotennamen. Wenn Sie diese Eigenschaft vor der ersten Ausführung der Erkennung manuell festlegen, wird der von Ihnen festgelegte Wert verwendet. Wenn Sie die Schemas nach der Erkennung umbenennen, müssen Sie diese Eigenschaft so bearbeiten, dass sie mit dem Schemabasisnamen übereinstimmt, der von den umbenannten Schemas im Projekt verwendet wird. Wenn Sie diese Eigenschaft nach der Erkennung ändern, müssen Sie entweder die Schemanamen umbenennen, damit sie übereinstimmen, oder die Erkennung erneut ausführen.

   Abhängig von der Aktion, die während der Erkennung ausgewählt wurde, generiert der Connectorerkennungsassistent entweder ein Anforderungsschema und ein Antwortschema oder nur ein Antwortschema. Wenn die Aktion RETRIEVE oder DELETEwar, wird nur das Antwortschema vom Connector zurückgegeben. Die generierten Schemadateien werden dem Projekt hinzugefügt und können vom Knoten Zuordnung für die Transformation von Eingabe-und Ausgabedaten verwendet werden. Der vollständige Dateiname des Schemas wird aus dem Schemabasisnamen (z. B. gen/MyMessageFlow.Jenkins_Request) mit dem Suffix response.schema.json oder request.schema.jsonabgeleitet. Sie können das Schema öffnen, indem Sie auf Anforderungsschema öffnen oder Antwortschema öffnenklicken.

10. Überprüfen Sie, ob die Eigenschaftseinstellungen auf dem Jenkins Request korrekt sind, und speichern Sie dann den Nachrichtenfluss.
11. Auf der Registerkarte Verbindung des Jenkins Anforderung zeigt die Eigenschaft Richtlinie den Namen der Richtlinie an, die die Details der Sicherheitsidentität enthält, die für die Verbindung zu verwenden ist. Die Richtlinie hat den Typ Jenkins.
    Weitere Informationen finden Sie unter Jenkins -Richtlinie.
12. Optional: Setzen Sie die Eigenschaft Zeitlimit auf der Registerkarte Verbindung , um die Zeit (in Sekunden) anzugeben, die der Knoten darauf wartet, dass Jenkins die Operation verarbeitet.
13. Die Registerkarte Filter des Jenkins Anforderungsknotens enthält Eigenschaften, die steuern, wie der Nachrichtenfluss Daten auswählt. Die Anfangswerte dieser Eigenschaften werden aus den Eigenschaftswerten übernommen, die für den Connector Jenkins im Connectorerkennungsassistenten festgelegt wurden, einschließlich der Filteroptionseigenschaften und aller Bedingungen, die angegeben wurden (wie in Schritt 6beschrieben). Wenn Sie anschließend zum Assistenten für Connectorerkennung zurückkehren und die Werte von Eigenschaften ändern (z. B. durch Hinzufügen neuer Bedingungen), werden diese Aktualisierungen in der Eigenschaftengruppe auf dem Knoten widergespiegelt.

    Die Eigenschaften Filteroptionen steuern, welche Objekte bearbeitet werden sollen, wenn der Jenkins Request -Knoten ausgeführt wird. Die Eigenschaften für Filtergrenzwert steuern die maximale Anzahl abzurufender Elemente und die Aktion, die ausgeführt werden soll, wenn der Grenzwert überschritten wird.

    Sie können die Werte ändern, indem Sie auf Bearbeiten neben dem Wert klicken, den Sie im Abschnitt Filteroptionen ändern wollen, und indem Sie die Eigenschaftswerte ändern, die im Abschnitt Filterbegrenzung festgelegt wurden.

    Bei den Eigenschaftswerten kann es sich entweder um Textwerte oder ESQL-oder XPATH-Ausdrücke handeln, die aus dem Inhalt der Nachricht aufgelöst werden, die während der Ausführung an den Jenkins Request -Knoten übergeben wird.

14. Legen Sie auf der Registerkarte Anforderung die Eigenschaft Datenposition fest, um die Position in der Baumstruktur für eingehende Nachrichten anzugeben, die die Objektdaten enthält, die in Jenkinserstellt werden sollen. Diese Daten bilden die Anforderung, die vom Jenkins Request -Knoten an das Jenkins -System gesendet wird.
15. Legen Sie auf der Registerkarte Ergebnis die Eigenschaft Position für Ausgabedaten fest, um die Position in der Baumstruktur der Ausgabenachricht anzugeben, die die Daten des Datensatzes enthält, der in Jenkinserstellt wird.
16. Standardmäßig werden Anforderungsnachrichten anhand des Anforderungsschemas validiert, das während der Connectorerkennung generiert wurde. Sie können die Anforderungsvalidierung inaktivieren oder die Validierungseinstellungen mithilfe der Validierungseigenschaften des Jenkins Request ändern.
17. Speichern Sie den Nachrichtenfluss.