Diese Seite wurde von der Cloud Translation API übersetzt.

Mit Callbacks und Eventarc-Triggern auf Ereignisse warten

Ihr Workflow muss möglicherweise auf einen externen Prozess warten. Sie können HTTP-Rückrufe, die gewartet werden soll, einen anderen Dienst, um eine Anfrage an einen Callback-Endpunkt zu senden. wird diese Anfrage fortgesetzt. die Ausführung des Workflows. Sie können auch mithilfe von Abfragen warten.

Anstatt Polling zu verwenden, wird in dieser Anleitung gezeigt, wie Sie mithilfe von HTTP-Callbacks und Eventarc-Triggern auf Ereignisse oder Pub/Sub-Nachrichten warten können. Auch wenn Sie einen Workflow mit Ereignissen oder Pub/Sub-Nachrichten auslösen, können Sie die Ausführung anhalten, um auf ein anderes Ereignis zu warten, wird fortgesetzt. Beispiel: Ein Ereignis löst einen Workflow aus, um einen Prozess zu starten, aber der Workflow muss auf ein weiteres Ereignis warten, das signalisiert, dass der Prozess abgeschlossen ist. Sie können dies implementieren, indem ein Workflow einen anderen aufruft. zu optimieren.

Lernziele

In dieser Anleitung geschieht Folgendes:

Ein primärer Workflow, der auf Ereignisse warten muss, wird bereitgestellt und ausgeführt. Da er warten muss, bis die Ereignisse eintreten, speichert er seine Callback-Details in einem Firestore-Datenbank, damit der sekundäre Workflow die Details. Der primäre Workflow wartet dann auf die HTTP-Aufrufe.
Durch die Ereignisse wird ein sekundärer Workflow ausgelöst und ruft den Callback-Details aus der Firestore-Datenbank, generiert werden. Der sekundäre Workflow ruft dann den primären Workflow auf, und setzt die Ausführung fort.

Hier eine Übersicht über den gesamten Prozess:

Mit Callbacks und einem primären und sekundären Workflow auf Ereignisse warten

Primärer Workflow:

Mit einem callback-event-sample-Workflow werden Rückrufendpunkte für zwei Ereignisquellen erstellt: ein Pub/Sub-Thema und ein Cloud Storage-Bucket.
Dieser Workflow speichert beide Callback-Endpunkte in einem Firestore. Dokument.
Dieser Workflow hält seine Ausführung an und wartet auf den Eingang von HTTP-Anfragen die Callback-Endpunkte zugewiesen sind.

Ereignisse:

Ereignisse treten auf: Eine Nachricht wird in einem Pub/Sub-Thema veröffentlicht und eine Datei wird in einen Cloud Storage-Bucket hochgeladen.

Sekundärer Workflow:

Eventarc leitet die Ereignisse an den callback-event-listener-Workflow weiter und löst dessen Ausführung aus.
In diesem Workflow werden die entsprechenden Callback-Endpunkt-URLs aus dem Firestore-Dokument abgerufen.
In diesem Workflow werden die Rückrufe an die entsprechenden Endpunkte im Beispiel-Workflow ausgeführt.

Primärer Workflow:

Der callback-event-sample-Workflow empfängt die Ereignisse im und setzt die Ausführung fort.
In diesem Workflow werden die Rückruf-URLs aus dem Firestore-Dokument gelöscht und die Ausführung abgeschlossen.

Kosten

In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:

Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen. Neuen Google Cloud-Nutzern steht möglicherweise eine kostenlose Testversion zur Verfügung.

Hinweis

Sie können die folgenden Befehle in der Google Cloud Console ausführen oder den Befehl Google Cloud CLI entweder in Ihrem Terminal oder in Cloud Shell

Von Ihrer Organisation definierte Sicherheitsbeschränkungen verhindern möglicherweise, dass die folgenden Schritte ausgeführt werden. Informationen zur Fehlerbehebung finden Sie unter Anwendungen in einer eingeschränkten Google Cloud-Umgebung entwickeln.

Console

Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit ihm verknüpften Ressourcen entfernen.

Zur Projektauswahl
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.
Aktivieren Sie App Engine, Eventarc, Firestore, Pub/Sub und Workflows API.

Aktivieren Sie die APIs
Erstellen Sie ein Dienstkonto für Ihren Workflow, das zur Authentifizierung bei anderen Google Cloud-Diensten verwendet werden soll, und weisen Sie ihm die entsprechenden Rollen zu:
1. Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf:
  
  Zur Seite „Dienstkonten“
