CICD für Ihre Integration erstellen

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

Übersicht

In dieser Anleitung automatisieren Sie Application Integration-Bereitstellungen mit einer Konfigurationsvariable 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.
  • Stufen Sie Ihre Integration in eine andere Umgebung hoch.

Kosten

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

Die Anleitungen in diesem Leitfaden wurden so gestaltet, dass Ihre Ressourcennutzung innerhalb der Limits der kostenlosen Cloud-Funktionen und des Testzeitraums 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. 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. Ö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 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. Gehen Sie in der Google Cloud Console zum Abschnitt Integration Connectors > Seite „Verbindungen“ Wählen Sie dann ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Seite „Verbindungen“

  2. Klicke 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 Connection Name (Verbindungsname) den Wert 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 Authentication (Authentifizierung) auf NEXT (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 Navigationsmenü auf Integrationen. Die Seite Integrationen wird angezeigt.
  3. Klicken Sie auf Create integration (Integration erstellen) und geben Sie auf der Seite Create Integration (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 wird, finden Sie weitere Informationen unter Neue Region bereitstellen. Eine Liste der unterstützten Regionen finden Sie unter Standorte für Anwendungsintegrationen.
    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. Dadurch wird die Seite mit dem Integrationseditor geöffnet, auf der du die Aufgaben und Trigger zum Erstellen deiner Integration hinzufügen kannst.

Integrationsablauf erstellen

API-Trigger und REST-Endpunkt zum 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 Integrations (Integrationen).

    Auf der Seite Integrationsliste werden alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.

  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 dem Element API-Trigger eine Edge-Verbindung hinzu. Rufen Sie das REST-Endpunktelement auf, indem Sie mit der Maus auf einen Kontrollpunkt im API-Trigger-Element zeigen. indem Sie auf eine Linie klicken und sie zu einem Kontrollpunkt im Aufgabenelement REST-Endpunkt aufrufen ziehen.

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.

      Application Integration fügt den Konfigurationsvariablen das Präfix `CONFIG_ hinzu. 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 als 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 zum 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 > 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 Bereich 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 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 > Datenzuordnung.
  2. Fügen Sie eine Edge-Verbindung vom Element Call REST Endpoint zum Datenzuordnungselement hinzu, indem Sie die Maus über einen Kontrollpunkt im Element REST-Endpunkt aufrufen bewegen und indem Sie auf eine Linie klicken und sie zu einem Kontrollpunkt im Aufgabenelement Datenzuordnung ziehen.
  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 Eingabevariable der Connectors-Aufgabe 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. Nachdem die Integration veröffentlicht wurde, können Sie die Ausführungsprotokolle der veröffentlichten Integration aufrufen und prüfen. Um Protokolle aufzurufen, klicken Sie in der Symbolleiste des Integrationseditors auf Logs.

Umgebungsübergreifende Integration fördern

Wenn Sie Ihre Integration umgebungsübergreifend fördern möchten, können Sie das integrationcli-Tool verwenden. Dabei handelt es sich um ein Open-Source-Tool, mit dem Sie mit Application Integration APIs und Integration Connectors APIs interagieren können. Mit diesem Tool können Sie Integrationselemente wie Integrationen und Authentifizierungskonfigurationen verwalten. Informationen dazu, wie Sie das Scaffold für die Integration erstellen und die durch das Scaffold generierten Änderungen anwenden, finden Sie im Community-Blog unter Einführung in integrationcli.

Sie können Änderungen auch umgebungsübergreifend fördern, indem Sie DevOps-Pipelines einrichten, z. B. mit Jenkins, GitLab, Cloud Build usw. Weitere Informationen finden Sie unter Einbindung 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