Présentation de Workflows

Workflows est une plate-forme d'orchestration entièrement gérée qui exécute les 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 Functions, des services Google Cloud tels que Cloud Vision AI et BigQuery, ainsi que toute API basée sur HTTP.

En intégrant des workflows dans des solutions, vous pouvez rendre les dépendances de services explicites et observables de bout en bout. Workflow qui spécifie un processus applicatif, opérationnel ou métier, qui fournit une source de vérité ou une description canonique du processus.

Les workflows s'exécutent sans serveur et s'adaptent en fonction des besoins. Aucuns frais ne sont facturés en cas d'inactivité. Étant donné qu'un workflow ne contient aucune dépendance de code ou de bibliothèque, il ne nécessite pas de correctifs de sécurité. Une fois que vous avez déployé un workflow, vous pouvez vous assurer qu'il s'exécutera de manière fiable sans maintenance. Un workflow peut conserver l'état, réessayer, interroger ou attendre jusqu'à un an.

Workflows est conforme à ces certifications et normes.

Le schéma suivant montre un exemple d'utilisation de Workflows pour orchestrer des services:

Orchestration de services à l'aide de Workflows

Principaux cas d'utilisation

Workflows accepte de nombreux cas d'utilisation. En voici quelques exemples :

Orchestration des services Créer des solutions en combinant des services : effectuez une séquence d'opérations sur plusieurs systèmes, en attendant la fin de toutes les opérations. Peut être basé sur des événements. Exemple :
  • Envoyer les fichiers récemment importés vers Cloud AI, puis écrire des tags dans Firestore
  • Appeler une fonction Cloud et envoyer les résultats à un service Cloud Run
Tâches par lots Opération sur plusieurs éléments : effectuez des opérations sur un ensemble d'éléments ou sur des données par lot. Souvent programmée. Exemple :
  • Envoyer des e-mails quotidiens aux clients
  • Préparer et exécuter des tâches BigQuery ou de machine learning
  • Générer des rapports
Processus métier Automatisez les workflows métier : encodez les étapes d'un processus métier, y compris les conditions, les actions et les événements avec intervention humaine. Exemple :
  • Suivre une commande d'une requête à un traitement
  • Automatiser les demandes de ressources avec des approbations
Automatisation des processus informatiques Exécution gérée des opérations de service : séquences faciles des scripts des opérations de service Google Cloud. Exemple :
  • Provisionner de nouveaux projets ou infrastructures locataires
  • Désactiver les ressources selon un calendrier ou via des déclencheurs d'événements

Concepts fondamentaux

Un workflow se compose d'une série d'étapes décrites à l'aide de la syntaxe Workflows et peut être écrit en YAML ou JSON. Il s'agit de la définition du workflow. Pour obtenir une explication détaillée de la syntaxe Workflows, consultez la documentation de référence sur la syntaxe.

Une fois un workflow créé, il est déployé, ce qui le rend prêt à être exécuté. Découvrez comment créer et mettre à jour un workflow dans la console Google Cloud ou à l'aide de la Google Cloud CLI. Vous pouvez également créer votre workflow en utilisant l'IDE ou l'éditeur de code source de votre choix, et en configurant la saisie semi-automatique et la validation de la syntaxe.

Une exécution est une exécution unique de la logique contenue dans la définition d'un workflow. Un workflow qui n'a pas été exécuté ne génère aucuns frais. Toutes les exécutions de workflows sont indépendantes, et le scaling rapide du produit permet un grand nombre d'exécutions simultanées. Vous pouvez exécuter un workflow à l'aide des bibliothèques clientes, de la console Google Cloud, de Google Cloud CLI, ou en envoyant une requête HTTP POST à l'URL d'appel du workflow à l'aide de l'API REST Workflows. Pour en savoir plus, consultez la page Exécuter un workflow.

Capacités clés

Voici quelques-unes des principales fonctionnalités de Workflows.

Contrôle de l'exécution