2. Wählen Sie Ihr Projekt aus, um die Seite Dienstkonto erstellen aufzurufen.
3. Geben Sie im Feld Dienstkontoname einen Namen ein. Die Google Cloud Console füllt das Feld Dienstkonto-ID anhand dieses Namens aus.
  
  Geben Sie im Feld Dienstkontobeschreibung eine Beschreibung ein. Beispiel: Service account for tutorial
4. Klicken Sie auf Erstellen und fortfahren.
5. Filtern Sie in der Liste Rolle auswählen nach den folgenden Rollen, die Sie dem nutzerverwalteten Dienstkonto zuweisen möchten, das Sie im vorherigen Schritt erstellt haben:
  - Cloud Datastore-Nutzer: Zugriff auf Daten in Firestore im Datastore-Modus (Datastore)
  - Eventarc Event Receiver (Empfänger von Eventarc-Ereignissen): zum Empfangen von Ereignissen von Ereignisanbietern
  - Log-Autor: zum Schreiben von Protokollen.
  - Workflow-Aufrufer: zum Ausführen von Workflows und zum Verwalten der Ausführungen.
  Klicken Sie auf Weitere Rolle hinzufügen, um weitere Rollen hinzuzufügen.
  
  Hinweis: Das Feld Rolle wirkt sich auf die Ressourcen Ihres Dienstkontos aus. auf die Sie in Ihrem Projekt zugreifen können. Sie können diese Rollen später widerrufen oder zusätzliche Rollen erteilen. Gewähren Sie in Produktionsumgebungen Inhaber-, Bearbeiter- oder Betrachterrolle Gewähren Sie stattdessen eine vordefinierte Rolle oder eine benutzerdefinierte Rolle, die Ihren Anforderungen entspricht.
6. Klicken Sie auf Weiter.
7. Klicken Sie zum Abschließen der Erstellung des Kontos auf Fertig.
Um einen Eventarc-Trigger zu erstellen, der Ereignisse Cloud Storage, Rolle „Pub/Sub-Publisher“ gewähren an den Cloud Storage-Dienst-Agent senden. Normalerweise ist dies service-PROJECT_NUMBER@gs-project-accounts.iam.gserviceaccount.com. Sie können die E-Mail-Adresse für den Cloud Storage-Dienst-Agent abrufen.
1. Öffnen Sie in der Google Cloud Console die Seite IAM.
  
  IAM aufrufen
2. Klicken Sie in der Zeile für den Cloud Storage-Dienst-Agent auf Hauptkonto bearbeiten. (Wenn der Dienst-Agent nicht aufgeführt ist, fahren Sie mit dem nächsten Schritt fort.) Der Bereich Zugriff bearbeiten wird geöffnet.
  1. Klicken Sie auf Weitere Rolle hinzufügen und suchen Sie nach der Rolle Pub/Sub Publisher.
  2. Wählen Sie die Rolle aus.
  3. Klicken Sie auf Speichern.
3. Wenn der Dienst-Agent nicht aufgeführt ist, klicken Sie auf Zugriff erlauben. Der Bereich Zugriff gewähren wird geöffnet.
  1. Geben Sie im Feld Neue Hauptkonten die E-Mail-Adresse des Dienst-Agents ein.
  2. Suchen Sie in der Liste Rolle auswählen nach der Rolle Pub/Sub-Publisher.
  3. Wählen Sie die Rolle aus.
  4. Klicken Sie auf Speichern.

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

Aktivieren Sie die App Engine API, die Eventarc API, die Firestore API, die Pub/Sub API und die Workflows API.

gcloud services enable \
    appengine.googleapis.com \
    eventarc.googleapis.com \
    firestore.googleapis.com \
    pubsub.googleapis.com \
    workflows.googleapis.com

Erstellen Sie ein Dienstkonto für Ihren Workflow zur Authentifizierung bei anderen Google Cloud-Diensten und weisen ihm die entsprechenden Rollen zu.
1. Erstellen Sie das Dienstkonto:
```
gcloud iam service-accounts create SERVICE_ACCOUNT_NAME
```
  Ersetzen Sie SERVICE_ACCOUNT_NAME durch einen Namen für das Dienstkonto.
2. Weisen Sie dem nutzerverwalteten Dienstkonto, das Sie im vorherigen Schritt erstellt haben, Rollen zu. Führen Sie den folgenden Befehl für jede der folgenden IAM-Rollen einmal aus:
  - roles/datastore.user: Zugriff auf Daten in Firestore im Datastore-Modus (Datastore)
  - roles/eventarc.eventReceiver: Ereignisse von Ereignisanbietern zu empfangen.
  - roles/logging.logWriter: Zum Schreiben von Logs.
  - roles/workflows.invoker: Zum Ausführen von Workflows und Verwalten des Ausführungen.
