Planifier une fonction Cloud Run basée sur des événements

---

Ce tutoriel explique comment déclencher une fonction Cloud Run basée sur des événements à l'aide de Cloud Scheduler et en ciblant un sujet Pub/Sub. Utilisez une fonction basée sur des événements lorsqu'elle doit être déclenchée directement en réponse à des événements au sein de votre projet Google Cloud, tels que des messages sur un sujet Pub/Sub ou des modifications dans un bucket Cloud Storage.

Notez que vous pouvez également planifier une fonction HTTP en ciblant le point de terminaison HTTP de votre fonction. Utilisez une fonction HTTP lorsque vous avez besoin que votre fonction dispose d'un point de terminaison d'URL et réponde aux requêtes HTTP, par exemple pour les webhooks. Pour en savoir plus, consultez la section Types de fonctions Cloud Run.

Il est courant d'utiliser Cloud Scheduler afin de planifier l'exécution d'une fonction Cloud Run. Au cours de ce tutoriel, vous allez :

1. créer une fonction Cloud Run simple qui s'abonne à un sujet Pub/Sub ;
2. Créez une tâche Cloud Scheduler qui publie un message dans le sujet Pub/Sub.
3. exécuter la tâche Cloud Scheduler ;
4. Vérifiez que la fonction Cloud Run a été déclenchée par la tâche Cloud Scheduler.

Coûts

Dans ce document, vous utilisez les composants facturables suivants de Google Cloud :

• Cloud Run functions
• Cloud Scheduler
• Pub/Sub

Obtenez une estimation des coûts en fonction de votre utilisation prévue à l'aide du simulateur de coût. Les nouveaux utilisateurs de Google Cloud peuvent bénéficier d'un essai gratuit.

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. In the Google Cloud console, on the project selector page, select or create 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.

   Go to project selector

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

4. Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler, Eventarc APIs.

   Enable the APIs

5. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the Cloud Run > Cloud Run Invoker role to the service account.

      To grant the role, find the Select a role list, then select Cloud Run > Cloud Run Invoker.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
   6. Click Continue.

   7. Click Done to finish creating the service account.

6. In the Google Cloud console, on the project selector page, select or create 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.

   Go to project selector

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

8. Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler, Eventarc APIs.

   Enable the APIs

9. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the Cloud Run > Cloud Run Invoker role to the service account.

      To grant the role, find the Select a role list, then select Cloud Run > Cloud Run Invoker.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
   6. Click Continue.

   7. Click Done to finish creating the service account.

Notez que vous devez attribuer le rôle de demandeur Cloud Run, car dans Cloud Run Functions (2e génération), les autorisations d'appel sont disponibles en gérant le service Cloud Run sous-jacent.

10. Par défaut, les fonctions Cloud Run utilisent le compte de service Compute Engine par défaut créé automatiquement pour leur compte de service d'exécution. Vous pouvez utiliser ce compte de service pour tester ce tutoriel. 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 Éditeur sur votre projet. Dans ce cas, vous devez attribuer au compte de service les rôles suivants :
    1. Rédacteur Artifact Registry (roles/artifactregistry.writer)
    2. Rédacteur de journaux (roles/logging.logWriter)
    3. Lecteur des objets de l'espace de stockage (roles/storage.objectViewer)

Créer une fonction Cloud Run basée sur des événements

Créez une fonction basée sur des événements qui est déclenchée directement en réponse à des événements au sein de votre projet Google Cloud (dans ce cas, un message publié dans un sujet Pub/Sub).

1. Dans la console Google Cloud, accédez à la page Fonctions Cloud Run.

   Accéder aux fonctions Cloud Run

2. Cliquez sur Créer une fonction.

3. Dans la section Principes de base, procédez comme suit:

   1. Dans la liste Environnement, sélectionnez 2e génération.
   2. Attribuez un nom à votre fonction.
   3. Dans la liste Région, sélectionnez une région.

4. Dans la section Déclencheur, procédez comme suit:

   1. Dans la liste Type de déclencheur, sélectionnez Cloud Pub/Sub.
   2. Dans la liste Sujet Cloud Pub/Sub, sélectionnez un sujet existant ou cliquez sur Créer un sujet pour en créer un. Notez le nom du sujet, car vous en aurez besoin à une étape ultérieure.

   3. Cliquez sur Autres options.

      Le panneau Déclencheur Eventarc s'ouvre.

