Publier des événements dans un job Cloud Run
Ce guide de démarrage rapide vous explique comment publier et recevoir des messages d'événement en créant un bus et un enregistrement Eventarc Advanced dans votre projet Google Cloud.
Un bus fait office de routeur central. Il reçoit les messages provenant de sources d'événements ou publiés par des fournisseurs.
Un enregistrement achemine les messages reçus par le bus vers une ou plusieurs destinations via un pipeline de traitement.
Dans le cadre de ce guide démarrage rapide, vous allez effectuer les étapes suivantes :
Déployez un job Cloud Run à partir du code source.
Créez un bus Eventarc Advanced.
Créez un enregistrement Eventarc Advanced.
Publiez un message d'événement dans le bus.
Vérifiez que le job Cloud Run s'est bien exécuté.
Vous pouvez suivre ce guide de démarrage rapide dans gcloud CLI.
Avant de commencer
Les contraintes de sécurité définies par votre organisation peuvent vous empêcher d'effectuer les étapes suivantes. Pour en savoir plus sur la résolution des problèmes, consultez Développer des applications dans un environnement Google Cloud limité.
- 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 sans frais pour exécuter, tester et déployer des charges de travail.
-
Installez la Google Cloud CLI.
-
Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
-
Pour initialiser la gcloud CLI, exécutez la commande suivante :
gcloud init -
Créez ou sélectionnez un projet Google Cloud .
Rôles requis pour sélectionner ou créer un projet
- Sélectionnez un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique. Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
-
Créer un projet : pour créer un projet, vous devez disposer du rôle Créateur de projet (
roles/resourcemanager.projectCreator), qui contient l'autorisationresourcemanager.projects.create. Découvrez comment attribuer des rôles.
-
Créez un projet Google Cloud :
gcloud projects create PROJECT_ID
Remplacez
PROJECT_IDpar le nom du projet Google Cloud que vous créez. -
Sélectionnez le projet Google Cloud que vous avez créé :
gcloud config set project PROJECT_ID
Remplacez
PROJECT_IDpar le nom de votre projet Google Cloud .
-
Vérifiez que la facturation est activée pour votre projet Google Cloud .
Activez les API Artifact Registry, Cloud Build, Cloud Run et Eventarc, si ce n'est pas déjà fait :
Rôles requis pour activer les API
Pour activer les API, vous devez disposer de l'autorisation
serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.gcloud services enable artifactregistry.googleapis.com
cloudbuild.googleapis.com eventarc.googleapis.com eventarcpublishing.googleapis.com run.googleapis.com -
Installez la Google Cloud CLI.
-
Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
-
Pour initialiser la gcloud CLI, exécutez la commande suivante :
gcloud init -
Créez ou sélectionnez un projet Google Cloud .
Rôles requis pour sélectionner ou créer un projet
- Sélectionnez un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique. Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
-
Créer un projet : pour créer un projet, vous devez disposer du rôle Créateur de projet (
roles/resourcemanager.projectCreator), qui contient l'autorisationresourcemanager.projects.create. Découvrez comment attribuer des rôles.
-
Créez un projet Google Cloud :
gcloud projects create PROJECT_ID
Remplacez
PROJECT_IDpar le nom du projet Google Cloud que vous créez. -
Sélectionnez le projet Google Cloud que vous avez créé :
gcloud config set project PROJECT_ID
Remplacez
PROJECT_IDpar le nom de votre projet Google Cloud .
-
Vérifiez que la facturation est activée pour votre projet Google Cloud .
Activez les API Artifact Registry, Cloud Build, Cloud Run et Eventarc, si ce n'est pas déjà fait :
Rôles requis pour activer les API
Pour activer les API, vous devez disposer de l'autorisation
serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.gcloud services enable artifactregistry.googleapis.com
cloudbuild.googleapis.com eventarc.googleapis.com eventarcpublishing.googleapis.com run.googleapis.com - Mettez à jour les composants
gcloud:gcloud components update
- Connectez-vous à votre compte :
gcloud auth login
- Définissez la variable de configuration utilisée dans ce guide de démarrage rapide :
REGION=REGION
Remplacez
REGIONpar un emplacement compatible pour le bus (par exemple,us-central1). -
Si vous êtes le créateur du projet, vous disposez du rôle de base Propriétaire (
roles/owner). Par défaut, ce rôle Identity and Access Management (IAM) inclut les autorisations nécessaires pour accéder à la plupart des ressources Google Cloud. Vous pouvez ignorer cette étape.Si vous n'êtes pas le créateur du projet, les autorisations requises doivent être accordées au compte principal approprié sur le projet. Par exemple, un compte principal peut être un compte Google (pour les utilisateurs finaux) ou un compte de service (pour les applications et les charges de travail de calcul).
Autorisations requises
Pour obtenir les autorisations nécessaires pour suivre ce guide de démarrage rapide, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :
- Développeur Cloud Run (
roles/run.developer) - Développeur Eventarc (
roles/eventarc.developer) - Administrateur de bus à messages Eventarc (
roles/eventarc.messageBusAdmin) - Accesseur de vues de journaux (
roles/logging.viewAccessor) - Administrateur de projet IAM (
roles/resourcemanager.projectIamAdmin) - Administrateur de compte de service (
roles/iam.serviceAccountAdmin) -
Utilisateur du compte de service (
roles/iam.serviceAccountUser) - Administrateur Service Usage (
roles/serviceusage.serviceUsageAdmin)
Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.
- Développeur Cloud Run (
- Pour accorder à Eventarc Advanced les autorisations nécessaires pour exécuter un job Cloud Run, demandez à votre administrateur d'attribuer le rôle IAM Demandeur Cloud Run (
roles/run.invoker) sur votre projetGoogle Cloud à un compte de service :- Créez un compte de service. À des fins de test, vous allez associer ce compte de service à un pipeline Eventarc Advanced pour représenter l'identité du pipeline.
Remplacezgcloud iam service-accounts create SERVICE_ACCOUNT_NAME
SERVICE_ACCOUNT_NAMEpar le nom de votre compte de service. - Attribuez le rôle IAM
roles/run.invokerau compte de service :gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" \ --role=roles/run.invoker
- Créez un compte de service. À des fins de test, vous allez associer ce compte de service à un pipeline Eventarc Advanced pour représenter l'identité du pipeline.
Déployer un job Cloud Run à partir du code source
Déployez un job Cloud Run comme destination de vos événements. Contrairement à un service Cloud Run, qui écoute et diffuse les requêtes, un job Cloud Run n'exécute que ses tâches et se ferme une fois qu'elle a terminé. Un job n'écoute pas et ne diffuse pas les requêtes.
D'autres destinations d'événements sont acceptées, comme un sujet Pub/Sub, des workflows ou un autre point de terminaison HTTP. Pour en savoir plus, consultez Fournisseurs et destinations d'événements.
Créez un job à partir du code source Python à l'aide de la commande gcloud run jobs deploy. Votre code est automatiquement empaqueté dans une image de conteneur, importé dans Artifact Registry, puis déployé dans Cloud Run.
Créez un répertoire nommé
jobset accédez-y :mkdir jobs cd jobsCréez un fichier
main.pyet copiez-y l'exemple de code suivant :import os TASK_INDEX = os.getenv("CLOUD_RUN_TASK_INDEX", 0) def main(): """ This job prints "Hello world" """ print(f"Starting task #{TASK_INDEX}...") print("Hello world") print(f"Completed task #{TASK_INDEX}.") # Start script if __name__ == "__main__": main()Créez un fichier texte nommé
Procfilesans extension de fichier et copiez-y le texte suivant :web: python3 main.pyDéployez le job :
gcloud run jobs deploy JOB_NAME \ --source . \ --tasks 1 \ --region=$REGION
Remplacez
JOB_NAMEpar un nom unique pour le job Cloud Run, par exemplemy-job.
Créer un bus Eventarc Advanced
Un bus reçoit les messages d'événement d'une source de messages ou publiés par un fournisseur, et sert de routeur de messages.
Pour en savoir plus, consultez Créer un bus pour acheminer les messages.
Créez un bus Eventarc Advanced dans votre projet à l'aide de la commande gcloud eventarc message-buses create :
gcloud eventarc message-buses create BUS_NAME \ --location=$REGION
Remplacez BUS_NAME par l'ID de votre bus ou par un nom complet, par exemple my-bus.
Créer un enregistrement Eventarc Advanced
Un enregistrement détermine les messages qui sont acheminés vers une destination. Il spécifie également le pipeline utilisé pour configurer la destination des messages d'événement. Dans ce cas, la destination cible est un job Cloud Run.
Pour en savoir plus, consultez Créer un enregistrement pour recevoir des événements.
Lorsque vous utilisez la gcloud CLI, vous devez d'abord créer un pipeline, puis un enregistrement :
Créez un pipeline à l'aide de la commande
gcloud eventarc pipelines create:gcloud eventarc pipelines create PIPELINE_NAME \ --destinations=http_endpoint_uri='JOB_URI',http_endpoint_message_binding_template='{"body": ""}',oauth_token_authentication_service_account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \ --input-payload-format-json= \ --location=$REGION
Remplacez les éléments suivants :
PIPELINE_NAME: ID du pipeline ou nom complet, par exemplemy-pipeline.JOB_URI: URI du job Cloud Run au format suivant :https://REGION-run.googleapis.com/apis/run.googleapis.com/v1/namespaces/PROJECT_NUMBER/jobs/JOB_NAME:run
Vous pouvez récupérer le numéro de votre projet en exécutant la commande suivante :
gcloud projects describe PROJECT_ID --format='value(projectNumber)'
Veuillez noter les points suivants :
- La clé
http_endpoint_message_binding_templatetransforme l'événement au format attendu par l'API Cloud Run Admin. Lorsque vous définissez une liaison de message, vous devez configurer un format d'entrée pour accéder à la charge utile. Par exemple :{"body": ""}. - La clé
oauth_token_authentication_service_accountspécifie une adresse e-mail de compte de service. Cette adresse e-mail est utilisée pour générer un jeton OAuth, généralement utilisé uniquement lors de l'appel des API Google hébergées sur*.googleapis.com.
Créez un enregistrement à l'aide de la commande
gcloud eventarc enrollments create:gcloud eventarc enrollments create ENROLLMENT_NAME \ --cel-match=MATCH_EXPRESSION \ --destination-pipeline=PIPELINE_NAME \ --message-bus=BUS_NAME \ --message-bus-project=PROJECT_ID \ --location=$REGION
Remplacez les éléments suivants :
ENROLLMENT_NAME: ID de l'inscription ou nom complet, par exemplemy-enrollment.MATCH_EXPRESSION: expression de correspondance pour cet enregistrement à l'aide de CEL, par exemple :"message.type == 'hello-world-type'"
Publier un message d'événement dans le bus
Pour publier directement un message sur votre bus, utilisez la commande gcloud eventarc message-buses publish ou envoyez une requête à l'API REST Eventarc Publishing.
Pour en savoir plus, consultez Publier des événements directement.
Le message doit être au format CloudEvents, une spécification permettant d'uniformiser la description des données d'événement. L'élément data est la charge utile de votre événement. Tout code JSON bien formé peut être inséré dans ce champ. Pour en savoir plus sur les attributs de contexte CloudEvents, consultez Format d'événement.
Voici des exemples de publication directe d'un événement sur un bus Eventarc Advanced :
Exemple 1
Publiez un événement sur un bus à l'aide de la gcloud CLI et d'un --event-data ainsi que d'autres indicateurs d'attributs d'événement :
gcloud eventarc message-buses publish BUS_NAME \
--event-data='{"key": "hello-world-data"}' \
--event-id=hello-world-id-1234 \
--event-source=hello-world-source \
--event-type=hello-world-type \
--event-attributes="datacontenttype=application/json" \
--location=$REGION
Exemple 2
Publiez un événement sur un bus en tant que message JSON à l'aide de la gcloud CLI et d'un flag --json-message :
gcloud eventarc message-buses publish BUS_NAME \
--location=$REGION \
--json-message='{"id": "hello-world-id-1234", "type":
"hello-world-type", "source":
"hello-world-source", "specversion": "1.0", "data":
{"key": "hello-world-data"}}'
Une fois l'événement publié, vous devriez recevoir le message "Événement publié".
Vérifier que le job Cloud Run s'est exécuté correctement
Après avoir publié un événement sur votre bus Eventarc Advanced, consultez les journaux de votre job Cloud Run pour vérifier qu'il s'est bien exécuté et que "Hello world" a été imprimé. L'exécution et la finalisation du job peuvent prendre quelques minutes.
Filtrez les entrées de journal et renvoyez le résultat à l'aide de la commande
gcloud logging read:gcloud logging read 'textPayload: "Hello world"'
Recherchez une entrée de journal semblable à ceci :
insertId: 693c8dd0000cb2976d7966b8 ... labels: job_name: JOB_NAME location: REGION project_id: PROJECT_ID type: cloud_run_job textPayload: Hello world timestamp: '2025-12-12T21:49:04.832151Z'Vous pouvez également vérifier que le job Cloud Run s'est exécuté correctement à l'aide de la commande
gcloud run jobs describe:gcloud run jobs describe JOB_NAME \ --region=$REGIONDes résultats semblables aux lignes suivantes devraient s'afficher :
✔ Job JOB_NAME in region us-central1 Executed 1 time ...
Vous avez créé un bus et un enregistrement Eventarc Advanced, publié un message d'événement dans le bus et vérifié le résultat attendu dans les journaux du récepteur d'événements.
Effectuer un nettoyage
Pour éviter de continuer à payer des frais une fois ce guide de démarrage rapide terminé, supprimez les ressources que vous avez créées :Supprimez les ressources Eventarc Advanced :
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.
Supprimer un projet Google Cloud :
gcloud projects delete PROJECT_ID