```
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \
    --role=ROLE
```
  Ersetzen Sie Folgendes:
  - PROJECT_ID: die Projekt-ID in dem Sie das Dienstkonto erstellt haben
  - ROLE: die zu gewährende Rolle
  Hinweis: Das Flag --role wirkt sich auf die Ressourcen Ihres Dienstkontos aus. auf die Sie in Ihrem Projekt zugreifen können. Sie können diese Rollen widerrufen oder später weitere Rollen. In Produktionsumgebungen sollten Sie die Inhaber-, Bearbeiter- und Betrachterrolle nicht zuweisen. Gewähren Sie stattdessen eine vordefinierte Rolle oder benutzerdefinierte Rolle, die Ihren Anforderungen.
Um einen Eventarc-Trigger zu erstellen, der Ereignisse Cloud Storage, Rolle „Pub/Sub-Publisher“ gewähren zu den Cloud Storage-Dienst-Agent. Normalerweise ist dies service-PROJECT_NUMBER@gs-project-accounts.iam.gserviceaccount.com. Verwenden Sie gcloud storage service-agent um zuerst den Cloud Storage-Dienst-Agent abzurufen.
```
SERVICE_ACCOUNT_STORAGE="$(gcloud storage service-agent --project=PROJECT_ID)"

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:$SERVICE_ACCOUNT_STORAGE \
    --role=roles/pubsub.publisher
```

Firestore-Datenbank erstellen

Firestore speichert Ihre Daten in Dokumenten, die Felder enthalten Werte zuordnen. Diese Dokumente werden in Sammlungen gespeichert, Container für Ihre Dokumente, mit denen Sie Ihre Daten organisieren und Abfragen. Weitere Informationen zu Firestore

Hinweis: Jedes Google Cloud-Projekt ist auf eine Firestore-Datenbank beschränkt. Führen Sie die folgenden Schritte aus, wenn Sie eine neue Datenbank erstellen müssen.

Console

Rufen Sie in der Google Cloud Console die Seite Einstieg von Firestore auf.

Zur Seite „Jetzt starten“
Klicken Sie auf Nativen Modus auswählen.

Weitere Informationen zum Auswählen des passenden Datenbankmodus sowie einen Funktionsvergleich finden Sie unter Zwischen nativem Modus und Datastore-Modus wechseln.
Wählen Sie in der Liste Standort auswählen die Option nam5 (USA) aus.

Der Standort gilt sowohl für die Firestore-Datenbank als auch der App Engine-Anwendung in Ihrem Google Cloud-Projekt. Nachdem Sie die Datenbank erstellt haben, können Sie den Speicherort nicht mehr ändern.
Klicken Sie auf Datenbank erstellen.

gcloud

Zum Erstellen einer Firestore-Datenbank müssen Sie zuerst eine erstellen: App Engine-Anwendung aus und führen Sie dann den gcloud firestore databases create Befehl:

gcloud app create --region=us-central
gcloud firestore databases create --region=us-central

Sie können die us-central is not a valid Firestore location-Warnung ignorieren. App Engine und Firestore unterstützen dieselben Standorte, Die App Engine-Region us-central (Iowa) wird jedoch Firestore nam5 (USA) multiregional.

Pub/Sub-Thema erstellen

In dieser Anleitung wird Pub/Sub als Ereignisquelle verwendet. Erstellen: Pub/Sub-Thema, damit Sie eine Nachricht darin veröffentlichen können. Weitere Informationen zum Erstellen und Verwalten von Themen

Console

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

Themen aufrufen
Klicken Sie auf Thema erstellen.
Geben Sie im Feld Themen-ID den Wert topic-callback ein.
Übernehmen Sie die anderen Standardeinstellungen.
Klicken Sie auf Thema erstellen.

gcloud

Führen Sie den Befehl gcloud pubsub topics create aus, um ein Thema zu erstellen:

gcloud pubsub topics create topic-callback

Cloud Storage-Bucket erstellen

In dieser Anleitung wird Cloud Storage als Ereignisquelle verwendet. Erstellen: Cloud Storage-Bucket, damit Sie eine Datei in ihn hochladen können. Weitere Informationen zum Erstellen von Storage-Buckets

Console

Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

