Présentation de Cloud Tasks

Cette page présente les tâches et les files d'attente de Cloud Tasks. Elle décrit également quand et comment les utiliser. Cloud Tasks vous permet de trier les opérations qui peuvent être effectuées indépendamment du flux principal de votre application et de les traiter de manière asynchrone à l'aide de gestionnaires que vous créez. Ces opérations indépendantes sont appelées tâches. Par exemple, vous devez mettre à jour une base de données dans le cadre du traitement d'une requête utilisateur, mais les mises à jour peuvent prendre beaucoup de temps. Le déchargement de cette action en tant que tâche vous permet de résoudre plus rapidement la requête.

La tâche déchargée est ajoutée à une file d'attente, qui la conserve jusqu'à son exécution. La file d'attente peut également agir comme une sorte de contrôle du flux d'envoi, en fonction de votre configuration initiale. Vous créez et configurez la file d'attente, qui est ensuite gérée par le service Cloud Tasks. Une fois les tâches ajoutées, la file d'attente les envoie et s'assure qu'elles sont traitées de manière fiable par vos nœuds de calcul. Les complexités associées à ce processus, telles que les coûts de la latence subie par l'utilisateur, les plantages du serveur, les limites de consommation des ressources et la gestion des nouvelles tentatives, sont gérées par le service.

Les tâches elles-mêmes sont constituées d'un nom unique, d'informations de configuration et, éventuellement, de données de la requête initiale, appelées "charge utile", nécessaires au traitement de la requête. Lorsque la charge utile est envoyée dans le corps de la requête, les tâches incluant des charges utiles doivent utiliser POST ou PUT comme méthode HTTP.

Les utilisateurs des environnements d'exécution de première génération de l'environnement standard App Engine doivent accéder au service Cloud Tasks via l'API Task Queue d'App Engine. Pour plus d'informations sur l'utilisation de cette méthode, consultez la documentation de Java 8, Python 2.7, Go 1.9 ou PHP 5.5. Les utilisateurs des environnements d'exécution de deuxième génération de l'environnement standard App Engine, de l'environnement flexible et ceux des autres plates-formes peuvent désormais utiliser l'API Cloud Tasks.

Pour accéder au service Cloud Tasks à l'aide de l'API Cloud Tasks, vous devez disposer d'un projet contenant une application App Engine qui héberge les files d'attente Cloud Tasks que vous créez. Cette application est située dans une région spécifique qui sert de paramètre LOCATION_ID pour vos requêtes Cloud Tasks. Prenez-en note. Sachez que deux emplacements, appelés europe-west et us-central dans les commandes App Engine, sont appelés respectivement europe-west1 et us-central1 dans les commandes Cloud Tasks. L'application sert d'emplacement pour toutes les files d'attente créées par le développeur. Le service Cloud Tasks sous-jacent s'exécute au même endroit.

Cas d'utilisation

Vous trouverez ci-dessous des cas d'utilisation types :

  • Accélération des temps de réponse des utilisateurs en déléguant à un nœud de calcul des opérations en arrière-plan potentiellement lentes, telles que des mises à jour de base de données
  • Préservation des requêtes dans le contexte d'incidents de production inattendus
  • Atténuation des pics de trafic en supprimant les tâches non destinées aux utilisateurs du parcours utilisateur principal
  • Gestion des taux d'appels d'API tierces

Files d'attente Cloud Tasks avec cibles HTTP

Dans le cas de cibles HTTP génériques, le service Cloud Tasks transmet la requête de tâche au nœud de calcul, situé sur n'importe quel point de terminaison HTTP générique, tel que Cloud Functions, Cloud Run, GKE, Compute Engine ou même sur un serveur Web sur site, en fonction de la configuration de la tâche. Ces files d'attente distribuent les requêtes à un débit fiable et configurable. Elles garantissent une exécution sûre des tâches. Une fois celle-ci réussie, tous les nœuds de calcul doivent envoyer un code de réponse HTTP (200-299) au service Cloud Tasks dans un délai de 10 minutes. Si une réponse différente est envoyée, ou si aucune réponse n'est transmise, la tâche est relancée.

Files d'attente basées sur HTTP

La cible doit gérer les nœuds de calcul liés au trafic et les tâches de nettoyage une fois celles-ci terminées.

