Migrer d'AWS Step Functions vers des workflows

Pour vous aider à passer d'Amazon Web Services (AWS) Step Functions aux workflows sur Google Cloud, cette page explique les principales similitudes et différences entre les deux produits. Ces informations sont destinées à aider les personnes qui connaissent déjà Step Functions à implémenter une architecture similaire à l'aide de workflows.

Comme Step Functions, Workflows est une plate-forme d'orchestration entièrement gérée, basée sur l'état, qui exécute des services dans l'ordre que vous définissez: un workflow. Ces workflows peuvent combiner des services tels que des services personnalisés hébergés sur Cloud Run ou Cloud Run Functions, des services Google Cloud tels que Cloud Vision AI et BigQuery, ainsi que toute API HTTP.

Notez que les workflows Express Step Functions sont un type de workflow AWS Step Functions qui n'est pas pris en compte ici, car la durée d'un workflow Express est limitée et l'exécution d'un workflow "une seule fois" n'est pas prise en charge.

Hello world

Dans Step Functions, une machine à états est un workflow, et une tâche est un état dans un workflow qui représente une unité de travail unique effectuée par un autre service AWS. Step Functions exige que chaque état définisse l'état suivant.

Dans Workflows, une série d'étapes utilisant la syntaxe Workflows décrit les tâches à exécuter. Workflows traite les étapes comme si elles se trouvaient dans une liste ordonnée et les exécute une par une jusqu'à ce que toutes les étapes soient exécutées.

L'exemple "Hello World" suivant illustre l'utilisation des états dans les fonctions d'étape et des étapes dans les workflows:

Fonctions en escalier

  {
    "Comment": "Hello world example of Pass states in Amazon States Language",
    "StartAt": "Hello",
    "States": {
      "Hello": {
        "Type": "Pass",
        "Result": "Hello",
        "Next": "World"
      },
      "World": {
        "Type": "Pass",
        "Result": "World",
        "End": true
      }
    }
  }

Fichier YAML des workflows

  ---
  # Hello world example of steps using Google Cloud Workflows syntax
  main:
      steps:
      - Hello:
          next: World
      - World:
          next: end
  ...

JSON des workflows

  {
    "main": {
      "steps": [
        {
          "Hello": {
            "next": "World"
          }
        },
        {
          "World": {
            "next": "end"
          }
        }
      ]
    }
  }

Présentation de la comparaison

Cette section compare les deux produits plus en détail.

Fonctions en escalierWorkflows
SyntaxeJSON (YAML dans les outils) YAML ou JSON
Flux de contrôleTransitions entre les états Contrôle de flux impératif avec étapes
WorkerRessources (ARN) et tâche HTTP Requêtes HTTP et connecteurs
FiabilitéAttraper/Réessayer Attraper/Réessayer
ParallélismeCompatible Compatible
Données d'étatL'état est transmis Variables Workflows
AuthentificationIAM IAM
Expérience utilisateurWorkflow Studio, CLI, SDK, IaC Console Google Cloud, CLI, SDK, IaC
Tarifs Tarifs de Step Functions Tarifs de Workflows
Syntaxe

Step Functions utilise principalement le format JSON pour définir des fonctions et n'est pas compatible directement avec le format YAML. Toutefois, dans AWS Toolkit pour Visual Studio Code et dans AWS CloudFormation, vous pouvez utiliser le format YAML pour une définition Step Functions.

Vous pouvez décrire les étapes de Workflows à l'aide de la syntaxe Workflows. Elles peuvent être écrites en YAML ou en JSON. La plupart des workflows sont au format YAML. Les exemples de cette page illustrent les avantages de YAML, y compris la facilité de lecture et d'écriture, ainsi que la prise en charge native des commentaires. Pour obtenir une explication détaillée de la syntaxe Workflows, consultez la documentation de référence sur la syntaxe.

Flux de contrôle

Workflows et Step Functions modélisent les workflows en tant que série de tâches: étapes dans Workflows et états dans Step Functions. Les deux permettent à une tâche d'indiquer la tâche à exécuter ensuite et acceptent les conditions similaires à un commutateur pour sélectionner l'unité de travail suivante en fonction de l'état actuel. Une différence clé est que Step Functions nécessite que chaque état définisse le suivant, tandis que Workflows exécute les étapes dans l'ordre dans lequel elles sont spécifiées (y compris les étapes suivantes alternatives). Pour en savoir plus, consultez les Conditions et les Étapes.