Cloud Storage aufrufen
Klicken Sie auf Erstellen.
Geben Sie als Name des Buckets PROJECT_ID-bucket-callback ein.

Die Projekt-ID wird im callback-event-sample-Workflow verwendet, um den Bucket zu identifizieren.
Klicken Sie auf Weiter.
Wählen Sie als Standorttyp die Option Region und dann us-central1 (Iowa) aus.
Übernehmen Sie die anderen Standardeinstellungen.
Klicken Sie auf Erstellen.

gcloud

Führen Sie den Befehl gcloud storage buckets create aus, um einen Bucket zu erstellen:

gcloud storage buckets create gs://PROJECT_ID-bucket-callback \
    --location=us-central1

Die Projekt-ID wird im callback-event-sample-Workflow verwendet, um den Bucket zu identifizieren.

Nachdem die Ereignisquellen erstellt wurden, können Sie den Workflow für den Ereignisempfänger bereitstellen.

Workflow bereitstellen, der auf Ereignisse überwacht

Der callback-event-listener-Workflow wird ausgelöst, wenn eine Nachricht in einem Pub/Sub-Thema veröffentlicht oder eine Datei in einen Cloud Storage-Bucket hochgeladen wird. Der Workflow empfängt das Ereignis und ruft den entsprechenden Callback ab. Details aus der Firestore-Datenbank aus und sendet dann -Anfrage an den Callback-Endpunkt.

Console

Öffnen Sie in der Google Cloud Console die Seite Workflows.

Zur Seite "Workflows"
Klicken Sie auf Erstellen.
Geben Sie einen Namen für den neuen Workflow ein: callback-event-listener.
Wählen Sie in der Liste Region die Option us-central1 aus.
Wählen Sie das zuvor erstellte Dienstkonto aus.
Klicken Sie auf Weiter.

Geben Sie im Workflow-Editor die Definition für Ihren Workflow ein:

main:
  params: [event]
  steps:
    - log_event:
        call: sys.log
        args:
          text: ${event}
          severity: INFO
    - init:
        assign:
          - database_root: ${"projects/" + sys.get_env("GOOGLE_CLOUD_PROJECT_ID") + "/databases/(default)/documents/callbacks/"}
          - event_source_tokens: ${text.split(event.source, "/")}
          - event_source_len: ${len(event_source_tokens)}
          - event_source: ${event_source_tokens[event_source_len - 1]}
          - doc_name: ${database_root + event_source}
    - get_document_for_event_source:
        try:
          call: googleapis.firestore.v1.projects.databases.documents.get
          args:
            name: ${doc_name}
          result: document
        except:
            as: e
            steps:
                - known_errors:
                    switch:
                    - condition: ${e.code == 404}
                      return: ${"No callbacks for event source " + event_source}
                - unhandled_exception:
                    raise: ${e}
    - process_callback_urls:
        steps:
          - check_fields_exist:
              switch:
              - condition: ${not("fields" in document)}
                return: ${"No callbacks for event source " + event_source}
              - condition: true
                next: processFields
          - processFields:
              for:
                  value: key
                  in: ${keys(document.fields)}
                  steps:
                      - extract_callback_url:
                          assign:
                              - callback_url: ${document.fields[key]["stringValue"]}
                      - log_callback_url:
                          call: sys.log
                          args:
                            text: ${"Calling back url " + callback_url}
                            severity: INFO
                      - http_post:
                          call: http.post
                          args:
                              url: ${callback_url}
                              auth:
                                  type: OAuth2
                              body:
                                  event: ${event}

Klicken Sie auf Bereitstellen.

gcloud

Erstellen Sie eine Quellcodedatei für Ihren Workflow:
```
touch callback-event-listener.yaml
```

Kopieren Sie in einem Texteditor den folgenden Workflow in Ihre Quellcodedatei:

