Comprendre les connecteurs

Workflows publie des connecteurs pour faciliter l'accès à d'autres produits Google Cloud au sein d'un workflow. Pour en savoir plus sur les connecteurs disponibles, consultez la documentation de référence sur les connecteurs.

Les connecteurs peuvent être utilisés pour se connecter à d'autres API Google Cloud au sein d'un workflow et pour intégrer vos workflows dans ces produits Google Cloud. Par exemple, vous pouvez utiliser des connecteurs pour publier des messages Pub/Sub, lire ou écrire des données dans une base de données Firestore, ou récupérer des clés d'authentification à partir de Secret Manager.

Les connecteurs simplifient les appels de services, car ils gèrent la mise en forme des requêtes à votre place, et fournissent des méthodes et des arguments pour que vous n'ayez pas besoin de connaître les détails d'une API Google Cloud.

Les connecteurs intègrent un comportement pour la gestion des nouvelles tentatives et des opérations de longue durée.

Authentification

Les connecteurs utilisent l'authentification intégrée pour la gestion de l'authentification et des accès (IAM) afin d'interagir avec d'autres produits Google Cloud. Notez qu'un workflow utilisant un connecteur doit toujours disposer des autorisations appropriées associées à son compte de service pour s'authentifier correctement auprès d'une API donnée. Par exemple, pour publier un message dans Pub/Sub, le compte de service associé à votre workflow doit disposer du rôle roles/pubsub.publisher. Pour en savoir plus sur l'authentification auprès d'autres produits Google Cloud, consultez la page Autoriser un workflow à accéder aux ressources Google Cloud.

Nouvelles tentatives

Tous les connecteurs appliquent les règles de nouvelle tentative et les configurations de traitement des erreurs suivantes:

Opérations de longue durée

Pour les appels effectuant une opération de longue durée, les comportements suivants s'appliquent:

  • Les workflows bloquent l'exécution du workflow jusqu'à ce que l'opération se termine avec succès ou échoue.

  • Par défaut, les appels expirent au bout de 30 minutes. Le délai avant expiration de l'appel peut être modifié à l'aide du champ connector_params (jusqu'à un an maximum). Consultez la documentation de référence sur les connecteurs.

  • Les connecteurs interrogent régulièrement les opérations de longue durée. Par défaut, Workflows utilise un intervalle exponentiel entre les tentatives de 1,25 lors de l'interrogation, en commençant par 1 seconde, puis avec 60 secondes entre les sondages. Chaque tentative d'interrogation est comptabilisée comme une étape facturable. Les paramètres d'interrogation peuvent être modifiés à l'aide du champ connector_params. Consultez la documentation de référence sur les connecteurs.

  • Le mécanisme de nouvelle tentative s'applique à une tentative d'interrogation qui a échoué.

  • Lorsqu'une erreur se produit lors d'une opération de longue durée, Workflows génère une erreur OperationError. L'erreur inclut un attribut supplémentaire, error, qui contient des détails spécifiques à l'opération.

Si une opération de longue durée échoue, l'appel du connecteur génère une exception avec les attributs suivants:

  • message: message d'erreur lisible
  • tags : liste de tags. Pour un appel de connecteur d'opération de longue durée, la liste inclut OperationError.
  • operation: objet de l'opération de longue durée qui a échoué.

Pour obtenir une liste détaillée des types d'opérations de longue durée compatibles, consultez la documentation de référence sur les connecteurs.

Étape suivante