Nœud de calcul

Les deux produits orchestrent des ressources de calcul telles que des fonctions, des conteneurs et d'autres services Web pour accomplir des tâches. Dans Step Functions, le nœud de calcul est identifié par un champ Resource, qui est syntaxiquement un URI. Les URI utilisés pour identifier les ressources de worker sont au format de nom de ressource Amazon (ARN). Pour appeler directement un point de terminaison HTTP arbitraire, vous pouvez définir une tâche HTTP.

Les workflows peuvent envoyer des requêtes HTTP à un point de terminaison HTTP arbitraire et obtenir une réponse. Les connecteurs facilitent la connexion à d'autres API Google Cloud au sein d'un workflow et l'intégration de vos workflows à d'autres produits Google Cloud tels que Pub/Sub, BigQuery ou Cloud Build. Les connecteurs simplifient les services d'appel, car ils gèrent la mise en forme des requêtes à votre place, en fournissant des méthodes et des arguments pour que vous n'ayez pas besoin de connaître les détails d'une API Google Cloud. Vous pouvez également configurer les stratégies de délai avant expiration et d'interrogation.

Fiabilité

Si une tâche échoue, votre workflow doit pouvoir la relancer de manière appropriée, intercepter les exceptions lorsqu'il le doit et rediriger le workflow si nécessaire. Les fonctions d'étape et les workflows atteignent la fiabilité à l'aide de mécanismes similaires: détection des exceptions avec des nouvelles tentatives et distribution éventuelle ailleurs dans le workflow. Pour en savoir plus, consultez la section Erreurs de workflow.

Parallélisme

Vous pouvez souhaiter que votre workflow orchestre plusieurs tâches en parallèle. Les fonctions d'étape offrent deux façons d'y parvenir: vous pouvez prendre un élément de données et le transmettre en parallèle à plusieurs tâches différentes, ou vous pouvez utiliser un tableau et transmettre ses éléments à la même tâche.

Dans les workflows, vous pouvez définir une partie de votre workflow dans laquelle deux étapes ou plus peuvent s'exécuter simultanément. Vous pouvez définir des branches qui s'exécutent simultanément ou une boucle dans laquelle les itérations s'exécutent simultanément. Pour en savoir plus, consultez la section Exécuter les étapes du workflow en parallèle.

Données d'état

L'un des avantages d'un moteur de workflow est que les données d'état sont gérées pour vous sans datastore externe. Dans Step Functions, les données d'état sont transmises d'un état à un autre dans une structure JSON.

Dans Workflows, vous pouvez enregistrer les données d'état dans des variables globales. Étant donné que la durée d'exécution est limitée à un an, vous pouvez conserver les données d'état tant que l'instance est en cours d'exécution.

Authentification

Les deux produits reposent sur un système sous-jacent de Identity and Access Management (IAM) pour l'authentification et le contrôle des accès. Par exemple, vous pouvez utiliser un rôle IAM pour appeler des fonctions de séquence.

Dans Workflows, vous pouvez utiliser un compte de service pour appeler un workflow. Vous pouvez utiliser OAuth 2.0 ou OIDC pour vous connecter aux API Google Cloud. Vous pouvez également utiliser un en-tête de requête d'autorisation pour vous authentifier auprès d'une API tierce. Pour en savoir plus, consultez les pages Accorder à un workflow l'autorisation d'accéder aux ressources Google Cloud et Effectuer des requêtes authentifiées à partir d'un workflow.

Expérience utilisateur

Vous pouvez utiliser un outil de ligne de commande ou une infrastructure en tant que code (IAC) telle que Terraform pour définir et gérer à la fois des fonctions de séquence et des workflows.

De plus, Workflows prend en charge l'exécution de workflows à l'aide des bibliothèques clientes, dans la console Google Cloud, à l'aide de la Google Cloud CLI ou en envoyant une requête à l'API REST Workflows. Pour en savoir plus, consultez la page Exécuter un workflow.

Tarifs

Les deux produits proposent une version gratuite. Pour en savoir plus, consultez les pages de tarification respectives: Tarifs de Step Functions et Tarifs de Workflows.

Mappage des types d'états sur les étapes