main:
  params: [event]
  steps:
    - log_event:
        call: sys.log
        args:
          text: ${event}
          severity: INFO
    - init:
        assign:
          - database_root: ${"projects/" + sys.get_env("GOOGLE_CLOUD_PROJECT_ID") + "/databases/(default)/documents/callbacks/"}
          - event_source_tokens: ${text.split(event.source, "/")}
          - event_source_len: ${len(event_source_tokens)}
          - event_source: ${event_source_tokens[event_source_len - 1]}
          - doc_name: ${database_root + event_source}
    - get_document_for_event_source:
        try:
          call: googleapis.firestore.v1.projects.databases.documents.get
          args:
            name: ${doc_name}
          result: document
        except:
            as: e
            steps:
                - known_errors:
                    switch:
                    - condition: ${e.code == 404}
                      return: ${"No callbacks for event source " + event_source}
                - unhandled_exception:
                    raise: ${e}
    - process_callback_urls:
        steps:
          - check_fields_exist:
              switch:
              - condition: ${not("fields" in document)}
                return: ${"No callbacks for event source " + event_source}
              - condition: true
                next: processFields
          - processFields:
              for:
                  value: key
                  in: ${keys(document.fields)}
                  steps:
                      - extract_callback_url:
                          assign:
                              - callback_url: ${document.fields[key]["stringValue"]}
                      - log_callback_url:
                          call: sys.log
                          args:
                            text: ${"Calling back url " + callback_url}
                            severity: INFO
                      - http_post:
                          call: http.post
                          args:
                              url: ${callback_url}
                              auth:
                                  type: OAuth2
                              body:
                                  event: ${event}

Stellen Sie den Workflow bereit. Geben Sie hierzu den folgenden Befehl ein:

gcloud workflows deploy callback-event-listener \
    --source=callback-event-listener.yaml \
    --location=us-central1 \
    --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

Ersetzen Sie SERVICE_ACCOUNT_NAME durch den Namen von das zuvor erstellte Dienstkonto.

Workflow bereitstellen, der auf Ereignisse wartet

Der callback-event-sample-Workflow speichert die Rückrufdetails in einer Firestore-Datenbank, hält die Ausführung an und wartet dann auf bestimmte Ereignisse.

Console

Rufen Sie in der Google Cloud Console die Seite Workflows auf. Seite:

Zur Seite "Workflows"
Klicken Sie auf Erstellen.
Geben Sie einen Namen für den neuen Workflow ein: callback-event-sample.
Wählen Sie in der Liste Region die Option us-central1 aus.
Wählen Sie das zuvor erstellte Dienstkonto aus.
Klicken Sie auf Weiter.

Geben Sie im Workflow-Editor die Definition für Ihren Workflow ein:

main:
  steps:
    - init:
        assign:
          - pubsub_topic: topic-callback
          - storage_bucket: ${sys.get_env("GOOGLE_CLOUD_PROJECT_ID") + "-bucket-callback"}
    - await_pubsub_message:
        call: await_callback_event
        args:
          event_source: ${pubsub_topic}
        result: pubsub_event
    - await_storage_bucket:
        call: await_callback_event
        args:
          event_source: ${storage_bucket}
        result: storage_event
    - return_events:
        return:
            pubsub_event: ${pubsub_event}
            storage_event: ${storage_event}

await_callback_event:
    params: [event_source]
    steps:
        - init:
            assign:
              - database_root: ${"projects/" + sys.get_env("GOOGLE_CLOUD_PROJECT_ID") + "/databases/(default)/documents/callbacks/"}
              - doc_name: ${database_root + event_source}
              - execution_id: ${sys.get_env("GOOGLE_CLOUD_WORKFLOW_EXECUTION_ID")}
              - firestore_key: ${"exec_" + text.split(execution_id, "-")[0]}
        - create_callback:
            call: events.create_callback_endpoint
            args:
              http_callback_method: POST
            result: callback_details
        - save_callback_url:
            call: googleapis.firestore.v1.projects.databases.documents.patch
            args:
              name: ${doc_name}
              updateMask:
                fieldPaths: ["${firestore_key}"]
              body:
                fields:
                  ${firestore_key}:
                    stringValue: ${callback_details.url}
        - log_and_await_callback:
            try:
              steps:
                - log_await_start:
                    call: sys.log
                    args:
                      severity: INFO
                      data: ${"Started waiting 1hr for an event from source " + event_source}
                - await_callback:
                    call: events.await_callback
                    args:
                      callback: ${callback_details}
                      timeout: 3600
                    result: callback_request
                - log_await_stop:
                    call: sys.log
                    args:
                      severity: INFO
                      data: ${"Stopped waiting for an event from source " + event_source}
            except:
                as: e
                steps:
                    - log_error:
                        call: sys.log
                        args:
                            severity: "ERROR"
                            text: ${"Received error " + e.message}
        - delete_callback_url:
            call: googleapis.firestore.v1.projects.databases.documents.patch
            args:
              name: ${doc_name}
              updateMask:
                fieldPaths: ["${firestore_key}"]
        - check_null_event:
            switch:
              - condition: ${callback_request == null}
                return: null
        - log_await_result:
            call: sys.log
            args:
              severity: INFO
              data: ${callback_request.http_request.body.event}
        - return_event:
            return: ${callback_request.http_request.body.event}

