Recevoir des événements directs à partir de Cloud Storage (console Google Cloud)

Recevoir des événements directs à partir de Cloud Storage (console Google Cloud)

Ce guide de démarrage rapide vous explique comment recevoir des événements directs à partir de Cloud Storage dans un service Cloud Run non authentifié.

Remarque : Tous les services Cloud Run sont déployés en mode privé par défaut, ce qui signifie qu'ils ne sont accessibles qu'à la condition de fournir des identifiants d'authentification dans la requête. Pour les projets soumis à des règles d'administration de partage restreint de domaine, utilisez un service cible Cloud Run authentifié plutôt qu'un service autorisant l'accès public (non authentifié).

Vous pouvez configurer le déclenchement des notifications en réponse à divers événements ayant lieu au sein d'un bucket Cloud Storage : création, suppression et archivage d'objets, ainsi que mises à jour de métadonnées. Pour en savoir plus, consultez la page Créer un déclencheur pour acheminer des événements Cloud Storage vers Cloud Run.

Vous pouvez suivre ce guide de démarrage rapide dans la console Google Cloud. Pour obtenir des instructions sur l'utilisation de Google Cloud CLI, consultez la page Recevoir des événements directs à partir de Cloud Storage (gcloud CLI).

Dans le cadre de ce guide démarrage rapide, vous allez effectuer les étapes suivantes :

1. créer un bucket Cloud Storage qui servira de source d'événements ;

2. déployer un exemple de service sur Cloud Run pour recevoir des événements ;

3. créer un déclencheur Eventarc pour filtrer et acheminer les événements ;

4. générer un événement en important un fichier dans le bucket Cloud Storage et l'afficher dans les journaux Cloud Run.

---

Pour obtenir des instructions détaillées sur cette tâche directement dans la console Google Cloud, cliquez sur Visite guidée :

Visite guidée

---

Avant de commencer

Les contraintes de sécurité définies par votre organisation peuvent vous empêcher d'effectuer les étapes suivantes. Pour obtenir des informations de dépannage, consultez la page Développer des applications dans un environnement Google Cloud limité.

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 and Eventarc APIs.

   Enable the APIs

5. 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

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

7. Enable the Cloud Build and Eventarc APIs.

   Enable the APIs

Créer un bucket Cloud Storage

Ce guide de démarrage rapide utilise Cloud Storage comme source d'événements.

1. Dans la console Google Cloud, accédez à la page Buckets de Cloud Storage.

   Accéder à la page "Buckets"

2. Cliquez sur  Créer.

3. Saisissez un nom unique pour le bucket.

   Par exemple, hello-bucket.

4. Cliquez sur Continuer.

5. Pour le type d'emplacement, sélectionnez Région, puis us-central1 (Iowa).

6. Acceptez les autres valeurs par défaut.

7. Cliquez sur Créer.

Une fois la source d'événements créée, vous pouvez déployer le service récepteur d'événements sur Cloud Run.

Déployer le service récepteur d'événements sur Cloud Run

Vous allez déployer un service Cloud Run qui reçoit et consigne les événements.

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

   Accéder aux services

2. Cliquez sur Créer un service.

3. Dans le formulaire Créer un service :

   1. Sélectionnez Déployer une révision à partir d'une image de conteneur existante.

   2. Cliquez sur Tester avec un exemple de conteneur.

   3. Dans la liste Région, sélectionnez us-central1 (Iowa) pour l'emplacement de votre service.

   4. Dans Authentification, sélectionnez Autoriser les appels non authentifiés.

   5. Pour déployer l'exemple d'image de conteneur, cliquez sur Créer.

Le déploiement du service hello peut prendre jusqu'à deux minutes.

Créer un déclencheur Eventarc

Le déclencheur Eventarc envoie des événements à partir du bucket Cloud Storage vers le service Cloud Run.

1. Dans la console Google Cloud, accédez à la page Déclencheurs d'Eventarc.

   Accéder à la page "Déclencheurs"

2. Cliquez sur Créer un déclencheur.

