Présentation de Workflows

Workflows est une plate-forme d'orchestration entièrement gérée qui exécute des services dans un 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 et n'importe quelle API 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 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 définissez les étapes souhaitées et leur 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 ordonné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 Procédure.
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 en parallèle
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 la section É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 les workflows depuis la console Google Cloud ou depuis la ligne de commande à l'aide de Google Cloud CLI. La console Google Cloud permet également d'effectuer des visualisations lorsque vous modifiez la syntaxe Workflows.
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 pages Envoyer une requête HTTP et Appeler Cloud Functions ou Cloud Run.
Vous pouvez également appeler des services privés sur site, Compute Engine, Google Kubernetes Engine (GKE) ou d'autres points de terminaison Google Cloud. Pour en savoir plus, consultez la section Appeler des instances privées sur site, Compute Engine, GKE ou d'autres points de terminaison.
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 et les variables d'environnement intégrées vous permettent de construire efficacement des arguments pour les services et de traiter les réponses.
La bibliothèque standard inclut des modules et des fonctions fréquemment utilisées, telles que les conversions de types et de formats de données. Il n'est pas nécessaire d'importer ni de charger des bibliothèques dans un workflow, car les fonctions de bibliothèque fonctionnent immédiatement. Pour en savoir plus, consultez la présentation de la bibliothèque standard.
Vous pouvez accéder aux informations sur l'environnement d'un workflow (telles que son emplacement ou son identifiant) à 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.

Traiter les erreurs

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. De plus, vous pouvez stocker de manière sécurisée des clés et des mots de passe pour l'authentification auprès des API externes à l'aide du connecteur Secret Manager. Pour en savoir plus, consultez nos articles sur 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.

Exemples de code

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

Étapes suivantes