Klicken Sie auf Bereitstellen.

gcloud

Erstellen Sie eine Quellcodedatei für Ihren Workflow:
```
touch callback-event-sample.yaml
```

Kopieren Sie in einem Texteditor den folgenden Workflow in Ihre Quellcodedatei:

main:
  steps:
    - init:
        assign:
          - pubsub_topic: topic-callback
          - storage_bucket: ${sys.get_env("GOOGLE_CLOUD_PROJECT_ID") + "-bucket-callback"}
    - await_pubsub_message:
        call: await_callback_event
        args:
          event_source: ${pubsub_topic}
        result: pubsub_event
    - await_storage_bucket:
        call: await_callback_event
        args:
          event_source: ${storage_bucket}
        result: storage_event
    - return_events:
        return:
            pubsub_event: ${pubsub_event}
            storage_event: ${storage_event}

await_callback_event:
    params: [event_source]
    steps:
        - init:
            assign:
              - database_root: ${"projects/" + sys.get_env("GOOGLE_CLOUD_PROJECT_ID") + "/databases/(default)/documents/callbacks/"}
              - doc_name: ${database_root + event_source}
              - execution_id: ${sys.get_env("GOOGLE_CLOUD_WORKFLOW_EXECUTION_ID")}
              - firestore_key: ${"exec_" + text.split(execution_id, "-")[0]}
        - create_callback:
            call: events.create_callback_endpoint
            args:
              http_callback_method: POST
            result: callback_details
        - save_callback_url:
            call: googleapis.firestore.v1.projects.databases.documents.patch
            args:
              name: ${doc_name}
              updateMask:
                fieldPaths: ["${firestore_key}"]
              body:
                fields:
                  ${firestore_key}:
                    stringValue: ${callback_details.url}
        - log_and_await_callback:
            try:
              steps:
                - log_await_start:
                    call: sys.log
                    args:
                      severity: INFO
                      data: ${"Started waiting 1hr for an event from source " + event_source}
                - await_callback:
                    call: events.await_callback
                    args:
                      callback: ${callback_details}
                      timeout: 3600
                    result: callback_request
                - log_await_stop:
                    call: sys.log
                    args:
                      severity: INFO
                      data: ${"Stopped waiting for an event from source " + event_source}
            except:
                as: e
                steps:
                    - log_error:
                        call: sys.log
                        args:
                            severity: "ERROR"
                            text: ${"Received error " + e.message}
        - delete_callback_url:
            call: googleapis.firestore.v1.projects.databases.documents.patch
            args:
              name: ${doc_name}
              updateMask:
                fieldPaths: ["${firestore_key}"]
        - check_null_event:
            switch:
              - condition: ${callback_request == null}
                return: null
        - log_await_result:
            call: sys.log
            args:
              severity: INFO
              data: ${callback_request.http_request.body.event}
        - return_event:
            return: ${callback_request.http_request.body.event}

Stellen Sie den Workflow bereit. Geben Sie hierzu den folgenden Befehl ein:

gcloud workflows deploy callback-event-sample \
    --source=callback-event-sample.yaml \
    --location=us-central1 \
    --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

Ersetzen Sie SERVICE_ACCOUNT_NAME durch den Namen von das zuvor erstellte Dienstkonto.

Eventarc-Trigger zum Weiterleiten von Pub/Sub-Ereignissen erstellen

Mit einem Eventarc-Trigger können Sie Ereignisse weiterleiten, indem Sie Filter für den Trigger festlegen, einschließlich der Ereignisquelle und des Zielworkflows. Erstellen Sie einen Eventarc-Trigger, um den callback-event-listener-Workflow auszuführen, wenn eine Nachricht in einem Pub/Sub-Thema veröffentlicht wird. Weitere Informationen zum Auslösen eines Workflows

Console

Rufen Sie in der Google Cloud Console die Seite Eventarc auf.

Zu Eventarc
Klicken Sie auf Trigger erstellen.
Geben Sie einen Triggernamen ein.

Beispiel: trigger-pubsub-events-listener.
Wählen Sie in der Liste Ereignisanbieter die Option Cloud Pub/Sub aus.
Wählen Sie in der Liste Ereignis unter Benutzerdefiniert die Option google.cloud.pubsub.topic.v1.messagePublished aus.
Wählen Sie in der Liste Cloud Pub/Sub-Thema auswählen das zuvor erstellte Thema aus.
Wählen Sie in der Liste Region die Option us-central1 (Iowa) aus.
Wenn Sie dazu aufgefordert werden, weisen Sie dem Pub/Sub-Dienstkonto die Rolle iam.serviceAccountTokenCreator zu.
Wählen Sie das zuvor erstellte Dienstkonto aus.
Wählen Sie in der Liste Ereignisziel die Option Workflows aus.
Wählen Sie in der Liste Workflow auswählen den Workflow callback-event-listener aus.
Klicken Sie auf Erstellen.