Step Functions propose huit types d'états. Les états sont des éléments d'une machine à états qui peuvent prendre des décisions en fonction de leurs entrées, effectuer des actions et transmettre des sorties à d'autres états. Avant de migrer de Step Functions vers Workflows, assurez-vous de savoir comment traduire chaque type d'état en étape Workflows.

Choice

Un état Choice ajoute une logique de branchement à une machine à états.

Dans les workflows, vous pouvez utiliser un bloc switch en tant que mécanisme de sélection qui permet à la valeur d'une expression de contrôler le flux d'exécution d'un workflow. Si une valeur correspond, l'instruction de cette condition est exécutée. Pour en savoir plus, consultez la section Conditions.

Fonctions en escalier

  "ChoiceState": {
    "Type": "Choice",
    "Choices": [
      {
        "Variable": "$.foo",
        "NumericEquals": 1,
        "Next": "FirstMatchState"
      },
      {
        "Variable": "$.foo",
        "NumericEquals": 2,
        "Next": "SecondMatchState"
      }
    ],
    "Default": "DefaultState"
  }

Fichier YAML des workflows

  switch:
    - condition: ${result.body.SomeField < 10}
      next: small
    - condition: ${result.body.SomeField < 100}
      next: medium
    - condition: true
      next: default_step

JSON des workflows

  {
    "switch": [
      {
        "condition": "${result.body.SomeField < 10}",
        "next": "small"
      },
      {
        "condition": "${result.body.SomeField < 100}",
        "next": "medium"
      },
      {
        "condition": true,
        "next": "default_step"
      }
    ]
  }

Fail

Un état Fail arrête l'exécution de la machine d'état et la marque comme échec.

Dans Workflows, vous pouvez générer des erreurs personnalisées à l'aide de la syntaxe raise, et vous pouvez intercepter et gérer les erreurs à l'aide d'un bloc try/except. Pour en savoir plus, consultez la section Générer des erreurs.

Fonctions en escalier

  "FailState": {
      "Type": "Fail",
      "Error": "ErrorA",
      "Cause": "Kaiju attack"
  }

Fichier YAML des workflows

  raise:
      code: 55
      message: "Something went wrong."

JSON des workflows

  {
    "raise": {
      "code": 55,
      "message": "Something went wrong."
    }
  }

Map

Un état Map peut être utilisé pour exécuter un ensemble d'étapes pour chaque élément d'un tableau d'entrée.

Dans Workflows, vous pouvez utiliser des boucles for pour les iterations.

Fonctions en escalier

  { "StartAt": "ExampleMapState",
    "States": {
      "ExampleMapState": {
        "Type": "Map",
        "Iterator": {
           "StartAt": "CallLambda",
           "States": {
             "CallLambda": {
               "Type": "Task",
               "Resource": "arn:aws:lambda:us-east-1:123456789012:function:HelloFunction",
               "End": true
             }
           }
        }, "End": true
      }
    }
  }

Fichier YAML des workflows

  - assignStep:
      assign:
        - map:
            1: 10
            2: 20
            3: 30
        - sum: 0
  - loopStep:
      for:
          value: key
          in: ${keys(map)}
          steps:
            - sumStep:
                assign:
                  - sum: ${sum + map[key]}
  - returnStep:
      return: ${sum}

JSON des workflows

  [
    {
      "assignStep": {
        "assign": [
          {
            "map": {
              "1": 10,
              "2": 20,
              "3": 30
            }
          },
          {
            "sum": 0
          }
        ]
      }
    },
    {
      "loopStep": {
        "for": {
          "value": "key",
          "in": "${keys(map)}",
          "steps": [
            {
              "sumStep": {
                "assign": [
                  {
                    "sum": "${sum + map[key]}"
                  }
                ]
              }
            }
          ]
        }
      }
    },
    {
      "returnStep": {
        "return": "${sum}"
      }
    }
  ]

Parallel

Un état Parallel peut être utilisé pour créer des branches d'exécution parallèles dans votre machine à états. Dans l'exemple Step Functions suivant, une recherche d'adresse et de numéro de téléphone est effectuée en parallèle.

Dans Workflows, vous pouvez utiliser une étape parallel pour définir une partie de votre workflow dans laquelle deux étapes ou plus peuvent s'exécuter simultanément. Pour en savoir plus, consultez la section Étapes parallèles.

