Workflow ausführen

Console

1. Rufen Sie zum Ausführen eines Workflows in der Google Cloud Console die Seite Workflows auf:

   Zur Seite "Workflows"

2. Wählen Sie auf der Seite Workflows einen Workflow aus, um dessen Detailseite aufzurufen.

3. Klicken Sie auf der Seite Workflow-Details auf play_arrow Ausführen.

4. Auf der Seite Workflow ausführen können Sie im Bereich Eingabe optionale Laufzeitargumente eingeben, die vor der Ausführung an Ihren Workflow übergeben werden. Argumente müssen im JSON-Format vorliegen. Beispiel: {"animal":"cat"}. Wenn Ihr Workflow keine Laufzeitargumente verwendet, lassen Sie dieses Feld leer.

5. Geben Sie optional die Ebene des Aufruf-Logging an, die Sie auf die Ausführung des Workflows anwenden möchten. Wählen Sie in der Liste Anruflogebene eine der folgenden Optionen aus:

   • Nicht angegeben: Es wird keine Logging-Ebene angegeben. Das ist die Standardeinstellung. Eine Ausführungslogebene hat Vorrang vor einer Workflow-Logebene, sofern keine Ausführungslogebene angegeben ist (Standardeinstellung); In diesem Fall wird die Workflow-Logebene genutzt.
   • Nur Fehler: Alle erfassten Ausnahmen sowie das Beenden eines Aufrufs aufgrund einer Ausnahme werden protokolliert.
   • Alle Aufrufe: Alle Aufrufe von untergeordneten Workflows oder Bibliotheksfunktionen und deren Ergebnisse werden protokolliert.
   • Keine Logs: Es werden keine Anrufe protokolliert.

6. Geben Sie optional die Ebene des Ausführungsverlaufs an, die Sie auf die Ausführung des Workflows anwenden möchten. Wählen Sie in der Liste Ausführungsverlauf eine der folgenden Optionen aus:

   • Von Workflow übernehmen: Die Einstellung für den Ausführungsverlauf des Workflows wird angewendet. Das ist die Standardeinstellung.
   • Basic: Aktiviert den einfachen Ausführungsverlauf.
   • Detailliert: Aktiviert den detaillierten Ausführungsverlauf, einschließlich aller relevanten Variablenwerte und der erwarteten Anzahl von Iterationen.

7. Klicken Sie auf Ausführen.

8. Auf der Seite Ausführungsdetails können Sie die Ergebnisse der Ausführung ansehen, einschließlich aller Ausgaben, der Ausführungs-ID und des Ausführungsstatus sowie des aktuellen oder letzten Schritts der Workflowausführung. Weitere Informationen finden Sie unter Auf Workflow-Ausführungsergebnisse zugreifen.

gcloud

1. Öffnen Sie ein Terminalfenster.

2. Suchen Sie den Namen des Workflows, den Sie ausführen möchten. Wenn Sie den Namen des Workflows nicht kennen, können Sie den folgenden Befehl eingeben, um alle Workflows aufzulisten:

   gcloud workflows list