gcloud

Führen Sie zum Erstellen eines Triggers den Befehl gcloud eventarc triggers create Befehl:

gcloud eventarc triggers create trigger-pubsub-events-listener \
    --location=us-central1 \
    --destination-workflow=callback-event-listener \
    --destination-workflow-location=us-central1 \
    --event-filters="type=google.cloud.pubsub.topic.v1.messagePublished" \
    --transport-topic=topic-callback \
    --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

Ereignisse werden umgewandelt und als Laufzeitargumente an die Workflowausführung übergeben. Es kann bis zu zwei Minuten dauern, bis der neue Trigger aktiv ist.

Eventarc-Trigger erstellen, um Cloud Storage-Ereignisse weiterzuleiten

Mit einem Eventarc-Trigger können Sie Ereignisse weiterleiten, indem Sie Filter für den Trigger, einschließlich Ereignisquelle und Zielworkflow. Erstellen Sie einen Eventarc-Trigger, um den Workflow callback-event-listener auszuführen, wenn eine Datei in einen Cloud Storage-Bucket hochgeladen wird. Weitere Informationen zum Auslösen eines Workflows

Console

Rufen Sie in der Google Cloud Console Eventarc auf. Seite.

Zu Eventarc
Klicken Sie auf Trigger erstellen.
Geben Sie einen Triggernamen ein.

Beispiel: trigger-storage-events-listener.
Wählen Sie im Feld Ereignisanbieter die Option Cloud Storage aus.
Wählen Sie in der Liste Ereignis unter Direkt die Option google.cloud.storage.object.v1.finalized aus.
Suchen Sie in der Liste Bucket nach dem zuvor erstellten Bucket und wählen Sie ihn aus.
Akzeptieren Sie in der Liste Region die Standardeinstellung us-central1 (Iowa), die auf Ihrem Cloud Storage-Bucket basiert.
Wenn Sie dazu aufgefordert werden, weisen Sie dem Pub/Sub-Dienstkonto die Rolle iam.serviceAccountTokenCreator zu.
Wählen Sie das zuvor erstellte Dienstkonto aus.
Wählen Sie in der Liste Ereignisziel die Option Workflows aus.
Wählen Sie in der Liste Workflow auswählen den Workflow callback-event-listener aus.
Klicken Sie auf Erstellen.

gcloud

Führen Sie zum Erstellen eines Triggers den Befehl gcloud eventarc triggers create Befehl:

gcloud eventarc triggers create trigger-storage-events-listener \
    --location=us-central1 \
    --destination-workflow=callback-event-listener \
    --destination-workflow-location=us-central1 \
    --event-filters="type=google.cloud.storage.object.v1.finalized" \
    --event-filters="bucket=PROJECT_ID-bucket-callback" \
    --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

Ereignisse werden umgewandelt und als Laufzeitargumente an die Workflowausführung übergeben. Es kann bis zu zwei Minuten dauern, bis der neue Trigger aktiv ist.

Primären Workflow ausführen

Bei der Ausführung eines Workflows wird die aktuelle Workflowdefinition ausgeführt, die dem Workflow zugeordnet ist. Führen Sie den Workflow callback-event-sample aus. Dies ist der primäre Workflow. Er wartet auf bestimmte Ereignisse und setzt die Ausführung erst fort, wenn der sekundäre Workflow die entsprechenden Callback-Anfragen stellt.

Console

Öffnen Sie in der Google Cloud Console die Seite Workflows.

Zur Seite "Workflows"
Klicken Sie auf der Seite Workflows auf das callback-event-sample-Workflow, um die zugehörige Detailseite aufzurufen.
Klicken Sie auf der Seite Workflow-Details auf Ausführen.
Klicken Sie noch einmal auf Ausführen.

Die Workflowausführung wird gestartet. Während der Ausführung sollte der Ausführungsstatus Running und ein Protokolleintrag ähnlich dem folgenden angezeigt werden: Started waiting 1hr for an event from source topic-callback.

gcloud

Um einen Workflow auszuführen, führen Sie den gcloud workflows run-Befehl:

gcloud workflows run callback-event-sample \
    --location=us-central1

