CICD für Ihre Integration erstellen

In dieser Anleitung wird beschrieben, wie Sie das Hochstufen einer Integration zwischen verschiedenen Umgebungen in verschiedenen Google Cloud-Projekten mithilfe von Konfigurationsvariablen automatisieren.

Hinweis: Sie können keine Konfigurationsvariablen verwenden, um Entitätsvorgänge und ‑aktionen für Connectors zu konfigurieren.

Tipp: Informationen zum Speichern von Integrations- und Connector-Assets in einem Quellcode-Repository, zum Übertragen von Änderungen in andere Umgebungen und zum Automatisieren solcher Bereitstellungen finden Sie im Blog CICD für Application Integration.

Übersicht

In dieser Anleitung automatisieren Sie Application Integration-Bereitstellungen mithilfe einer Konfigurationsvariable für eine Beispielintegration. In diesem Beispiel-Integrationsablauf wird eine API aufgerufen und die Antwort der API in einem Pub/Sub-Thema veröffentlicht. Dieses Beispiel soll die Verwendung der Aufgaben REST-Endpunkt aufrufen und Connectors veranschaulichen. Sie können die Beispielintegration in GitHub-Repositories speichern, die den verschiedenen Umgebungen und Google Cloud -Projekten entsprechen.

Ziele

In dieser Anleitung erfahren Sie, wie Sie die folgenden Aufgaben in Ihrer Integration ausführen:

• Erstellen Sie eine Integration.
• Konfigurationsvariablen erstellen und in Ihrer Integration verwenden.
• Integration in eine andere Umgebung hochstufen.

Kosten

In dieser Anleitung verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:

• Application Integration
• Integration Connectors

Die Anleitungen in diesem Tutorial wurden so gestaltet, dass Ihre Ressourcennutzung innerhalb der Limits des kostenlosen Cloud-Angebots und des Testangebots von Google Cloud bleibt.

Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.

Hinweis

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. Enable the Secret Manager API, Connectors API APIs, if any are not already enabled.

   Roles required to enable APIs

   To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

   Enable the APIs

4. Create a service account:

   1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator) and the Project IAM Admin role (roles/resourcemanager.projectIamAdmin). Learn how to grant roles.

   2. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   3. Select your project.

   4. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   5. Click Create and continue.

   6. Grant the Pub/Sub Publisher (roles/pubsub.publisher) role to the service account.

      To grant the role, find the Select a role list, then select Pub/Sub Publisher (roles/pubsub.publisher).

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
   7. Click Continue.

   8. Click Done to finish creating the service account.

Pub/Sub-Thema erstellen

1. Öffnen Sie in der Google Cloud Console die Pub/Sub-Seite Themen.

   Themen aufrufen

2. Klicken Sie auf Thema erstellen.

3. Geben Sie im Feld Themen-ID eine ID für das Thema ein. Weitere Informationen zum Benennen von Themen finden Sie unter Richtlinien für die Benennung eines Themas, Abos, Schemas oder Snapshots.

4. Behalten Sie die Option Standardabo hinzufügen bei.

5. Wählen Sie nicht die anderen Optionen aus.

6. Klicken Sie auf Thema erstellen.

Pub/Sub-Connector konfigurieren

1. Rufen Sie in der Google Cloud Console die Seite Integration Connectors > Verbindungen auf und wählen Sie ein Google Cloud -Projekt aus oder erstellen Sie eines.

   Zur Seite „Verbindungen“

2. Klicken Sie auf + Neu erstellen, um die Seite Verbindung erstellen zu öffnen.
3. Wählen Sie im Abschnitt Standort den Standort für die Verbindung aus.
   1. Region: Wählen Sie einen Standort aus der Drop-down-Liste aus.

      Eine Liste aller unterstützten Regionen finden Sie unter Standorte.

   2. Tippen Sie auf Weiter.
4. Führen Sie im Abschnitt Verbindungsdetails folgende Schritte aus:
   1. Connector: Wählen Sie Pub/Sub aus der Drop-down-Liste der verfügbaren Connectors aus.
   2. Connector-Version: Wählen Sie die Connector-Version aus der Drop-down-Liste der verfügbaren Versionen aus.
   3. Geben Sie im Feld Verbindungsname pub-sub-connector ein.
   4. Dienstkonto: Wählen Sie ein Dienstkonto, das über die erforderlichen Rollen verfügt.
   5. Projekt-ID: Google Cloud -Projekt-ID, in der sich die Pub/Sub-Instanz befindet.
   6. Themen-ID: Geben Sie den Namen Ihres Pub/Sub-Themas ein.
   7. Klicken Sie auf Weiter.
