CICD für Ihre Integration erstellen

In dieser Anleitung wird beschrieben, wie Sie die Freigabe einer Integration zwischen verschiedenen Umgebungen in verschiedenen Google Cloud-Projekten mithilfe von Konfigurationsvariablen (Vorabversion) automatisieren.

Übersicht

In dieser Anleitung automatisieren Sie die Bereitstellungen von Application Integration mithilfe einer Konfigurationsvariablen für eine Beispielintegration. In diesem Beispiel für einen 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.

Lernziele

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

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

Kosten

In dieser Anleitung werden die folgenden kostenpflichtigen Komponenten von Google Cloud verwendet:

Die Anleitungen in diesem Leitfaden sind so konzipiert, dass Ihre Ressourcennutzung innerhalb der Limits von Google Cloud Kostenlose Cloud-Funktionen und Testangebot 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.

Hinweise

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Secret Manager API, Connectors API APIs.

    Enable the APIs

  5. Create a service account:

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

      Go to Create service account
    2. Select your project.

    3. 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.

    4. Click Create and continue.

    5. 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).

    6. Click Continue.

    7. Click Done to finish creating the service account.

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

    Go to project selector

  7. Make sure that billing is enabled for your Google Cloud project.

  8. Enable the Secret Manager API, Connectors API APIs.

    Enable the APIs

  9. Create a service account:

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

      Go to Create service account
    2. Select your project.

    3. 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.

    4. Click Create and continue.

    5. 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).

    6. Click Continue.

    7. Click Done to finish creating the service account.

Pub/Sub-Thema erstellen

  1. Rufen Sie in der Google Cloud Console die Seite Pub/Sub-Themen auf.

    Themen aufrufen

  2. Klicken Sie auf Thema erstellen.

  3. Geben Sie im Feld Themen-ID eine ID für das Thema ein. Weitere Informationen zur Benennung von Themen finden Sie unter Richtlinien für die Benennung von Themen, 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:Die 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 die 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 Navigationsmenü auf Integrationen. Die Seite Integrationen wird angezeigt.
  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 in der Liste der bereitgestellten Regionen die Region us-central1 aus. Wenn die gewünschte Region nicht bereitgestellt ist, lesen Sie den Hilfeartikel Neue Region bereitstellen. Eine Liste der unterstützten Regionen finden Sie unter Standorte für Application Integration.
    4. Dienstkonto: Dieses Feld wird angezeigt, wenn Sie die Verwaltung 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. Daraufhin wird die Seite „Integrationseditor“ geöffnet, auf der Sie die Aufgaben und Trigger hinzufügen können, um die 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 Liste der Integrationen wird angezeigt. Dort sind alle Integrationen aufgeführt, die im Google Cloud-Projekt verfügbar sind.

  3. Wählen Sie die build-cicd-Integration 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 vom Element API-Trigger zum Element REST-Endpunkt aufrufen hinzu. Bewegen Sie dazu den Mauszeiger auf einen Steuerungspunkt des Elements API-Trigger. Klicken Sie dann auf eine Linie 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 zu öffnen.
  2. Klicken Sie auf +Erstellen.
  3. Führen Sie im Bereich Variable erstellen die folgenden Schritte aus:
    1. Geben Sie für Name url ein.

      Bei der Anwendungsintegration wird den Konfigurationsvariablen das Präfix `CONFIG_ hinzugefügt. Wenn Sie die Konfigurationsvariable Ihrer Integration mithilfe von APIs 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 unter Variablentyp die Option Konfigurationsvariable aus.
    3. Wählen Sie unter 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 Aufgabenkonfigurationsbereich zu öffnen. Führen Sie anschließend folgende Schritte aus:
    1. Maximieren Sie den Bereich Aufgabeneingabe.
    2. Klicken Sie unter Endpunkt-Basis-URL 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 > Verbindungen.
  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 Aufgabe Connectors den Bereich 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 > Datenzuordnung.
  2. Fügen Sie eine Edge-Verbindung vom Element REST-Endpunkt aufrufen zum Element Datenabgleich hinzu. Bewegen Sie dazu den Mauszeiger auf 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 dem Element Connectors eine weitere Edge-Verbindung aus dem Element Datenabgleich mit der folgenden Edge-Bedingung hinzu:
  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 die Werte 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. Nach der Veröffentlichung Ihrer Integration 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 Protokolle anzusehen.

Umgebungsübergreifende Integration fördern

Wenn Sie Ihre Integration in verschiedenen Umgebungen bewerben möchten, können Sie das integrationcli-Tool verwenden. Dieses Open-Source-Tool ermöglicht die Interaktion mit Application Integration APIs und Integration Connectors APIs. Mit diesem Tool können Sie Integrationselemente wie Integrationen und Authentifizierungskonfigurationen 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 mehrere Umgebungen hinweg einführen, indem Sie DevOps-Pipelines einrichten, z. B. mit Jenkins, GitLab oder Cloud Build. Weitere Informationen finden Sie unter In Cloud Build einbinden.

Wenn Sie integrationcli nicht verwenden möchten, können Sie die Integration manuell herunterladen und in ein neues Projekt hochladen. Sie müssen die Anschlüsse 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 mit Application Integration Werte für die Konfigurationsvariablen eingeben.

Nächste Schritte