Créer un déclencheur à l'aide de Cloud Audit Logs et de la console

Créer un déclencheur à l'aide de Cloud Audit Logs et de la console

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

Vous pouvez suivre ce guide de démarrage rapide dans la console. Pour obtenir des instructions sur l'utilisation de Google Cloud CLI, consultez la page Recevoir des événements à l'aide de Cloud Audit Logs (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 service récepteur d'événements sur Cloud Run ;

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.

Remarque : Pour les projets soumis à des règles d'administration de partage restreint de domaine, utilisez un service cible Cloud Run avec authentification. Pour en savoir plus sur les rôles, les autorisations et les options requis pour les appels authentifiés, consultez la page Rôles et autorisations Eventarc.

---

Pour obtenir des conseils détaillés sur cette tâche directement dans la console, cliquez sur Visite guidée :

Visite guidée

---

La procédure décrite dans les sections suivantes, est la même que si vous cliquez sur Visite guidée.

Avant de commencer

Certaines étapes de ce document risquent de ne pas fonctionner correctement si votre organisation applique des contraintes à votre environnement Google Cloud. Dans ce cas, vous ne pourrez peut-être pas effectuer des tâches telles que la création d'adresses IP publiques ou de clés de compte de service. Si vous effectuez une requête qui renvoie une erreur concernant des contraintes, consultez la section Développer des applications dans un environnement Google Cloud limité.

1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.

4. Activer les API Cloud Build and Eventarc.

   Activer les API

5. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

6. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.

7. Activer les API Cloud Build and Eventarc.

   Activer les API

Créer un bucket Cloud Storage

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

1. Dans la console, accédez à Cloud Storage.
   

   Accéder à Cloud Storage

2. Cliquez sur Create bucket (Créer un bucket).

   

3. Saisissez un nom unique pour le bucket. Exemple :helloworld-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 Create (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

Déployez un service Cloud Run qui reçoit et consigne les événements.

1. Dupliquez l'exemple de dépôt dans votre compte GitHub :

   Go

   1. Sur GitHub, accédez à GoogleCloudPlatform/golang-samples.

   2. Cliquez sur Fork (Dupliquer).

      

   3. Si vous y êtes invité, sélectionnez l'emplacement où vous souhaitez dupliquer le dépôt.

   Java

   1. Sur GitHub, accédez à GoogleCloudPlatform/java-docs-samples.

   2. Cliquez sur Fork (Dupliquer).

      

   3. Si vous y êtes invité, sélectionnez l'emplacement où vous souhaitez dupliquer le dépôt.

   .NET

   1. Sur GitHub, accédez à GoogleCloudPlatform/dotnet-docs-samples.

   2. Cliquez sur Fork (Dupliquer).

      

   3. Si vous y êtes invité, sélectionnez l'emplacement où vous souhaitez dupliquer le dépôt.

   Node.js

   1. Sur GitHub, accédez à GoogleCloudPlatform/nodejs-docs-samples.

   2. Cliquez sur Fork (Dupliquer).

      

   3. Si vous y êtes invité, sélectionnez l'emplacement où vous souhaitez dupliquer le dépôt.

   Python

   1. Sur GitHub, accédez à GoogleCloudPlatform/python-docs-samples.

   2. Cliquez sur Fork (Dupliquer).

      

   3. Si vous y êtes invité, sélectionnez l'emplacement où vous souhaitez dupliquer le dépôt.

2. Dans la console, accédez à Cloud Run.
   

   Accédez à Cloud Run

3. Cliquez sur Créer un service.

4. Dans le formulaire Créer un service, sélectionnez Déployer de nouvelles révisions en continu à partir d'un dépôt source.

5. Cliquez sur Set up with Cloud Build (Effectuer la configuration avec Cloud Build).

6. Dans le formulaire Set up with Cloud Build (Effectuer la configuration avec Cloud Build), procédez comme suit :
   

   

   1. Si vous y êtes invité, activez l'API Cloud Build.

   2. Dans la liste Repository Provider (Fournisseur de dépôts), sélectionnez GitHub.

      Remarque : Si vous n'êtes pas encore authentifié, cliquez sur S'authentifier, puis suivez les instructions pour vous connecter à votre dépôt à l'aide de l'application GitHub Cloud Build.

   3. Dans la liste Dépôt, sélectionnez le dépôt GitHub que vous avez dupliqué.

   4. Une fois que vous avez sélectionné votre compte et votre dépôt GitHub, cochez la case pour accepter les conditions de la clause de non-responsabilité, puis cliquez sur Suivant.

   5. Laissez le champ Branche sur ^main$.

   6. Pour le champ Type de compilation, sélectionnez Dockerfile et indiquez l'emplacement source du fichier Dockerfile :

      eventarc/audit-storage/Dockerfile
      

      Ou, pour l'exemple Go :

      eventarc/audit_storage/Dockerfile
      

   7. Cliquez sur Enregistrer.

7. Dans le formulaire Créer un service, saisissez un nom de service. Exemple : helloworld-events.

8. Acceptez la valeur Region (Région) par défaut comme emplacement de service. Par exemple, us-central1(Iowa).

9. Acceptez les paramètres par défaut pour l'allocation et la tarification du processeur et l'autoscaling.

10. Dans la section Ingress, sélectionnez Autoriser tout le trafic.

11. Dans la section Authentication, cochez Autoriser les appels non authentifiés.

12. Cliquez sur Create (Créer).

Créer un déclencheur Eventarc

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

1. Dans la console, accédez à Eventarc.
   

   Accéder à Eventarc

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

3. Saisissez un nom de déclencheur.

   Par exemple, helloworld-trigger.

4. Dans la liste Fournisseur d'événements, sélectionnez Sources Google > Cloud Storage.

5. Dans la liste Événement, sélectionnez Direct > google.cloud.storage.object.v1.finalized.

6. Pour le champ Bucket, spécifiez le bucket Cloud Storage helloworld-bucket que vous avez créé précédemment.

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

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

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

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

10. Pour le service Cloud Run, sélectionnez le service helloworld-events que vous avez créé précédemment.

11. Cliquez sur Create (Créer).

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, accédez à Cloud Storage.
      

      Accéder à Cloud Storage

   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, accédez à Cloud Run.
      

      Accédez à Cloud Run

   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

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, accédez à Eventarc.
   

   Accéder à Eventarc

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 Cloud arrête la facturation de toutes les ressources utilisées dans ce projet.

Attention : La suppression d'un projet aura les effets suivants :
• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour ce tutoriel 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. Dans la console Google Cloud, accédez à la page Gérer les ressources.

   Accéder à la page Gérer les ressources

2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Étape suivante

• Recevoir un événement Cloud Audit Logs pour les charges de travail de production
• Créer un déclencheur Eventarc pour Cloud Run
• Développer des services Cloud Run