Die Workflowausführung wird gestartet. Während der Ausführung sollten Sie einen Ausführungsstatus ähnlich dem folgenden:

Waiting for execution [a848a164-268a-449c-b2fe-396f32f2ed66] to complete...working...

Ereignisse generieren und den Ausführungsstatus prüfen

Sie können prüfen, ob die Ergebnisse wie erwartet sind, indem Sie Ereignisse generieren, Protokolleinträge ansehen und den Status der Workflowausführung prüfen.

Nachricht veröffentlichen

Veröffentlichen Sie eine Nachricht in dem Pub/Sub-Thema, das Sie zuvor erstellt haben. erstellt.

Console

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

Themen aufrufen
Klicken Sie auf topic-callback.
Klicken Sie auf den Tab Nachrichten.
Klicken Sie auf Nachricht veröffentlichen.
Geben Sie im Feld Nachrichtentext Hello World ein.
Klicken Sie auf Veröffentlichen.

gcloud

Veröffentlichen Sie eine Nachricht mit dem Befehl gcloud pubsub topics publish:

gcloud pubsub topics publish topic-callback \
    --message="Hello World"

Objekt hochladen

Laden Sie eine Datei in den zuvor erstellten Cloud Storage-Bucket hoch.

Console

Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

Buckets aufrufen
Klicken Sie auf den Namen des zuvor erstellten Buckets.
Führen Sie auf dem Tab Objekte einen der folgenden Schritte aus:
- Ziehen Sie die gewünschte Datei per Drag-and-drop von Ihrem Desktop oder Dateimanager hierher. zum Hauptbereich der Google Cloud Console.
- Klicken Sie auf Dateien hochladen, wählen Sie die Datei aus, die Sie hochladen möchten. Klicken Sie dann auf Öffnen.

gcloud

Um eine Datei hochzuladen, führen Sie den gcloud storage cp aus. Befehl:

gcloud storage cp OBJECT_LOCATION gs://PROJECT_ID-bucket-callback/

Ersetzen Sie OBJECT_LOCATION durch den lokalen Pfad zu Ihrem Objekt. Beispiel: random.txt.

Logeinträge und Ausführungsstatus ansehen

Prüfen Sie, ob der callback-event-sample-Workflow erfolgreich abgeschlossen wurde.

Console

Öffnen Sie in der Google Cloud Console die Seite Workflows.

Zur Seite "Workflows"
Klicken Sie auf der Seite Workflows auf den Workflow callback-event-sample, um die Detailseite aufzurufen.
So rufen Sie auf der Seite Workflowdetails die Details für klicken Sie auf die entsprechende Ausführungs-ID.

Der Ausführungsstatus sollte Erfolgreich lauten. Im Bereich „Ausgabe“ sollten die empfangenen Pub/Sub- und Cloud Storage-Ereignisse angezeigt werden.

gcloud

Filtern Sie die Logeinträge und geben Sie die Ausgabe im JSON-Format zurück:

gcloud logging read "resource.type=workflows.googleapis.com/Workflow AND textPayload:calling OR textPayload:waiting" \
    --format=json

Suchen Sie nach Logeinträgen wie dem folgenden:

"textPayload": "Stopped waiting for an event from source..."
"textPayload": "Calling back url https://workflowexecutions.googleapis.com/v1/projects/..."
"textPayload": "Started waiting 1hr for an event from source..."

Prüfen Sie den Status des letzten Ausführungsversuchs:

gcloud workflows executions wait-last

Das Ergebnis sollte in etwa so aussehen:

Using cached execution name: projects/1085953646031/locations/us-central1/workflows/callback-event-sample/executions/79929e4e-82c1-4da1-b068-f828034c01b7
Waiting for execution [79929e4e-82c1-4da1-b068-f828034c01b7] to complete...done.
[...]
state: SUCCEEDED

Bereinigen

Wenn Sie ein neues Projekt für diese Anleitung erstellt haben, löschen Sie das Projekt. Wenn Sie ein vorhandenes Projekt verwendet haben und es beibehalten möchten, ohne die Änderungen in dieser Anleitung hinzuzufügen, löschen Sie die für die Anleitung erstellten Ressourcen.

Projekt löschen

Am einfachsten vermeiden Sie weitere Kosten durch Löschen des für die Anleitung erstellten Projekts.

So löschen Sie das Projekt:

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

In dieser Anleitung erstellte Ressourcen löschen

Nächste Schritte

Probieren Sie die Anleitung Human-in-the-Loop-Workflow mithilfe von Callbacks erstellen aus.