Étapes
Pour créer un workflow, vous devez définir les étapes requises et l'ordre d'exécution à l'aide de la syntaxe Workflows. Chaque workflow doit comporter au moins une étape. Par défaut, Workflows traite les étapes comme si elles se trouvaient dans une liste numérotée et les exécute une par une jusqu'à ce que toutes les étapes soient exécutées. Pour en savoir plus, consultez la section Étapes.
Conditions
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. Pour en savoir plus, consultez la section Conditions.
Itération
Vous pouvez utiliser une boucle for pour effectuer une itération sur une séquence de nombres ou sur un ensemble de données, telles qu'une liste ou une carte. Pour en savoir plus, consultez la section Itération.
Étapes parallèles
Vous pouvez utiliser une étape parallel pour définir une partie de votre workflow (une branche ou une boucle) pouvant s'exécuter simultanément. Pour en savoir plus, consultez Étapes parallèles.
Sous-workflows
Un sous-workflow fonctionne comme une routine ou une fonction dans un langage de programmation, vous permettant d'encapsuler une étape ou un ensemble d'étapes que votre workflow répétera plusieurs fois. Pour plus d'informations, consultez la section Sous-workflows.

Déclencher des exécutions

Mode manuel
Vous pouvez gérer des workflows à partir de la console Google Cloud ou de la ligne de commande à l'aide de la Google Cloud CLI. La visualisation lorsque vous modifiez la syntaxe Workflows est également disponible dans la console Google Cloud.
Programmatique
Les bibliothèques clientes Cloud pour l'API Workflows ou l'API REST peuvent être utilisées pour gérer les workflows. Pour en savoir plus, consultez la page API de Workflows et documentation de référence.
Planifiée
Vous pouvez utiliser Cloud Scheduler pour exécuter un workflow selon un calendrier donné, par exemple le lundi à 9h ou toutes les 15 minutes. Pour en savoir plus, consultez la section Planifier un workflow à l'aide de Cloud Scheduler.
Arguments d'exécution
Les données transmises au moment de l'exécution sont accessibles en ajoutant un champ params à votre workflow principal (défini dans un bloc main). Le bloc main accepte un argument unique correspondant à n'importe quel type de données JSON valide. Le champ params nomme la variable utilisée par le workflow pour stocker les données que vous transmettez. Pour en savoir plus, consultez la section Arguments d'exécution.

Connecter des services

API HTTP
Vous pouvez définir une étape de workflow qui effectue un appel HTTP et attribue la réponse de l'appel à une variable. Par exemple, vous pouvez appeler un service Google Cloud tel que Cloud Functions ou Cloud Run via une requête HTTP. Les requêtes HTTP et HTTPS sont toutes deux acceptées. Pour en savoir plus, consultez les sections Envoyer une requête HTTP et Appeler Cloud Functions ou Cloud Run.
Vous pouvez appeler un service privé sur site, Compute Engine, Google Kubernetes Engine (GKE) ou d'autres points de terminaison Google Cloud en activant Identity-Aware Proxy (IAP). IAP vous permet d'établir une couche d'autorisation centrale pour les applications accessibles via HTTPS. Vous pouvez ainsi utiliser un modèle de contrôle des accès au niveau des applications au lieu d'utiliser des pare-feu au niveau du réseau. Pour en savoir plus, consultez la section Appeler un service privé sur site, Compute Engine, GKE ou un autre point de terminaison.
Vous pouvez également cibler un point de terminaison privé pour les appels HTTP à partir de l'exécution de votre workflow en utilisant le registre des services de l'Annuaire des services avec Workflows. La création d'un point de terminaison privé au sein d'un réseau cloud privé virtuel (VPC) peut être conforme à VPC Service Controls. Pour en savoir plus, consultez la section Appeler un point de terminaison privé compatible avec VPC Service Controls.
Connecteurs
Workflows publie des connecteurs qui permettent de se connecter à d'autres API Google Cloud au sein d'un workflow et d'intégrer vos workflows à ces produits Google Cloud. Ils simplifient les services d'appel, car ils gèrent la mise en forme des requêtes à votre place, et fournissent des méthodes et des arguments pour vous éviter d'avoir à connaître les détails d'une API Google Cloud. Pour en savoir plus, consultez la page Comprendre les connecteurs.
Variables d'environnement et bibliothèque standard
La bibliothèque standard Workflows, les variables d'environnement intégrées et les variables d'environnement définies par l'utilisateur vous permettent de construire efficacement des arguments pour les services et de traiter les réponses.
La bibliothèque standard comprend des modules et des fonctions fréquemment utilisées, par exemple pour les conversions de type de données et de format. Il n'est pas nécessaire d'importer ni de charger des bibliothèques dans un workflow : les fonctions de bibliothèque s'appliquent immédiatement. Pour en savoir plus, consultez Présentation des bibliothèques standards.
Vous pouvez accéder aux informations d'environnement d'un workflow (telles que son emplacement ou son identifiant de projet) à l'aide de variables d'environnement intégrées. Les variables d'environnement intégrées ne nécessitent pas de déclaration et sont disponibles à chaque exécution de workflow. Pour en savoir plus, consultez la section Variables d'environnement intégrées.
Lorsque vous déployez un workflow, vous pouvez définir des paires clé/valeur arbitraires en tant que variables d'environnement définies par l'utilisateur. Celles-ci sont accessibles par votre workflow au moment de l'exécution. Par exemple, vous pouvez créer un workflow configuré dynamiquement en fonction de l'environnement dans lequel il est déployé. Pour en savoir plus, consultez Utiliser des variables d'environnement.