Fonctions en escalier

  { "StartAt": "LookupCustomerInfo",
    "States": {
      "LookupCustomerInfo": {
        "Type": "Parallel",
        "End": true,
        "Branches": [
          {
           "StartAt": "LookupAddress",
           "States": {
             "LookupAddress": {
               "Type": "Task",
               "Resource": "arn:aws:lambda:us-east-1:123456789012:function:AddressFinder",
               "End": true
             }
           }
         },
         {
           "StartAt": "LookupPhone",
           "States": {
             "LookupPhone": {
               "Type": "Task",
               "Resource": "arn:aws:lambda:us-east-1:123456789012:function:PhoneFinder",
               "End": true
             }
           }
         }
        ]
      }
    }
  }

Fichier YAML des workflows

  main:
     params: [args]
     steps:
     - init:
         assign:
         - workflow_id: "lookupAddress"
         - customer_to_lookup:
             - address: ${args.customerId}
             - phone: ${args.customerId}
         - addressed: ["", ""] # to write to this variable, you must share it
     - parallel_address:
         parallel:
             shared: [addressed]
             for:
                 in: ${customer_to_lookup}
                 index: i # optional, use if index is required
                 value: arg
                 steps:
                 - address:
                     call: googleapis.workflowexecutions.v1.projects.locations.workflows.executions.run
                     args:
                         workflow_id: ${workflow_id}
                         argument: ${arg}
                     result: r
                 - set_result:
                     assign:
                     - addressed[i]: ${r}
     - return:
             return: ${addressed}

JSON des workflows

  {
    "main": {
      "params": [
        "args"
      ],
      "steps": [
        {
          "init": {
            "assign": [
              {
                "workflow_id": "lookupAddress"
              },
              {
                "customer_to_lookup": [
                  {
                    "address": "${args.customerId}"
                  },
                  {
                    "phone": "${args.customerId}"
                  }
                ]
              },
              {
                "addressed": [
                  "",
                  ""
                ]
              }
            ]
          }
        },
        {
          "parallel_address": {
            "parallel": {
              "shared": [
                "addressed"
              ],
              "for": {
                "in": "${customer_to_lookup}",
                "index": "i",
                "value": "arg",
                "steps": [
                  {
                    "address": {
                      "call": "googleapis.workflowexecutions.v1.projects.locations.workflows.executions.run",
                      "args": {
                        "workflow_id": "${workflow_id}",
                        "argument": "${arg}"
                      },
                      "result": "r"
                    }
                  },
                  {
                    "set_result": {
                      "assign": [
                        {
                          "addressed[i]": "${r}"
                        }
                      ]
                    }
                  }
                ]
              }
            }
          }
        },
        {
          "return": {
            "return": "${addressed}"
          }
        }
      ]
    }
  }

Pass

Un état Pass transmet son entrée à sa sortie, sans effectuer de travail. Cette méthode est couramment utilisée pour manipuler les données d'état dans le fichier JSON.

Comme Workflows ne transmet pas de données de cette manière, vous pouvez laisser l'état sans action ou utiliser une étape d'attribution pour modifier les variables. Pour en savoir plus, consultez la section Attribuer des variables.

Fonctions en escalier

  "No-op": {
    "Type": "Pass",
    "Result": {
      "x-datum": 0.38,
      "y-datum": 622.22
    },
    "ResultPath": "$.coords",
    "Next": "End"
  }

Fichier YAML des workflows

  assign:
      - number: 5
      - number_plus_one: ${number+1}
      - other_number: 10
      - string: "hello"

JSON des workflows

  {
    "assign": [
      {
        "number": 5
      },
      {
        "number_plus_one": "${number+1}"
      },
      {
        "other_number": 10
      },
      {
        "string": "hello"
      }
    ]
  }

Réussir

Un état Succeed arrête une exécution.

Dans les workflows, vous pouvez utiliser return dans le workflow principal pour arrêter l'exécution d'un workflow. Vous pouvez également terminer un workflow en effectuant la dernière étape (en supposant que l'étape ne saute pas vers une autre), ou utiliser next: end pour arrêter l'exécution d'un workflow si vous n'avez pas besoin de renvoyer une valeur. Pour en savoir plus, consultez la section Achever l'exécution d'un workflow.

Fonctions en escalier

  "SuccessState": {
    "Type": "Succeed"
  }

Fichier YAML des workflows

  return: "Success!"
  next: end

JSON des workflows

  {
    "return": "Success!",
    "next": "end"
  }

Task

Un état Task représente une seule unité de travail effectuée par une machine à états. Dans l'exemple Step Functions suivant, il appelle une fonction Lambda. (Les activités sont une fonctionnalité AWS Step Functions qui vous permet d'avoir une tâche dans votre machine à états où le travail est effectué ailleurs.)

