Schnellstartanleitung: gcloud-Tool verwenden

In dieser Kurzanleitung erfahren Sie, wie Sie mit dem gcloud-Befehlszeilentool Ihren ersten Workflow erstellen, bereitstellen und ausführen. Der Beispielworkflow sendet eine Anfrage an eine Beispiel-API und verwendet die Antwort zum Erstellen und Senden einer Anfrage an eine öffentliche API. Der Workflow gibt die Antwort der zweiten API zurück.

Eine Liste aller Workflowsgcloud Befehle finden Sie im Abschnitt "Workflows"gcloud ToolReferenzseite , um die Option zu aktivieren.

Hinweis

  1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
  2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist.

  4. Installieren und initialisieren Sie das Cloud SDK.
  5. Aktivieren Sie die Workflows API.

    gcloud services enable workflows.googleapis.com
  6. Erstellen Sie das Dienstkonto. Ersetzen Sie [NAME] mit einem Namen für das Dienstkonto.

    gcloud iam service-accounts create [NAME]
  7. Weisen Sie dem Dienstkonto die Rolle roles/logging.logWriter zu.

    gcloud projects add-iam-policy-binding [PROJECT_ID] --member "serviceAccount:[NAME]@[PROJECT_ID].iam.gserviceaccount.com" --role "roles/logging.logWriter"

    Ersetzen Sie Folgendes:
    • [PROJECT_ID]: Ihre Projekt-ID.
    • [NAME]: Der Name des Dienstkontos, das Sie gerade erstellt haben.
    Hinweis: Über das Feld Rolle wird Ihr Dienstkonto für den Zugriff auf Ressourcen autorisiert. Weisen Sie die Rolle roles/logging.logWriter zu, um Logs an Cloud Logging zu senden. Wenn Sie eine Produktionsanwendung entwickeln, gewähren Sie immer die geringstmöglichen Rollen. Weitere Informationen finden Sie unter Dienstkonten Rollen zuweisen. Eine Liste der Workflows-Rollen finden Sie in der Referenz zur Zugriffssteuerung.

Workflow erstellen, bereitstellen und ausführen

  1. Erstellen Sie eine neue Datei mit dem Namen myFirstWorkflow.yaml oder myFirstWorkflow.json.

  2. Kopieren Sie eine der folgenden Optionen in die neue Datei und speichern Sie sie:

    YAML

    - getCurrentTime:
        call: http.get
        args:
          url: https://us-central1-workflowsample.cloudfunctions.net/datetime
        result: currentTime
    - readWikipedia:
        call: http.get
        args:
          url: https://en.wikipedia.org/w/api.php
          query:
            action: opensearch
            search: ${currentTime.body.dayOfTheWeek}
        result: wikiResult
    - returnResult:
        return: ${wikiResult.body[1]}

    JSON

    [
      {
        "getCurrentTime": {
          "call": "http.get",
          "args": {
            "url": "https://us-central1-workflowsample.cloudfunctions.net/datetime"
          },
          "result": "currentTime"
        }
      },
      {
        "readWikipedia": {
          "call": "http.get",
          "args": {
            "url": "https://en.wikipedia.org/w/api.php",
            "query": {
              "action": "opensearch",
              "search": "${currentTime.body.dayOfTheWeek}"
            }
          },
          "result": "wikiResult"
        }
      },
      {
        "returnResult": {
          "return": "${wikiResult.body[1]}"
        }
      }
    ]

    Dieser Workflow ruft eine Beispiel-API auf, um das aktuelle Datum abzurufen. Der Tag der Woche aus dieser Antwort wird an die Wikipedia API übergeben, wo innerhalb des aktuellen Tages des nach relevanten Artikeln auf Wikipedia gesucht wird. }Woche.

  3. Öffnen Sie ein Terminalfenster.

  4. Stellen Sie den Workflow mit dem folgenden Befehl bereit:

    gcloud workflows deploy myFirstWorkflow --source=myFirstWorkflow.yaml \
    --service-account=[NAME]@[PROJECT_ID].iam.gserviceaccount.com

    Dabei gilt:

    • .yaml: Ersetzen Sie .json durch die JSON-Version des Beispielworkflows.

    • [NAME]: Name des zuvor erstellten Dienstkontos

    • [PROJECT_ID]: Ihre Projekt-ID.

    Dieser Befehl stellt den Workflow bereit und verknüpft ihn mit dem angegebenen Dienstkonto.

  5. Führen Sie den Workflow mit folgendem Befehl aus:

    gcloud workflows execute myFirstWorkflow
    

    Dadurch wird ein workflows executions describe-Befehl mit der eindeutigen ID des Workflow-Ausführungsversuchs zurückgegeben. Die Ausgabe sieht etwa so aus:

    Created [cf1b1883-e271-4371-916a-10337bc1b87a].
    To view the workflow status, you can use following command:
    
    gcloud workflows executions describe cf1b1883-e271-4371-916a-10337bc1b87a --workflow myFirstWorkflow
    
  6. Geben Sie den vom vorherigen Schritt zurückgegebenen Befehl ein, um den Status der Ausführung aufzurufen. Dadurch werden Daten zur Ausführung des Workflows zurückgegeben, einschließlich des Ergebnisses:

    argument: 'null'
    endTime: '2020-06-23T16:21:35.266171131Z'
    name: projects/123456789012/locations/us-central1/workflows/myFirstWorkflow/executions/f72bc6d4-5ea0-4dfb-bb14-2dae82303120
    result: '["Tuesday","Tuesday Weld","Tuesday Night Music Club","Tuesday (ILoveMakonnen
      song)","Tuesdays with Morrie","Tuesday Group","Tuesday Knight","Tuesday (Burak Yeter
      song)","Tuesday Morning Quarterback","Tuesday Maybe"]'
    startTime: '2020-06-23T16:21:34.826993288Z'
    state: SUCCEEDED
    workflowVersionId: '1'
    

Sie haben Ihren ersten Workflow bereitgestellt und ausgeführt.

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die in dieser Kurzanleitung verwendeten Ressourcen in Rechnung gestellt werden:

  1. Löschen Sie den erstellten Workflow mit dem folgenden Befehl:

    gcloud workflows delete myFirstWorkflow
    
  2. Wenn Sie gefragt werden, ob Sie fortfahren möchten, geben Sie y ein.

Der Workflow wird gelöscht.

Nächste Schritte