3. Sie können den Workflow entweder mit dem Befehl gcloud workflows run oder mit dem Befehl gcloud workflows execute ausführen:

   • Führen Sie den Workflow aus und warten Sie, bis die Ausführung abgeschlossen ist:

     gcloud workflows run WORKFLOW_NAME \
         --call-log-level=CALL_LOGGING_LEVEL \
         --execution-history-level="EXECUTION_HISTORY_LEVEL" \
         --data=DATA

   • Führen Sie den Workflow aus, ohne auf den Abschluss des Ausführungsversuchs zu warten:

     gcloud workflows execute WORKFLOW_NAME \
         --call-log-level=CALL_LOGGING_LEVEL \
         --execution-history-level="EXECUTION_HISTORY_LEVEL" \
         --data=DATA

     Ersetzen Sie Folgendes:

     • WORKFLOW_NAME: Der Name des Workflows.

     • CALL_LOGGING_LEVEL (optional): Ebene des Aufruf-Loggings, das während der Ausführung angewendet werden soll. Kann einer der folgenden Werte sein:

       • none: Es wird keine Logging-Ebene angegeben. Das ist die Standardeinstellung. Eine Ausführungslogebene hat Vorrang vor einer Workflow-Logebene, sofern keine Ausführungslogebene angegeben ist (Standardeinstellung); In diesem Fall wird die Workflow-Logebene genutzt.
       • log-errors-only: Es werden alle erfassten Ausnahmen sowie das Beenden eines Aufrufs aufgrund einer Ausnahme protokolliert
       • log-all-calls: Alle Aufrufe von untergeordneten Workflows oder Bibliotheksfunktionen und deren Ergebnisse werden protokolliert.
       • log-none: Kein Aufruf-Logging.

     • EXECUTION_HISTORY_LEVEL (optional): Ebene des Ausführungsverlaufs, die während der Ausführung angewendet werden soll. Kann einer der folgenden Werte sein:

       • none: Es wird keine Ausführlichkeitsstufe für den Ausführungsverlauf angegeben. Das ist die Standardeinstellung. Wenn für eine Ausführung keine Ausführungshistorieebene angegeben ist, wird sie durch die auf den Workflow angewendete Ebene bestimmt. Wenn sich die Ebenen unterscheiden, wird die Einstellung, die auf Ausführungsebene angewendet wird, für diese Ausführung durch die Einstellung auf Workflowebene überschrieben.
       • execution-history-basic: Aktivieren Sie den einfachen Ausführungsverlauf.
       • execution-history-detailed: Ermöglicht einen detaillierten Ausführungsverlauf, einschließlich aller relevanten Variablenwerte und der erwarteten Anzahl von Iterationen.

     • DATA (optional): Laufzeitargumente für Ihren Workflow im JSON-Format.

4. Wenn Sie gcloud workflows execute ausgeführt haben, wird die eindeutige ID des Workflow-Ausführungsversuchs zurückgegeben und die Ausgabe sieht in etwa so aus:

    To view the workflow status, you can use following command:
    gcloud workflows executions describe b113b589-8eff-4968-b830-8d35696f0b33 --workflow workflow-2 --location us-central1

   Geben Sie den im vorherigen Schritt zurückgegebenen Befehl ein, um den Status der Ausführung aufzurufen.

Wenn der Ausführungsversuch erfolgreich ist, sieht die Ausgabe in etwa so aus. Das state gibt an, dass der Workflow erfolgreich ausgeführt wurde, und das status gibt den letzten Workflowschritt der Ausführung an.

argument: '{"searchTerm":"Friday"}'
endTime: '2022-06-22T12:17:53.086073678Z'
name: projects/1051295516635/locations/us-central1/workflows/myFirstWorkflow/executions/c4dffd1f-13db-46a0-8a4a-ee39c144cb96
result: '["Friday","Friday the 13th (franchise)","Friday Night Lights (TV series)","Friday
    the 13th (1980 film)","Friday the 13th","Friday the 13th (2009 film)","Friday the
    13th Part III","Friday the 13th Part 2","Friday (Rebecca Black song)","Friday Night
    Lights (film)"]'
startTime: '2022-06-22T12:17:52.799387653Z'
state: SUCCEEDED
status:
    currentSteps:
    - routine: main
        step: returnOutput
workflowRevisionId: 000001-ac2

REST API

Verwenden Sie die Methode projects.locations.workflows.executions.create, um eine neue Ausführung mit der neuesten Überarbeitung eines bestimmten Workflows zu erstellen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_NUMBER: Ihre Google Cloud-Projektnummer, die auf der Seite IAM & Verwaltung > Einstellungen aufgeführt ist.
• LOCATION: die Region, in der der Workflow bereitgestellt wird, z. B. us-central1.
• WORKFLOW_NAME: Der benutzerdefinierte Name für den Workflow, z. B. myFirstWorkflow.
• PARAMETER: optional. Wenn der Workflow, den Sie ausführen, Laufzeitargumente empfangen kann, die Sie ihm im Rahmen einer Ausführungsanfrage übergeben, können Sie dem Anfragetext einen JSON-formatierten String hinzufügen, dessen Wert ein oder mehrere Escape-Parameter-Wert-Paare ist, z. B. "{\"searchTerm\":\"asia\"}".
• VALUE: optional. Der Wert eines Parameter-Wert-Paars, das Ihr Workflow als Laufzeitargument empfangen kann.
• CALL_LOGGING_LEVEL: optional. Die Ebene des Aufruf-Loggings, die während der Ausführung angewendet werden soll. Standardmäßig wird keine Logging-Ebene angegeben und stattdessen die Workflow-Logebene angewendet. Weitere Informationen finden Sie unter Logs an Logging senden. Einer der folgenden Werte:
  • CALL_LOG_LEVEL_UNSPECIFIED: Es wird keine Logging-Ebene angegeben und stattdessen die Workflow-Logebene angewendet. Das ist die Standardeinstellung. Andernfalls gilt die Ausführungslogebene und hat Vorrang vor der Workflow-Logebene.
  • LOG_ERRORS_ONLY: Es werden alle erfassten Ausnahmen sowie das Beenden eines Aufrufs aufgrund einer Ausnahme protokolliert.
  • LOG_ALL_CALLS: Alle Aufrufe von untergeordneten Workflows oder Bibliotheksfunktionen und deren Ergebnisse werden protokolliert.
  • LOG_NONE: Kein Aufruf-Logging.
