Créer un bus pour acheminer les messages

Un bus Eventarc Advanced vous permet de centraliser, de surveiller et de suivre le flux de messages dans votre système, et agit comme un routeur. Il reçoit des événements d'une source de messages ou publiés par un fournisseur, et les évalue en fonction d'un enregistrement. Un enregistrement identifie un abonnement à un bus spécifique et définit les critères de correspondance pour les messages, ce qui les achemine en conséquence. Pour en savoir plus, consultez la section Créer une inscription pour recevoir des événements.

Un bus peut être utilisé par les fournisseurs d'événements et les destinations de votre projet ou d'autres projets. Pour en savoir plus, consultez la section Mises en page de projet.

Rôles requis

Un rôle IAM (Identity and Access Management) contient un ensemble d'autorisations qui vous permet d'effectuer des actions spécifiques sur les ressources Google Cloud. Les rôles et autorisations suivants sont requis lorsque vous créez un bus pour acheminer des messages:

  • Pour obtenir l'autorisation dont vous avez besoin pour créer un bus, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Eventarc (roles/eventarc.admin) ou Administrateur du bus de messages Eventarc (roles/eventarc.messageBusAdmin) sur votre projet de bus. Ces rôles prédéfinis contiennent l'autorisation eventarc.messageBuses.create, qui est requise pour créer un bus.
  • Pour obtenir l'autorisation dont vous avez besoin pour utiliser un bus, demandez à votre administrateur de vous accorder le rôle IAM Utilisateur du bus de messages Eventarc (roles/eventarc.messageBusUser) sur votre projet de bus. Ce rôle prédéfini contient l'autorisation eventarc.buses.use, qui est requise pour utiliser un bus.
  • Pour créer un pipeline et une inscription, des autorisations supplémentaires sont requises. Pour en savoir plus, consultez les rôles requis pour créer une inscription.

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès. Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer un bus

Vous pouvez créer un bus dans la console Google Cloud ou à l'aide de gcloud CLI.

Console

  1. Dans la console Google Cloud, accédez à la page Eventarc > Bus.

    Accéder à "Bus"

  2. Cliquez sur Créer un bus.

  3. Sur la page Créer un bus, procédez comme suit:

    1. Saisissez un nom de bus. Il s'agit de l'ID de votre bus.
    2. Facultatif: saisissez un nom à afficher du bus qui s'affiche sur la page Détails du bus.
    3. Dans la liste Région, sélectionnez une région compatible dans laquelle déployer votre bus.
    4. Pour Chiffrement, acceptez la clé de chiffrement gérée par Google par défaut ou sélectionnez Clé Cloud KMS. Pour en savoir plus, consultez la section Utiliser des clés de chiffrement gérées par le client (CMEK).

    5. Si vous sélectionnez Clé Cloud KMS, procédez comme suit:

      1. Dans la liste Type de clé, sélectionnez une méthode pour gérer vos clés.

        Vous pouvez gérer vos clés manuellement ou utiliser Autokey, qui vous permet de générer des trousseaux de clés et des clés à la demande. Si l'option Cloud KMS avec Autokey est désactivée, cela indique qu'elle n'est pas encore intégrée au type de ressource actuel.

      2. Dans Sélectionner une clé Cloud KMS, sélectionnez une clé.

        Notez que vous devez sélectionner une région avant de pouvoir afficher vos clés gérées par le client.

      3. (Facultatif) Pour saisir manuellement le nom de ressource de la clé, dans la liste Sélectionner une clé gérée par le client, cliquez sur Saisir la clé manuellement, puis saisissez le nom de clé au format spécifié.

      4. Si vous y êtes invité, attribuez le rôle cloudkms.cryptoKeyEncrypterDecrypter à l'agent de service Eventarc.

    6. Facultatif: Pour ajouter une source de messages, cliquez sur Ajouter une source.

      1. Dans le volet Ajouter une source de messages, pour le fournisseur de messages de l'API Google, acceptez la valeur par défaut google-api-source ou saisissez un autre nom de source.

      2. Cliquez sur Créer.

        Cela permet de collecter automatiquement les événements provenant directement de sources Google.

        Notez que seuls les événements provenant de ressources du même projet Google Cloud que le bus sont publiés. Pour en savoir plus, consultez la section Publier des événements à partir de sources Google.

    7. Facultatif: Pour ajouter des libellés, cliquez sur Ajouter un libellé. Les libellés sont des paires clé/valeur qui vous aident à organiser vos ressources Google Cloud. Pour en savoir plus, consultez la section Que sont les libellés ?

  4. Cliquez sur Créer.

gcloud

  1. Ouvrez un terminal.

  2. Créez un bus à l'aide de la commande gcloud beta eventarc message-buses create.

    gcloud beta eventarc message-buses create BUS_NAME \
    --location=REGION

    Remplacez les éléments suivants :

    • BUS_NAME: ID ou identifiant complet du bus

    • REGION: emplacement compatible pour le bus

      Vous pouvez également définir la propriété d'emplacement de Google Cloud CLI:

      gcloud config set eventarc/location REGION

    Facultatif: Vous pouvez également utiliser les options suivantes:

    • --async pour quitter immédiatement la commande, sans attendre la fin de l'opération en cours.
    • --crypto-key pour spécifier le nom complet d'une clé de chiffrement gérée par le client. Si ce n'est pas spécifié, des clés gérées par Google sont utilisées.
    • --logging-config pour configurer le niveau de journalisation, qui doit correspondre à l'un des éléments suivants: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY.

Supprimer un bus

Vous pouvez supprimer un bus dans la console Google Cloud ou à l'aide de gcloud CLI.

Console

  1. Dans la console Google Cloud, accédez à la page Eventarc > Bus.

    Accéder à "Bus"

  2. Cliquez sur le nom du bus que vous souhaitez supprimer.

    La page Détails du bus s'ouvre.

  3. Cliquez sur Supprimer.

  4. Lorsque vous êtes invité à supprimer le bus, cochez la case Voulez-vous continuer ? pour confirmer que les sources de messages configurées pour utiliser le bus ne pourront plus le faire.

  5. Pour confirmer la suppression, saisissez Delete.

  6. Cliquez sur Supprimer.

gcloud

  1. Ouvrez un terminal.

  2. Supprimez un bus à l'aide de la commande gcloud beta eventarc message-buses delete.

    gcloud beta eventarc message-buses delete BUS_NAME \
    --location=REGION

    Remplacez les éléments suivants :

Étape suivante