Dans l'exemple de Workflows, un appel est effectué à un point de terminaison HTTP pour appeler une fonction Cloud Run. Vous pouvez également utiliser un connecteur qui permet d'accéder facilement à d'autres produits Google Cloud. Vous pouvez également mettre en pause un workflow et interroger les données. Vous pouvez également utiliser un point de terminaison de rappel pour signaler à votre workflow qu'un événement spécifié s'est produit et attendre cet événement sans interrogation.

Fonctions en escalier

  "HelloWorld": {
    "Type": "Task",
    "Resource": "arn:aws:lambda:us-east-1:123456789012:function:HelloFunction",
    "End": true
  }

Fichier YAML des workflows

  - HelloWorld:
      call: http.get
      args:
          url: https://REGION-PROJECT_ID.cloudfunctions.net/helloworld
      result: helloworld_result

JSON des workflows

  [
    {
      "HelloWorld": {
        "call": "http.get",
        "args": {
          "url": "https://REGION-PROJECT_ID.cloudfunctions.net/helloworld"
        },
        "result": "helloworld_result"
      }
    }
  ]

Wait

Un état Wait empêche la machine d'état de continuer pendant une durée spécifiée.

Vous pouvez utiliser la fonction de bibliothèque standard sys.sleep de Workflows pour suspendre l'exécution du nombre de secondes spécifié à un maximum de 3 153 6000 (un an).

Fonctions en escalier

  "wait_ten_seconds" : {
    "Type" : "Wait",
    "Seconds" : 10,
    "Next": "NextState"
  }

Fichier YAML des workflows

  - someSleep:
      call: sys.sleep
      args:
          seconds: 10

JSON des workflows

  [
    {
      "someSleep": {
        "call": "sys.sleep",
        "args": {
          "seconds": 10
        }
      }
    }
  ]

Exemple: Orchestration de microservices

L'exemple Step Functions suivant vérifie le prix d'une action, détermine s'il faut acheter ou vendre, puis indique le résultat. La machine à états de l'exemple s'intègre à AWS Lambda en transmettant des paramètres, utilise une file d'attente Amazon SQS pour demander une approbation humaine et utilise un sujet Amazon SNS pour renvoyer les résultats de la requête.

{
      "StartAt": "Check Stock Price",
      "Comment": "An example of integrating Lambda functions in Step Functions state machine",
      "States": {
          "Check Stock Price": {
              "Type": "Task",
              "Resource": "CHECK_STOCK_PRICE_LAMBDA_ARN",
              "Next": "Generate Buy/Sell recommendation"
          },
          "Generate Buy/Sell recommendation": {
              "Type": "Task",
              "Resource": "GENERATE_BUY_SELL_RECOMMENDATION_LAMBDA_ARN",
              "ResultPath": "$.recommended_type",
              "Next": "Request Human Approval"
          },
          "Request Human Approval": {
              "Type": "Task",
              "Resource": "arn:PARTITION:states:::sqs:sendMessage.waitForTaskToken",
              "Parameters": {
                  "QueueUrl": "REQUEST_HUMAN_APPROVAL_SQS_URL",
                  "MessageBody": {
                      "Input.$": "$",
                      "TaskToken.$": "$$.Task.Token"
                  }
              },
              "ResultPath": null,
              "Next": "Buy or Sell?"
          },
          "Buy or Sell?": {
              "Type": "Choice",
              "Choices": [
                  {
                      "Variable": "$.recommended_type",
                      "StringEquals": "buy",
                      "Next": "Buy Stock"
                  },
                  {
                      "Variable": "$.recommended_type",
                      "StringEquals": "sell",
                      "Next": "Sell Stock"
                  }
              ]
          },
          "Buy Stock": {
              "Type": "Task",
              "Resource": "BUY_STOCK_LAMBDA_ARN",
              "Next": "Report Result"
          },
          "Sell Stock": {
              "Type": "Task",
              "Resource": "SELL_STOCK_LAMBDA_ARN",
              "Next": "Report Result"
          },
          "Report Result": {
              "Type": "Task",
              "Resource": "arn:PARTITION:states:::sns:publish",
              "Parameters": {
                  "TopicArn": "REPORT_RESULT_SNS_TOPIC_ARN",
                  "Message": {
                      "Input.$": "$"
                  }
              },
              "End": true
          }
      }
  }