3. Saisissez un nom de déclencheur.

   Par exemple, hello-trigger.

4. Dans la liste Type de déclencheur, sélectionnez Sources Google.

   Cette action filtre les événements envoyés depuis des fournisseurs Google Cloud (directement ou via des entrées Cloud Audit Logs) ou des fournisseurs utilisant des messages Pub/Sub.

5. Dans la liste Fournisseur d'événements, sélectionnez Cloud Storage.

6. Dans la liste Type d'événement, sélectionnez Direct > google.cloud.storage.object.v1.finalized.

7. Pour le champ Bucket, sélectionnez le bucket Cloud Storage hello-bucket que vous avez créé précédemment.

8. Si vous y êtes invité, accordez les autorisations suivantes :

   • Rôle iam.serviceAccountTokenCreator vers le compte de service Pub/Sub
   • Rôle pubsub.publisher vers le compte de service Cloud Storage

9. Utilisez le compte de service Compute par défaut comme compte de service qui appelle votre service.

10. Dans la liste Destination de l'événement, sélectionnez Cloud Run.

11. Pour le service Cloud Run, sélectionnez l'exemple de service hello que vous avez créé précédemment.

12. Cliquez sur Créer.

La propagation de toutes les autorisations nécessaires à l'agent de service Eventarc peut prendre quelques minutes. Si vous recevez une erreur Permission denied while using the Eventarc Service Agent, attendez quelques minutes, puis réessayez. Une fois le déclencheur créé, cela peut prendre jusqu'à deux minutes avant qu'il ne soit pleinement opérationnel.

Générer et afficher un événement

Générez un événement et vérifiez que le déclencheur Eventarc fonctionne comme prévu.

1. Pour générer un événement, procédez comme suit :

   1. Créez un fichier texte portant le nom random.txt et contenant le texte "Hello World".

   2. Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.

      Accéder à la page "Buckets"

   3. Cliquez sur le nom du bucket de stockage que vous avez créé.

   4. Dans l'onglet Objets, cliquez sur Importer des fichiers, puis importez le fichier random.txt.

   L'importation génère un événement, et le service Cloud Run consigne le message de l'événement.

2. Pour afficher l'entrée de journal, procédez comme suit :

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

      Accéder aux services

   2. Cliquez sur le nom du service que vous avez créé.

   3. Pour récupérer les entrées de journal correspondant à toutes les révisions de ce service, cliquez sur l'onglet Journaux sur la page Informations sur le service. Vous pouvez filtrer les journaux par niveau de gravité.

   4. Recherchez une entrée de journal semblable à ceci :

      Received event of type google.cloud.storage.object.v1.finalized. Event data: [...]

Félicitations ! Vous venez de déployer un service récepteur d'événements sur Cloud Run, de créer un déclencheur Eventarc, de générer un événement à partir de Cloud Storage et de l'afficher dans les journaux Cloud Run.

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud, procédez comme suit :

Bien que Cloud Run ne facture pas un service inutilisé, il se peut que des frais vous soient toujours facturés pour le stockage de l'image de conteneur dans Container Registry, les ressources Cloud Run, et le stockage des fichiers dans votre bucket Cloud Storage.

Vous pouvez supprimer votre image, supprimer votre bucket de stockage et supprimer votre service.

Pour supprimer le déclencheur Eventarc :

1. Dans la console Google Cloud, accédez à la page Déclencheurs d'Eventarc.

   Accéder à la page "Déclencheurs"

2. Cliquez sur le nom du déclencheur que vous avez créé.

3. Sur la page des Informations sur le déclencheur, cliquez sur Supprimer.

Vous pouvez également supprimer votre projet Google Cloud pour éviter des frais. La suppression de votre projet Google Cloud arrête la facturation de toutes les ressources utilisées dans ce 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.
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.

Étapes suivantes

• Recevoir un événement Cloud Audit Logs pour les charges de travail de production
• Exécuter un job Cloud Run dans un workflow à l'aide d'un déclencheur Eventarc
• Développer des services Cloud Run