One-Click-Bereitstellung in Jitterbit App Builder

Einführung

Seit App Builder 4.52 können Sie einen halbautomatisierten Prozess einrichten, um eine App von einer App-Builder-Umgebung (Quelle) in eine andere (Ziel) bereitzustellen. (Seit App Builder 4.53 können Sie Pakete automatisch bereitstellen und mit einem Klick installieren, indem Sie eine Zielumgebung als Standard markieren.)

Hier ist eine Übersicht der Schritte:

In der Zielumgebung:
1. API-Schlüssel einrichten.
2. Umgebung konfigurieren.
In der Quellumgebung:
1. HTTP-Sicherheitsanbieter einrichten.
2. Quellumgebung konfigurieren.

Tipp

Ein typischer Anwendungsfall für diese Funktion ist die Rationalisierung der App-Bereitstellung, beispielsweise von der Entwicklung zur Qualitätssicherung oder von der Qualitätssicherung zur Produktion. In diesen Beispielen wären Quelle und Ziel wie folgt:

%%{init: {"themeVariables": {"lineColor": "#6b7280", "edgeLabelBackground": "#f5f5f5"}}}%% flowchart LR DEV["Development
(Source)"] --> QA1["QA
(Target)"] QA2["QA
(Source)"] --> PROD["Production
(Target)"]

Voraussetzungen

Der Benutzer der Zielumgebung (derjenige, für den der API-Schlüssel erstellt wird) muss die Rolle Bereitstellung haben.

Der Benutzer der Quellumgebung (derjenige, der die Bereitstellung durchführt) benötigt entweder die Rollen Administrator oder Developer.

Im Ziel

API-Schlüssel einrichten

Um einen API-Schlüssel in der Zielumgebung einzurichten, führen Sie diese Schritte aus:

Erstellen Sie einen API-Schlüssel-Sicherheitsanbieter:
1. Wählen Sie IDE > Sicherheitsanbieter.
2. Klicken Sie auf die Schaltfläche + Benutzerauthentifizierung.
3. Konfigurieren, aktivieren und speichern Sie auf der Seite Anbieter einen Anbieter vom Typ API Key:
Richten Sie einen Benutzer ein, um die One-Click-Bereitstellungen durchzuführen:
1. (Optional) Erstellen Sie einen neuen Benutzer. Wenn Sie die One-Click-Bereitstellungen mit einem vorhandenen Benutzer durchführen möchten, fahren Sie mit dem nächsten Schritt fort.
2. Gehen Sie zu IDE > Benutzerverwaltung und öffnen Sie die Registerkarte Gruppen.
3. Wählen Sie im Panel Gruppen die Option Bereitstellung.
4. Das Panel Mitgliedschaft listet nun alle Benutzer auf, die zur ausgewählten Gruppe gehören. Klicken Sie auf die Schaltfläche + Mitgliedschaft.
5. Verwenden Sie das Dropdown-Menü, um den gewünschten Benutzer auszuwählen, und klicken Sie auf das Symbol . Dieser Benutzer gehört nun zur Gruppe mit den erforderlichen Berechtigungen für die Bereitstellung eines Release.
Generieren Sie einen API-Schlüssel für den Benutzer, der die Bereitstellungen durchführt:
1. Wenn Sie die Benutzerverwaltungsseite verlassen haben, kehren Sie zu ihr zurück, indem Sie zu IDE > Benutzerverwaltung gehen.
2. Auf der Registerkarte Benutzer listet das Panel Benutzer alle Benutzer auf. Suchen Sie den gewünschten Benutzer und wählen Sie ihn aus.
3. Klicken Sie auf das Symbol für den ausgewählten Benutzer. Der Dialog Benutzer wird geöffnet.
4. Gehen Sie zu Mehr > Schlüssel. Der Dialog Schlüssel wird geöffnet.
5. Klicken Sie auf Erstellen. Der Dialog Schlüssel generieren wird geöffnet.
6. Wählen Sie im Feld Anbieter den oben erstellten Sicherheitsanbieter aus. Klicken Sie auf Speichern. App Builder erstellt einen API-Schlüssel für den Benutzer.
  
  Warnung
  
  Der API-Schlüssel wird nur einmal angezeigt. Stellen Sie sicher, dass Sie ihn kopieren und sicher speichern.
(Seit App Builder 4.68.) Verknüpfen Sie den Sicherheitsanbieter mit dem Webservice der Vinyl - Release Management-Anwendung, der versiegelten, integrierten Systemanwendung, deren REST-API One-Click-Bereitstellungsanfragen in dieser Umgebung empfängt. Der Webservice einer versiegelten Anwendung kann nicht von innen in der App neu konfiguriert werden, daher erfolgt dies stattdessen über Anwendungen verwalten:
1. Wählen Sie unter Sicherheitsanbieter unter Benutzerauthentifizierung die Option Mehr > Anwendungen verwalten.
2. Suchen Sie Vinyl - Release Management und klicken Sie auf das Symbol in der Spalte Webservice. Der Dialog Authentifizierungsanbieter wird geöffnet.
Klicken Sie auf + Authentication. Das Dialogfeld Provider wird geöffnet.
Wählen Sie den oben erstellten Sicherheitsanbieter aus. Falls die Zielumgebung einen HTTP-Anbieter mit Authentication Type auf Basic oder einen Authorization Server-Anbieter verwendet, wählen Sie stattdessen diesen aus. Klicken Sie auf Save.

Konfigurieren der Zielumgebung

Führen Sie folgende Schritte aus, um die Zielumgebung zu konfigurieren:

Wählen Sie IDE > Create Release.
Wählen Sie die Registerkarte Environments.
Klicken Sie unter Current Environment auf die Schaltfläche Configure.
Legen Sie im Popup Werte für die folgenden Felder fest:
- Name: Ein Name für diese Zielumgebung.
- URL: Die URL dieser (Ziel-)Umgebung.
- Authentication: Wählen Sie den API-Schlüssel aus dem vorherigen Abschnitt aus.
- Enable Deployment: Ausgewählt.
- Allow Install On Deploy: Ausgewählt.
Klicken Sie auf die Schaltfläche Save:

In der Quelle

Einrichten eines HTTP-Sicherheitsanbieters

Führen Sie folgende Schritte aus, um einen HTTP-Sicherheitsanbieter in der Quellumgebung einzurichten:

Wählen Sie IDE > Security Providers.
Klicken Sie auf die Schaltfläche + Data Source Authentication.
Konfigurieren Sie auf der Seite Provider einen Anbieter vom Typ HTTP (unter dem Abschnitt Data Source Authentication aufgeführt) mit Authentication Type auf API Key, aktivieren und speichern Sie ihn.
Klicken Sie auf die Schaltfläche Save. Zusätzliche Panels werden angezeigt.
Klicken Sie unter Endpoints auf die Schaltfläche + Credential. Das Popup Credential wird geöffnet.
Legen Sie die folgenden Felder fest:
- Type: API Key
- Key: Geben Sie den API-Schlüssel des Ziels ein, den Sie zuvor erstellt haben.
Schließen Sie das Popup Credential.

Konfigurieren der Quellumgebung

Führen Sie folgende Schritte aus, um die Quellumgebung zu konfigurieren:

Legen Sie die aktuelle Umgebung fest:
1. Wählen Sie IDE > Create Release.
2. Wählen Sie die Registerkarte Environments.
3. Klicken Sie unter Current Environment auf die Schaltfläche Configure.
4. Legen Sie im Popup Werte für die folgenden Felder fest:
  - Name: Ein Name für diese Quellumgebung.
  - URL: Die URL dieser (Quell-)Umgebung.
  - Enable Deployment: Ausgewählt.
  - Allow Install On Deploy: Ausgewählt.
5. Klicken Sie auf die Schaltfläche Save.
Legen Sie die Zielumgebung fest:
1. Klicken Sie unter Target Environments auf die Schaltfläche + Target Environment.
2. Legen Sie Werte für die folgenden Felder fest:
  - Name: Geben Sie einen Namen für die Zielumgebung ein.
  - URL: Die Zugriffs-URL der Zielumgebung.
  - Authentication: Wählen Sie den im vorherigen Abschnitt erstellten HTTP-Anbieter aus.
  - Supports Deployment: Ausgewählt.
    - Default: (Optional, wird angezeigt, wenn Supports Deployment ausgewählt ist.) Wählen Sie diese Option, um automatisch in dieser Umgebung bereitzustellen, sofern nicht anders gewählt.
  - Supports Install On Deploy: Ausgewählt.
    - Default: (Optional, wird angezeigt, wenn Supports Install on Deploy ausgewählt ist.) Wählen Sie diese Option, um Pakete während der Bereitstellung automatisch zu installieren.
3. Klicken Sie auf die Schaltfläche Save und schließen Sie dann das Popup Environment.

Durchführen einer One-Click-Bereitstellung

Führen Sie folgende Schritte aus, um die One-Click-Deploy-Funktion zu verwenden:

Erstellen Sie ein Release:
1. Wählen Sie IDE > Create Release.
2. Wählen Sie die Registerkarte Create a Release.
3. Klicken Sie auf die Schaltfläche + Solution.
4. Verwenden Sie den Assistenten Solution, um zu definieren, was bereitgestellt werden soll.
Erstellen Sie die Solution:
1. Klicken Sie auf die Schaltfläche Build für die neue Release-Vorlage.
Geben Sie das Release frei:
1. Warten Sie auf eine App Builder-Benachrichtigung, die besagt, dass der Build abgeschlossen ist.
2. Führen Sie einen der folgenden Schritte aus:
  1. Klicken Sie auf die Schaltfläche Release anzeigen der Benachrichtigung. Die Registerkarte Alle Releases wird geöffnet.
  2. Schließen Sie die Benachrichtigung, und wählen Sie dann die Registerkarte Alle Releases aus.
3. Klicken Sie auf die Schaltfläche Bereitstellen für die erstellte Lösung.
4. Wenn Standard für Unterstützt Bereitstellung und Unterstützt Installation bei Bereitstellung in der Zielumgebung aktiviert ist, ist keine weitere Maßnahme erforderlich.
  
  Andernfalls fahren Sie mit den folgenden Schritten fort:
  1. Öffnen Sie im Popup Release bereitstellen das Menü Umgebung, und wählen Sie dann die Zielumgebung aus.
  2. Aktivieren Sie das Kontrollkästchen Installation bei Bereitstellung.
  3. Klicken Sie auf die Schaltfläche Bereitstellen.

Bestätigen Sie, dass ein Release bereitgestellt wurde

Nach einer Ein-Klick-Bereitstellung können Sie wie folgt überprüfen, ob das Release bereitgestellt wurde:

Melden Sie sich bei der Zielumgebung an.
Navigieren Sie zu IDE > Release installieren.
Überprüfen Sie, ob das Paket vorhanden ist und installiert wurde.