Migrer vers Workflows

Pour migrer l'exemple Step Functions précédent vers Workflows, vous pouvez créer les étapes Workflows équivalentes en intégrant des fonctions Cloud Run, en prenant en charge un point de terminaison de rappel qui attend que les requêtes HTTP arrivent à ce point de terminaison, et en utilisant un connecteur Workflows pour publier sur un sujet Pub/Sub à la place du sujet Amazon SNS:

  1. Suivez la procédure pour créer un workflow, mais ne le déployez pas encore.

  2. Dans la définition du workflow, ajoutez une étape permettant de créer un point de terminaison de rappel qui attend une entrée humaine et une étape qui utilise un connecteur Workflows pour publier sur un sujet Pub/Sub. Exemple :

    Fichier YAML des workflows

      ---
      main:
        steps:
          - init:
              assign:
                - projectId: '${sys.get_env("GOOGLE_CLOUD_PROJECT_ID")}'
                - region: LOCATION
                - topic: PUBSUB_TOPIC_NAME
          - Check Stock Price:
              call: http.get
              args:
                url: ${"https://" + region + "-" + projectId + ".cloudfunctions.net/CheckStockPrice"}
                auth:
                  type: OIDC
              result: stockPriceResponse
          - Generate Buy/Sell Recommendation:
              call: http.get
              args:
                url: ${"https://" + region + "-" + projectId + ".cloudfunctions.net/BuySellRecommend"}
                auth:
                  type: OIDC
                query:
                  price: ${stockPriceResponse.body.stock_price}
              result: recommendResponse
          - Create Approval Callback:
              call: events.create_callback_endpoint
              args:
                  http_callback_method: "GET"
              result: callback_details
          - Print Approval Callback Details:
              call: sys.log
              args:
                  severity: "INFO"
                  text: ${"Listening for callbacks on " + callback_details.url}
          - Await Approval Callback:
              call: events.await_callback
              args:
                  callback: ${callback_details}
                  timeout: 3600
              result: approvalResponse
          - Approval?:
              try:
                switch:
                  - condition: ${approvalResponse.http_request.query.response[0] == "yes"}
                    next: Buy or Sell?
              except:
                as: e
                steps:
                  - unknown_response:
                      raise: ${"Unknown response:" + e.message}
                      next: end
          - Buy or Sell?:
              switch:
                - condition: ${recommendResponse.body == "buy"}
                  next: Buy Stock
                - condition: ${recommendResponse.body == "sell"}
                  next: Sell Stock
                - condition: true
                  raise: ${"Unknown recommendation:" + recommendResponse.body}
          - Buy Stock:
              call: http.post
              args:
                url: ${"https://" + region + "-" + projectId + ".cloudfunctions.net/BuyStock"}
                auth:
                  type: OIDC
                body:
                  action: ${recommendResponse.body}
              result: message
          - Sell Stock:
              call: http.post
              args:
                url: ${"https://" + region + "-" + projectId + ".cloudfunctions.net/SellStock"}
                auth:
                  type: OIDC
                body:
                  action: ${recommendResponse.body}
              result: message
          - Report Result:
              call: googleapis.pubsub.v1.projects.topics.publish
              args:
                topic: ${"projects/" + projectId + "/topics/" + topic}
                body:
                  messages:
                  - data: '${base64.encode(json.encode(message))}'
              next: end
      ...

    JSON des workflows

      {
        "main": {
          "steps": [
            {
              "init": {
                "assign": [
                  {
                    "projectId": "${sys.get_env(\"GOOGLE_CLOUD_PROJECT_ID\")}"
                  },
                  {
                    "region": "LOCATION"
                  },
                  {
                    "topic": [
                      "PUBSUB_TOPIC_NAME"
                    ]
                  }
                ]
              }
            },
            {
              "Check Stock Price": {
                "call": "http.get",
                "args": {
                  "url": "${\"https://\" + region + \"-\" + projectId + \".cloudfunctions.net/CheckStockPrice\"}",
                  "auth": {
                    "type": "OIDC"
                  }
                },
                "result": "stockPriceResponse"
              }
            },
            {
              "Generate Buy/Sell Recommendation": {
                "call": "http.get",
                "args": {
                  "url": "${\"https://\" + region + \"-\" + projectId + \".cloudfunctions.net/BuySellRecommend\"}",
                  "auth": {
                    "type": "OIDC"
                  },
                  "query": {
                    "price": "${stockPriceResponse.body.stock_price}"
                  }
                },
                "result": "recommendResponse"
              }
            },
            {
              "Create Approval Callback": {
                "call": "events.create_callback_endpoint",
                "args": {
                  "http_callback_method": "GET"
                },
                "result": "callback_details"
              }
            },
            {
              "Print Approval Callback Details": {
                "call": "sys.log",
                "args": {
                  "severity": "INFO",
                  "text": "${\"Listening for callbacks on \" + callback_details.url}"
                }
              }
            },
            {
              "Await Approval Callback": {
                "call": "events.await_callback",
                "args": {
                  "callback": "${callback_details}",
                  "timeout": 3600
                },
                "result": "approvalResponse"
              }
            },
            {
              "Approval?": {
                "try": {
                  "switch": [
                    {
                      "condition": "${approvalResponse.http_request.query.response[0] == \"yes\"}",
                      "next": "Buy or Sell?"
                    }
                  ]
                },
                "except": {
                  "as": "e",
                  "steps": [
                    {
                      "unknown_response": {
                        "raise": "${\"Unknown response:\" + e.message}",
                        "next": "end"
                      }
                    }
                  ]
                }
              }
            },
            {
              "Buy or Sell?": {
                "switch": [
                  {
                    "condition": "${recommendResponse.body == \"buy\"}",
                    "next": "Buy Stock"
                  },
                  {
                    "condition": "${recommendResponse.body == \"sell\"}",
                    "next": "Sell Stock"
                  },
                  {
                    "condition": true,
                    "raise": "${\"Unknown recommendation:\" + recommendResponse.body}"
                  }
                ]
              }
            },
            {
              "Buy Stock": {
                "call": "http.post",
                "args": {
                  "url": "${\"https://\" + region + \"-\" + projectId + \".cloudfunctions.net/BuyStock\"}",
                  "auth": {
                    "type": "OIDC"
                  },
                  "body": {
                    "action": "${recommendResponse.body}"
                  }
                },
                "result": "message"
              }
            },
            {
              "Sell Stock": {
                "call": "http.post",
                "args": {
                  "url": "${\"https://\" + region + \"-\" + projectId + \".cloudfunctions.net/SellStock\"}",
                  "auth": {
                    "type": "OIDC"
                  },
                  "body": {
                    "action": "${recommendResponse.body}"
                  }
                },
                "result": "message"
              }
            },
            {
              "Report Result": {
                "call": "googleapis.pubsub.v1.projects.topics.publish",
                "args": {
                  "topic": "${\"projects/\" + projectId + \"/topics/\" + topic}",
                  "body": {
                    "messages": [
                      {
                        "data": "${base64.encode(json.encode(message))}"
                      }
                    ]
                  }
                },
                "next": "end"
              }
            }
          ]
        }
      }

    Remplacez les éléments suivants :

    • LOCATION: région Google Cloud compatible. Par exemple, us-central1.
    • PUBSUB_TOPIC_NAME: nom de votre sujet Pub/Sub. Exemple :my_stock_example
  3. Déployez, puis exécutez le workflow.

  4. Pendant l'exécution du workflow, il se met en pause et attend que vous appeliez le point de terminaison de rappel. Pour ce faire, vous pouvez utiliser une commande curl. Exemple :

    curl -H "Authorization: Bearer $(gcloud auth print-access-token)"
    https://workflowexecutions.googleapis.com/v1/projects/CALLBACK_URL?response=yes
    

    Remplacez CALLBACK_URL par le reste du chemin d'accès à votre point de terminaison de rappel.

  5. Une fois le workflow terminé, vous pouvez recevoir le message de l'abonnement Pub/Sub. Exemple :

    gcloud pubsub subscriptions pull stock_example-sub  --format="value(message.data)" | jq
    

    Le message de sortie doit ressembler à ce qui suit (buy ou sell):

    {
      "body": "buy",
      "code": 200,
      "headers": {
      [...]
      }
    

Étape suivante