5. Klicken Sie im Abschnitt Authentifizierung auf WEITER.
6. Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
7. Klicken Sie auf Erstellen.

Neue Integration erstellen

Nachdem Sie Application Integration eingerichtet haben, können Sie eine neue Integration erstellen:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zu Application Integration

2. Klicken Sie im linken Navigationsmenü auf Integrationen, um die Seite Integrationen zu öffnen.
3. Klicken Sie auf Integration erstellen und geben Sie auf der Seite Integration erstellen die folgenden Details an:
   1. Name der Integration: Geben Sie einen Namen für die Integration ein. Beispiel: build-cicd.
   2. Beschreibung: Geben Sie optional eine Beschreibung für die Integration ein. Beispiel: Demo integration created for CICD tutorial.
   3. Region: Wählen Sie die Region us-central1 aus der Liste der bereitgestellten Regionen aus. Wenn die Region, die Sie auswählen möchten, nicht bereitgestellt ist, lesen Sie den Abschnitt Neue Region bereitstellen. Eine Liste der unterstützten Regionen finden Sie unter Application Integration-Standorte.
   4. Dienstkonto: Dieses Feld wird angezeigt, wenn Sie die Governance für Ihre Region aktiviert haben. Wählen Sie das Dienstkonto für Ihre Integration aus. Informationen zum Aktivieren der Governance für Ihre Region finden Sie unter Region bearbeiten.
   5. Klicken Sie auf Erstellen. Dadurch wird die Seite „Integrationseditor“ geöffnet, auf der Sie die Aufgaben und Trigger hinzufügen können, um Ihre Integration zu erstellen.

Integrationsablauf erstellen

API-Trigger und „REST-Endpunkt aufrufen“ hinzufügen

Führen Sie die folgenden Schritte aus, um einen API-Trigger hinzuzufügen:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zu Application Integration

2. Klicken Sie im Navigationsmenü auf Integrationen.

   Die Seite Integrationsliste wird angezeigt. Dort sind alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.

3. Wählen Sie die Integration build-cicd aus.

   Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger > API-Trigger, um den Trigger hinzuzufügen.
5. Klicken Sie in der Navigationsleiste des Integrationseditors auf Aufgaben > REST-Endpunkt aufrufen, um die Aufgabe hinzuzufügen.
6. Fügen Sie eine Edge-Verbindung aus dem Element API-Trigger dem Element REST-Endpunkt aufrufen hinzu. Dazu bewegen Sie den Mauszeiger auf einen Steuerungspunkt des Elements API-Trigger. Klicken Sie dann auf eine Zeile und ziehen Sie sie an einen Steuerungspunkt im Aufgabenelement REST-Endpunkt aufrufen.

Konfigurationsvariablen erstellen

So erstellen Sie Konfigurationsvariablen:

1. Klicken Sie in der Navigationsleiste des Integrationseditors auf (Bereich ein-/ausblenden), um den Bereich Variablen aufzurufen.
2. Klicken Sie auf +Erstellen.
3. Gehen Sie im Bereich Variable erstellen so vor:
   1. Geben Sie für Name url ein.

      Application Integration fügt den Konfigurationsvariablen das Präfix `CONFIG_ hinzu. Wenn Sie die Konfigurationsvariable mithilfe von APIs zu Ihrer Integration hinzufügen möchten, verwenden Sie das folgende Format für Konfigurationsvariablen: `CONFIG_CONFIG_VARIABLE_NAME`. Informationen zum Herunterladen und Hochladen von Integrationen finden Sie unter Integrationen hochladen und herunterladen.

   2. Wählen Sie als Variablentyp die Option Konfigurationsvariable aus.
   3. Wählen Sie für Datentyp die Option String aus.
   4. Klicken Sie auf Erstellen.

      Die Konfigurationsvariable wird im Bereich Variablen angezeigt.

4. Wiederholen Sie die Schritte 2 und 3, um die folgende Konfigurationsvariable hinzuzufügen:
   • Name: connection_name
   • Variablentyp: Config Variable
   • Datentyp: String

„REST-Endpunkt aufrufen“ hinzufügen und konfigurieren

So erstellen Sie eine Konfigurationsvariable:

1. Klicken Sie im Integrationseditor auf die Aufgabe REST-Endpunkt aufrufen, um den Bereich für die Aufgabenkonfiguration zu öffnen. Führen Sie anschließend folgende Schritte aus:
   1. Maximieren Sie den Bereich Aufgabeneingabe.
   2. Klicken Sie unter Basis-URL des Endpunkts auf Variable und fügen Sie $`CONFIG_url`$ hinzu.

Connectors-Aufgabe hinzufügen und konfigurieren

1. Klicken Sie in der Navigationsleiste des Integrationseditors auf Aufgabe > Connectors.
2. Klicken Sie auf Connectors konfigurieren.
3. Wählen Sie in der Liste Region die Region aus, in der Sie Ihren Pub/Sub-Connector erstellt haben.
4. Wählen Sie im Feld Verbindung den Pub/Sub-Connector aus, den Sie im vorherigen Schritt erstellt haben.
5. Wählen Sie im Bereich Typ die Option Aktionen aus.
6. Wählen Sie im Abschnitt Entitäten/Aktionen festlegen unter Aktionen die Option publishMessage aus.
7. Fügen Sie unter Standardwert den Standardwert für die Konfigurationsvariable hinzu.
8. Klicken Sie auf Erstellen.
9. Maximieren Sie im Konfigurationsbereich der Connectors-Aufgabe den Abschnitt Verbindungsdetails, um das folgende Feld zu aktualisieren:
   1. Klicken Sie im Feld Verbindungsname auf Variable und wählen Sie $`CONFIG_connection_name`$ aus.

Aufgabe „Datenabgleich“ hinzufügen

1. Klicken Sie in der Navigationsleiste des Integrationseditors auf Aufgabe > Datenabgleich.
2. Fügen Sie eine Edge-Verbindung vom Element REST-Endpunkt aufrufen zum Element Datenabgleich hinzu. Bewegen Sie dazu den Mauszeiger über einen Steuerungspunkt auf dem Element REST-Endpunkt aufrufen. Klicken Sie dann auf eine Linie und ziehen Sie sie an einen Steuerungspunkt im Aufgabenelement Datenabgleich.
3. Fügen Sie eine weitere Edge-Verbindung vom Element Datenabgleich zum Element Connectors hinzu. Bewegen Sie dazu den Mauszeiger auf einen Steuerungspunkt des Elements Datenabgleich. Klicken Sie dann auf eine Linie und ziehen Sie sie an einen Steuerungspunkt im Aufgabenelement Connectors.
4. Klicken Sie im Konfigurationsbereich der Aufgabe „Datenabgleich“ auf Datenabgleichseditor öffnen.
5. Ordnen Sie die Ausgabevariable der Aufgabe „REST-Endpunkt aufrufen“ der Eingabevariablen der Aufgabe „Connectors“ zu.

Integration veröffentlichen

So veröffentlichen Sie die Integration:

1. Klicken Sie in der Symbolleiste des Integrationseditors auf Veröffentlichen, um die Integration zu veröffentlichen.

   Das Dialogfeld Integration veröffentlichen wird angezeigt.

2. Geben Sie im Dialogfeld Integration veröffentlichen den Wert für die folgenden Konfigurationsvariablen ein:
   1. url: Geben Sie den Namen der Endpunkt-URL ein.
   2. connection_name: Geben Sie den Namen des Pub/Sub-Connectors ein, den Sie im vorherigen Schritt erstellt haben.
3. Klicken Sie auf Veröffentlichen.
4. Nachdem Sie Ihre Integration veröffentlicht haben, können Sie die Ausführungslogs der veröffentlichten Integration aufrufen und prüfen. Klicken Sie in der Symbolleiste des Integrationseditors auf Logs, um sich die Logs anzusehen.

Integration umgebungsübergreifend hochstufen

Wenn Sie Ihre Integration in verschiedenen Umgebungen bereitstellen möchten, können Sie das Open-Source-Tool integrationcli verwenden. Damit können Sie mit Application Integration APIs und Integration Connectors APIs interagieren. Mit diesem Tool können Sie Integrationsentitäten wie Integrationen, Authentifizierungskonfigurationen usw. verwalten. Informationen zum Generieren des Scaffolds für die Integration und zum Anwenden der vom Scaffold generierten Änderungen finden Sie im Community-Blog unter Einführung in integrationcli.

Sie können Änderungen auch über Umgebungen hinweg übertragen, indem Sie DevOps-Pipelines einrichten, z. B. mit Jenkins, GitLab, Cloud Build usw. Weitere Informationen finden Sie unter Integration in Cloud Build.

Wenn Sie integrationcli nicht verwenden möchten, können Sie die Integration manuell herunterladen und in ein neues Projekt hochladen. Sie müssen die Connectors im neuen Projekt manuell erstellen, da sie derzeit nicht heruntergeladen werden können. Wenn Sie die Integration in der neuen Umgebung veröffentlichen, können Sie in Application Integration Werte für die Konfigurationsvariablen eingeben.

Nächste Schritte

• Beispielintegrationen in GitHub ansehen
• Weitere Informationen zu Konfigurationsvariablen
• Weitere Informationen zum integrationcli-Tool