Si votre cible requiert une authentification, vous devez configurer deux comptes de service, un pour votre application (le client) et un pour la file d'attente elle-même. Les autorisations requises sont accordées aux deux comptes et un identifiant pour le compte de service client doit être inclus dans la requête de tâche. Consultez la page Créer des tâches HTTP Target pour en savoir plus.

Files d'attente Cloud Tasks avec cibles App Engine

Dans le cas des cibles App Engine, le service Cloud Tasks transmet également la requête de tâche au nœud de calcul, situé dans App Engine, en fonction de la configuration de la tâche (ou, plus rarement, de la file d'attente elle-même). Ces files d'attente distribuent les requêtes à un débit fiable et configurable. Une exécution sûre des tâches est ainsi garantie. Une fois celle-ci réussie, tous les nœuds de calcul doivent envoyer un code de réponse HTTP (200-299) au service Cloud Tasks dans un délai spécifique en fonction du type de scaling de l'instance du service : 10 minutes pour le scaling automatique ou jusqu'à 24 heures pour le scaling manuel. Si une réponse différente est envoyée, ou qu'aucune réponse n'est envoyée, la tâche est relancée.

Files d'attente basées sur App Engine

Étant donné que les gestionnaires font partie d'App Engine, le service Cloud Tasks assure en grande partie la gestion des processus de la tâche, en augmentant et en diminuant le nombre de nœuds de calcul liés au trafic, et en supprimant les tâches une fois qu'elles sont terminées.

Workflows

Voici le workflow général :

  1. Vous créez un nœud de calcul pour traiter les tâches.
  2. Vous créez une file d'attente.
  3. Vous créez des tâches par programmation et les ajoutez à la file d'attente.
  4. Le service Cloud Tasks renvoie un code d'état "OK" à l'application d'origine. Cela indique que la tâche a bien été écrite dans l'espace de stockage Cloud Tasks. La requête de création de tâche devient ainsi hautement disponible et durable.
  5. Les tâches sont transmises au nœud de calcul.
  6. Le nœud de calcul traite la tâche.
  7. Pour terminer la séquence, le nœud de calcul renvoie un code d'état de réussite 2xx au service Cloud Tasks.

Une fois la tâche transférée à la file d'attente, aucune donnée n'est mise à la disposition de la requête initiale.

Fonctionnalités

Cloud Tasks vous permet d'envoyer des éléments de travail asynchrones avec les contrôles suivants :

  • Planifier des délais de distribution spécifiques
  • Gérer les rythmes de distribution
  • Configurer le comportement des nouvelles tentatives
  • Accéder à des tâches individuelles et les gérer dans une file d'attente
  • Activer la déduplication des tâches

Conditions d'utilisation

Le tableau suivant répertorie les termes clés décrivant certains aspects du comportement de Cloud Tasks.

Terme Définition
File d'attente Ensemble de tâches ayant le même type de cible, géré par une configuration unique.
Type de cible Où et comment une tâche est traitée.
Nœud de calcul Service qui traite des tâches.
Tentative Tentative d'exécution d'une tâche.
Tentative d'envoi Moment où Cloud Tasks a envoyé la tâche à sa cible.
Tentative de réponse Réponse d'un nœud de calcul qui indique que le travail associé à la tâche a été effectué ou a échoué.
retry Tentatives multiples d'exécution d'une tâche. Le nombre de tentatives est défini via l'élément RetryConfig.
Limites de débit Limites de débit pour une file d'attente.

Métriques

Les métriques Cloud Tasks prédéfinies suivantes sont disponibles via Stackdriver.

Type de métrique
Nom à afficher
Genre, type, unité
Description
Libellés
api/request_count
Requêtes API
DELTA, INT64, 1
Nombre d'appels d'API Cloud Tasks.
api_method : méthode API appelée (par exemple, "CreateTask").
response_code : code de réponse canonique sous forme de chaîne (par exemple, "ok").
queue/depth
Profondeur de la file d'attente (bêta)
GAUGE, INT64, 1
Nombre de tâches dans la file d'attente. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 120 secondes.
queue/task_attempt_count
Nombre de tentatives de tâches
DELTA, INT64, 1
Nombre de tentatives de tâches divisé par code de réponse.
response_code : code de réponse canonique sous forme de chaîne (par exemple, "ok").
queue/task_attempt_delays
Retards de tentative de tâche
DELTA, DISTRIBUTION, ms
Délai entre chaque heure de tentative planifiée et l'heure de tentative réelle.