Gestion des exceptions

Vous pouvez rendre vos workflows résilients et personnaliser leur comportement en cas d'échec à l'aide du traitement des exceptions de Workflows, y compris les tentatives d'appel HTTP automatisées avec des intervalles exponentiels entre les tentatives, les gestionnaires d'erreurs personnalisés et d'autres fonctionnalités avancées. Pour en savoir plus, consultez la section Erreurs de workflow.

En attente

Les rappels permettent aux exécutions de workflow d'attendre qu'un autre service envoie une requête au point de terminaison de rappel. Cette requête reprend l'exécution du workflow. Avec les rappels, vous pouvez signaler à votre workflow qu'un événement spécifié s'est produit et attendre cet événement sans interrogation. Pour en savoir plus, consultez la section Attendre à l'aide de rappels.

Vous pouvez suspendre l'exécution d'un workflow en ajoutant une étape de veille à la définition de votre workflow. Vous pouvez ensuite utiliser sys.sleep pour interroger des données sur un intervalle donné. Pour en savoir plus, consultez la section Attendre à l'aide de l'interrogation.

Authentification et contrôle des accès

Étant donné que chaque exécution de workflow nécessite un appel authentifié, vous pouvez réduire le risque d'appels accidentels ou malveillants à l'aide de Workflows. Vous pouvez également simplifier les interactions avec d'autres API Google Cloud à l'aide de comptes de service basés sur IAM. Vous pouvez également stocker de manière sécurisée des clés et des mots de passe pour l'authentification auprès d'API externes à l'aide du connecteur Secret Manager. Pour en savoir plus, découvrez l'authentification et le contrôle des accès.

Observabilité

Les workflows génèrent automatiquement des journaux pour les exécutions de workflows dans Cloud Logging. Vous pouvez également contrôler le moment où les journaux sont envoyés à Logging lors de l'exécution d'un workflow via la journalisation des appels ou des journaux personnalisés. Pour en savoir plus, consultez la section Envoyer des journaux à Cloud Logging.

Les informations des journaux d'audit sont disponibles via Cloud Audit Logs. Pour en savoir plus, consultez les informations sur les journaux d'audit de Workflows.

Vous pouvez récupérer l'historique d'une exécution de workflow spécifiée sous la forme d'une liste d'entrées d'étape. Chaque entrée représente une étape ou un bloc d'instructions dans l'exécution du workflow. Elles peuvent vous aider à déterminer la source d'une erreur ou à optimiser les performances d'un workflow.

Exemples de code

Vous trouverez de nombreux exemples de code Workflows utiles sur la page d'exemples.

Étapes suivantes