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 (Vorschau) automatisieren.

Übersicht

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

  • Integration erstellen
  • Konfigurationsvariablen erstellen und in der Integration verwenden.
  • Integration in eine andere Umgebung übertragen

Kosten

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

Die Anleitung in diesem Tutorial wurde so gestaltet, 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 Pub/Sub-Seite 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 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 Ihre 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 gewünschte Region 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 und enthält alle Integrationen, 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 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. 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 über APIs in Ihre Integration einfügen möchten, verwenden Sie das folgende Format: `CONFIG_CONFIG_VARIABLE_NAME`. Informationen zum Herunter- 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 unter Datentyp die Option String aus.
    4. Klicken Sie auf Erstellen.

      Die Konfigurationsvariable wird im Bereich Variablen angezeigt.

  4. Wiederholen Sie Schritt 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 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 Abschnitt 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 im 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 Name der Verbindung 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 Eingabevariable der Aufgabe „Connectors“ zu.

Integration veröffentlichen

So veröffentlichen Sie die Integration:
  1. Um die Integration zu veröffentlichen, klicken Sie in der Symbolleiste des Integrationseditors auf 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 Sie Ihre Integration erfolgreich 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 die Logs aufzurufen.

Integration umgebungsübergreifend fördern

Um Ihre Integration in verschiedenen Umgebungen zu bewerben, können Sie das integrationcli-Tool verwenden. Dieses Open-Source-Tool ermöglicht die Interaktion mit den Application Integration APIs und den Integration Connectors APIs. Mit diesem Tool können Sie Integrationseinheiten wie Integrationen und Authentifizierungskonfigurationen verwalten. Informationen zum Generieren des Gerüsts für die Integration und zum Anwenden der vom Gerüst generierten Änderungen finden Sie im Community-Blog unter Einführung in integrationcli.

Sie können Änderungen auch in verschiedenen Umgebungen übertragen, 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 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