• BACKLOG_EXECUTION: Optional. Wenn true festgelegt ist, wird die Ausführung nicht zurückgestellt, wenn das Kontingent für die Parallelität erschöpft ist. Weitere Informationen finden Sie unter Ausführungsrückstände verwalten.
• EXECUTION_HISTORY_LEVEL: Optional. Die Ausführlichkeitsstufe für den Ausführungsverlauf, die während der Ausführung angewendet werden soll. Weitere Informationen finden Sie unter Aufrufverlauf der Ausführungsschritte. Einen der folgenden Werte:
  • EXECUTION_HISTORY_LEVEL_UNSPECIFIED: Es wird keine Ausführlichkeitsstufe für den Ausführungsverlauf angegeben. Das ist die Standardeinstellung. Wenn für eine Ausführung keine Ausführungsverlaufsebene angegeben ist, wird sie durch die auf den Workflow angewendete Ebene bestimmt. Wenn die Ebenen unterschiedlich sind, wird die Einstellung, die auf Ausführungsebene angewendet wird, für diese Ausführung durch die Einstellung auf Workflowebene überschrieben.
  • EXECUTION_HISTORY_BASIC: Aktivieren Sie den einfachen Ausführungsverlauf.
  • EXECUTION_HISTORY_ADVANCED: Aktivieren Sie den detaillierten Ausführungsverlauf, einschließlich aller relevanten Variablenwerte und der erwarteten Anzahl von Iterationen.

JSON-Text der Anfrage:

{
  "argument": "{\"PARAMETER\":\"VALUE\"}",
  "callLogLevel": "CALL_LOGGING_LEVEL",
  "disableConcurrencyQuotaOverflowBuffering": "BACKLOG_EXECUTION",
  "executionHistoryLevel": "EXECUTION_HISTORY_LEVEL"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

cat > request.json << 'EOF'
{
  "argument": "{\"PARAMETER\":\"VALUE\"}",
  "callLogLevel": "CALL_LOGGING_LEVEL",
  "disableConcurrencyQuotaOverflowBuffering": "BACKLOG_EXECUTION",
  "executionHistoryLevel": "EXECUTION_HISTORY_LEVEL"
}
EOF

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://workflowexecutions.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/workflows/WORKFLOW_NAME/executions"

@'
{
  "argument": "{\"PARAMETER\":\"VALUE\"}",
  "callLogLevel": "CALL_LOGGING_LEVEL",
  "disableConcurrencyQuotaOverflowBuffering": "BACKLOG_EXECUTION",
  "executionHistoryLevel": "EXECUTION_HISTORY_LEVEL"
}
'@  | Out-File -FilePath request.json -Encoding utf8

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://workflowexecutions.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/workflows/WORKFLOW_NAME/executions" | Select-Object -Expand Content

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Execution:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/workflows/WORKFLOW_NAME/executions/EXECUTION_ID",
  "startTime": "2023-11-07T14:35:27.215337069Z",
  "state": "ACTIVE",
  "argument": "{\"PARAMETER\":\"VALUE\"}",
  "workflowRevisionId": "000001-2df",
  "callLogLevel": "CALL_LOGGING_LEVEL",
  "executionHistoryLevel": "EXECUTION_HISTORY_LEVEL",
  "status": {}
}