Ajouter une tâche App Engine à une file d'attente Cloud Tasks

Ajouter une tâche App Engine à une file d'attente Cloud Tasks

Ce guide de démarrage rapide explique comment ajouter une tâche App Engine à une file d'attente Cloud Tasks à l'aide de l'API Cloud Tasks.

Avant de commencer

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
2. Install the Google Cloud CLI.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

4. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Cloud Resource Manager and Cloud Tasks API:

   gcloud services enable cloudresourcemanager.googleapis.com tasks.googleapis.com

7. If you're using a local shell, then create local authentication credentials for your user account:

   gcloud auth application-default login

   You don't need to do this if you're using Cloud Shell.

8. Install the Google Cloud CLI.

9. To initialize the gcloud CLI, run the following command:

   gcloud init

10. Create or select a Google Cloud project.

    Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

11. Make sure that billing is enabled for your Google Cloud project.

12. Enable the Cloud Resource Manager and Cloud Tasks API:

    gcloud services enable cloudresourcemanager.googleapis.com tasks.googleapis.com

13. If you're using a local shell, then create local authentication credentials for your user account:

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

14. Le compte de service App Engine par défaut est créé automatiquement lorsque vous utilisez App Engine. Vous pouvez utiliser cette compte de service lorsque vous essayez ce guide de démarrage rapide. Toutefois, selon la configuration de vos règles d'administration, le compte de service par défaut peut ne pas se voir attribuer automatiquement le rôle Editor sur votre projet. Si tel est le cas, vous devez accorder au compte de service les rôles suivants:
    1. Administrateur Artifact Registry (roles/artifactregistry.admin)
    2. Rédacteur de dépôt Artifact Registry avec création lors de l'envoi (roles/artifactregistry.createOnPushWriter)
    3. Administrateur de Compute (roles/compute.admin)
    4. Rédacteur de journaux (roles/logging.logWriter)
    5. Lecteur des objets de l'espace de stockage (roles/storage.objectViewer)

Ajouter une application App Engine

Lorsque vous ciblez une tâche App Engine, et avant de déployer une application sur l'environnement standard App Engine, vous devez ajouter Application App Engine à votre projet.

1. Dans la console Google Cloud, accédez à la page App Engine.

   Accéder à App Engine

2. Dans la boîte de dialogue Welcome to App Engine (Bienvenue dans App Engine), effectuez l'une des opérations suivantes:

   • Si vous avez déjà créé une application App Engine et qu'il existe un Your App Engine application has been created (Votre application App Engine a été créée) s'affiche, vous pouvez puis ignorez les étapes restantes de cette section et passez aux étapes décrites dans consultez la section Installer et déployer l'exemple.

     ou

   • Si vous n'avez pas encore créé d'application App Engine, cliquez sur Créez une application et passez aux étapes restantes de cette section.

3. Sélectionnez une région pour votre application et notez-la.

   Notez que europe-west et us-central sont appelés respectivement europe-west1 et us-central1 dans les commandes Cloud Tasks.

4. Ne sélectionnez pas de compte de service. le service App Engine par défaut est utilisé.

5. Cliquez sur Suivant.

   L'application est configurée et créée. Cette opération peut prendre quelques minutes.

6. Ne téléchargez pas Cloud SDK. cliquez sur Je le ferai plus tard.

   Le message Votre application App Engine a bien été créée devrait s'afficher.

Installer et déployer l'exemple

L'exemple Node.js utilisé dans ce guide de démarrage rapide comprend deux fichiers: createTask.js est exécuté localement en tant qu'outil de ligne de commande pour créer et ajouter des tâches à la file d'attente Tasks ; server.js est déployé sur App Engine en tant que un service de nœuds de calcul pour traiter la tâche.

1. Dans votre terminal, clonez le dépôt de l'exemple d'application dans votre environnement machine.

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
   

2. Accédez au répertoire qui contient l'exemple de code.

   cd nodejs-docs-samples/cloud-tasks/snippets
   