5. Dans le panneau Déclencheur Eventarc, procédez comme suit:

   1. Si vous êtes invité à autoriser le service Pub/Sub à créer les jetons d'identité dont il a besoin pour appeler la fonction, cliquez sur Accorder.
   2. Dans la liste Compte de service, sélectionnez le compte de service que vous avez créé précédemment.
   3. Acceptez les autres valeurs par défaut.

   4. Cliquez sur Enregistrer le déclencheur.

      Le panneau Déclencheur Eventarc se ferme.

6. Acceptez les autres paramètres par défaut, puis cliquez sur Suivant.

7. Ne modifiez pas la langue d'exécution par défaut ni l'exemple de code. Le code n'utilise aucun service cloud et n'a pas besoin d'autorisations supplémentaires activées. Cliquez sur Déployer.

Créer une tâche Cloud Scheduler

Créez une tâche Cloud Scheduler avec une cible Pub/Sub.

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

   Accéder à Cloud Scheduler

2. Cliquez sur Créer une tâche.

3. Saisissez un nom pour votre tâche.

4. Dans la liste Région, sélectionnez une région.

5. Dans le champ Frequency (Fréquence), spécifiez la fréquence de votre tâche en utilisant un format unix-cron:

   30 16 * * 7
   

   Pour en savoir plus, consultez la section Format et fuseau horaire des tâches Cron.

6. Dans la liste Fuseau horaire, sélectionnez un fuseau horaire.

7. Cliquez sur Continuer.

8. Dans la liste Type de cible, sélectionnez Pub/Sub.

9. Sélectionnez le sujet Pub/Sub que vous avez créé précédemment.

10. Dans le champ Corps du message, saisissez une chaîne à envoyer à votre sujet cible Pub/Sub. (par exemple, "Hello world!")

11. Cliquez sur Créer.

Vous avez créé une job Cron qui envoie un message à votre sujet Pub/Sub à 16h30 les dimanches. Votre fonction Cloud Run est abonnée à ce sujet.

Exécuter votre tâche Cloud Scheduler

Vous pouvez maintenant exécuter la tâche que vous avez créée.

1. Dans Google Cloud Console, accédez à la page Cloud Scheduler.

   Accéder à Cloud Scheduler

2. Cochez la case correspondant à la tâche que vous avez créée, puis cliquez sur Forcer l'exécution.

   Lors de son appel initial, la première tâche créée dans un projet peut prendre quelques minutes à configurer et à exécuter.

3. Une fois la tâche exécutée, l'état État de la dernière exécution doit indiquer Success.

Vérifier les résultats dans les fonctions Cloud Run

Vous pouvez vérifier que votre fonction Cloud Run est correctement déclenchée et exécutée par votre job Cron.

1. Dans la console Google Cloud, accédez à la page Fonctions Cloud Run.

   Accéder aux fonctions Cloud Run

2. Cliquez sur le nom de la fonction.

   La page Informations sur la fonction s'ouvre et le graphique Appels/seconde affiche votre première invocation de la fonction.

3. Cliquez sur l'onglet Journaux.

   Une entrée de journal semblable à Hello, YOUR_STRING! doit s'afficher.

Effectuer un nettoyage

Pour éviter que les ressources utilisées lors de ce tutoriel soient facturées sur votre compte Google Cloud, supprimez le projet contenant les ressources, ou conservez le projet et supprimez les ressources individuelles.

Supprimer le projet

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.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Supprimer les ressources du tutoriel

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

   Accéder à Cloud Scheduler

2. Cochez la case située en regard de votre tâche.

3. Cliquez sur  Supprimer, puis confirmez la suppression.

4. Dans la console Google Cloud, accédez à la page Pub/Sub.

   Accéder à Pub/Sub

5. Cochez la case située à côté de votre sujet.

6. Cliquez sur  Supprimer, puis confirmez la suppression.

7. Dans la console Google Cloud, accédez à la page Fonctions Cloud Run.

   Accéder aux fonctions Cloud Run

8. Cochez la case située à côté de votre fonction.

9. Cliquez sur  Supprimer, puis confirmez la suppression.

10. Dans Google Cloud Console, accédez à la page Comptes de service.

    Accéder à la page "Comptes de service"

11. Cochez la case à côté du compte de service que vous avez créé.

12. Cliquez sur  Supprimer, puis confirmez la suppression.

Étape suivante

• Utiliser Cloud Scheduler pour déclencher Cloud Run de manière planifiée