3. Installez toutes les dépendances à l'aide d'un gestionnaire de paquets Node.js.

   Vous pouvez utiliser NPM :

   npm install
   

   Vous pouvez également utiliser Yarn :

   yarn install
   

4. Déployez le service de nœuds de calcul (server.js) dans l'environnement standard App Engine.

   gcloud app deploy app.yaml
   

5. Assurez-vous que l'application contenant le service est en cours d'exécution.

   gcloud app browse
   

6. Dans votre navigateur, accédez au lien fourni. Exemple :

   https://PROJECT_ID.uc.r.appspot.com/
   

   Hello, World! devrait s'afficher.

Créer une file d'attente Cloud Tasks

Utilisez le gcloud tasks queues create pour créer votre file d'attente dans l'environnement que vous avez préparé.

Attention : L'utilisation des méthodes de gestion des files d'attente gcloud Cloud Tasks comporte certains risques si elle est utilisée conjointement avec des méthodes d'importation de queue.yaml/queue.xml. Pour en savoir plus, consultez la section Utiliser la gestion des files d'attente ou queue.yaml.

1. Dans votre terminal, créez une file d'attente qui consigne toutes les opérations.

   gcloud tasks queues create QUEUE_NAME \
       --log-sampling-ratio=1.0 \
       --location=REGION
   

   Remplacez les éléments suivants :

   • QUEUE_NAME : nom de votre file d'attente Cloud Tasks
   • REGION : région dans laquelle vous avez déployé votre application

2. Attendez que la file d'attente s'initialise, puis vérifiez qu'elle a bien été créée. avec succès.

   gcloud tasks queues describe QUEUE_NAME \
       --location=REGION
   

   La sortie devrait ressembler à ce qui suit :

    name: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_NAME
    rateLimits:
      maxBurstSize: 100
      maxConcurrentDispatches: 1000
      maxDispatchesPerSecond: 500.0
    retryConfig:
      maxAttempts: 100
      maxBackoff: 3600s
      maxDoublings: 16
      minBackoff: 0.100s
    state: RUNNING
   

Ajouter une tâche à la file d'attente Cloud Tasks

Créez une tâche, ajoutez-la à la file d'attente que vous avez créée, puis transmettez-la au service de nœud de calcul.

1. Définissez les variables d'environnement suivantes. Le client utilise ces informations pour créer la requête.

   export PROJECT_ID=PROJECT_ID
   export LOCATION_ID=REGION
   export QUEUE_ID=QUEUE_NAME
   

2. Créez une tâche avec la charge utile hello et ajoutez cette tâche à la file d'attente. La charge utile peut être n'importe quelle donnée de la requête dont le service de nœud de calcul a besoin pour traiter la tâche.

   node createTask.js $PROJECT_ID $QUEUE_ID $LOCATION_ID hello
   

3. Vérifiez que la tâche a bien été exécutée en affichant les journaux du service de nœud de calcul.

   gcloud app logs read
   

   Les journaux doivent ressembler à ceci :

   2024-06-20 15:00:00 default[20240620t143852]  "POST /log_payload HTTP/1.1" 200
   2024-06-20 15:00:00 default[20240620t143852]  App listening on port 8081
   2024-06-20 15:00:00 default[20240620t143852]  Press Ctrl+C to quit.
   2024-06-20 15:00:00 default[20240620t143852]  Received task with payload: hello
   

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page ne soient facturées sur votre compte Google Cloud, supprimez le projet Google Cloud contenant les ressources.

Attention : La suppression d'un projet entraîne les effets décrits ci-dessous :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID

Vous pouvez également supprimer les ressources que vous avez créées :

1. Supprimez la file d'attente Cloud Tasks :

   gcloud tasks queues delete QUEUE_NAME \
       --location=REGION
   

2. Désactivez l'application App Engine.

Étape suivante

• Gérer les files d'attente et les tâches
• Créer des files d'attente Cloud Tasks
• Documentation de référence de l'API RPC
• Documentation de référence de l'API REST