Configurer un sujet et un abonnement Pub/Sub

Dans Application Design Center, vous pouvez configurer un sujet et un abonnement Pub/Sub pour fournir une messagerie asynchrone et évolutive qui dissocie les services produisant des messages des services qui les traitent. Vous pouvez personnaliser les connexions des composants et les paramètres de configuration de votre sujet et de votre abonnement en fonction du module Terraform terraform-google-pubsub sur GitHub.

Connexions des composants

Le tableau suivant inclut les composants que vous pouvez connecter à un sujet ou à un abonnement Pub/Sub, ainsi que les mises à jour de votre application et de son code Terraform généré qui en résultent.

Composant connecté Mises à jour de l'application Informations générales

Modèle d'instance Compute Engine

  • Les instances Compute Engine peuvent publier des messages dans le sujet Pub/Sub et en recevoir.
  • L'ID du sujet Pub/Sub est ajouté aux métadonnées du modèle d'instance Compute Engine.
Modèles d'instance

Compte de service

  • Le compte de service peut gérer les sujets Pub/Sub et extraire les messages des abonnements.
  • Le rôle roles/pubsub.editor est attribué au compte de service.
  • Le nom et l'adresse e-mail du compte de service sont ajoutés à l'abonnement pull Pub/Sub.
Contrôle des accès avec Identity and Access Management (IAM)

BigQuery

  • L'abonnement Pub/Sub peut écrire des messages dans une table de l'ensemble de données BigQuery.
  • Les informations sur l'ensemble de données et la table BigQuery sont ajoutées aux champs de l'abonnement Pub/Sub.
Abonnements BigQuery

Cloud Run

  • Le service Cloud Run peut recevoir des messages ou publier dans le sujet Pub/Sub.
  • L'ID du sujet Pub/Sub est ajouté aux variables d'environnement Cloud Run.
  • Les rôles roles/pubsub.publisher et roles/pubsub.subscriber sont attribués au compte de service Cloud Run.
  • Le service Cloud Run est ajouté aux champs d'abonnement push et pull Pub/Sub.
Tutoriel : Utiliser Pub/Sub avec Cloud Run

Cloud Storage

  • L'abonnement Pub/Sub peut écrire des messages dans le bucket Cloud Storage.
  • Les informations sur le bucket Cloud Storage sont ajoutées aux champs de l'abonnement Pub/Sub.
Abonnements Cloud Storage

Paramètres de configuration requis

Si votre modèle inclut un composant Pub/Sub, vous devez configurer les paramètres suivants avant de le déployer.

Nom du paramètre Description et contraintes Informations générales

ID du projet

Projet dans lequel vous souhaitez déployer la ressource Pub/Sub.

Configurer les composants

Sujet

name Consignes de dénomination d'un sujet, d'un abonnement, d'un schéma ou d'un instantané

Paramètres de configuration facultatifs

Les paramètres suivants sont facultatifs. Pour afficher les paramètres avancés, dans la zone Configuration, sélectionnez Afficher les champs avancés.

Fonctionnalité Nom du paramètre Description et informations sur les contraintes Informations générales
Créer un sujet Par défaut, un sujet est créé. Décochez la case si vous ne souhaitez pas créer de sujet. Créer un sujet
Créer des abonnements Par défaut, un abonnement est créé. Décochez la case si vous ne souhaitez pas créer d'abonnement. Présentation des abonnements
Libellés de thèmes Clé labels Signaler l'utilisation avec des étiquettes
Libellés de thèmes Valeur labels Signaler l'utilisation avec des étiquettes
Abonnements push Nom name Consignes de dénomination d'un sujet, d'un abonnement, d'un schéma ou d'un instantané
Abonnements push Délai de confirmation (en secondes) ackDeadlineSeconds Délai de confirmation
Abonnements push Point de terminaison push pushEndpoint Points de terminaison
Abonnements push X-goog-version Format de l'API Pub/Sub du message envoyé. Par exemple, v1beta1. attributes
Abonnements push Adresse e-mail du compte de service OIDC serviceAccountEmail Authentification
Abonnements push Audience audience Authentification
Abonnements push Règle d'expiration expirationPolicy Période d'expiration
Abonnements push Sujet des lettres mortes deadLetterTopic Sujet des lettres mortes
Abonnements push Conserver les messages confirmés retainAckedMessages Conserver les messages confirmés
Abonnements push Durée de conservation des messages messageRetentionDuration Durée de conservation des messages
Abonnements push Nombre maximal de tentatives d'envoi maxDeliveryAttempts Sujet des lettres mortes
Abonnements push Intervalle maximal entre les tentatives maximumBackoff Règle de nouvelle tentative
Abonnements push Intervalle minimal entre les tentatives minimumBackoff Règle de nouvelle tentative
Abonnements push Filter filter Filtre d'abonnement
Abonnements push Activer l'ordre des messages enableMessageOrdering Tri des messages
Abonnements pull Nom name Consignes de dénomination d'un sujet, d'un abonnement, d'un schéma ou d'un instantané
Abonnements pull Délai de confirmation (en secondes) ackDeadlineSeconds Délai de confirmation
Abonnements pull Sujet des lettres mortes deadLetterTopic Sujet des lettres mortes
Abonnements pull Nombre maximal de tentatives d'envoi maxDeliveryAttempts Sujet des lettres mortes
Abonnements pull Conserver les messages confirmés retainAckedMessages Conserver les messages confirmés
Abonnements pull Durée de conservation des messages messageRetentionDuration Durée de conservation des messages
Abonnements pull Intervalle maximal entre les tentatives maximumBackoff Règle de nouvelle tentative
Abonnements pull Intervalle minimal entre les tentatives minimumBackoff Règle de nouvelle tentative
Abonnements pull Filter filter Filtre d'abonnement
Abonnements pull Activer l'ordre des messages enableMessageOrdering Tri des messages
Abonnements pull Compte de service Le compte de service auquel est attribué le rôle roles/pubsub.subscriber sur l'abonnement. Contrôle des accès avec IAM
Abonnements pull Activer la distribution de type "exactement une fois" enableExactlyOnceDelivery Distribution de type "exactement une fois"
Abonnements BigQuery Nom name Consignes de dénomination d'un sujet, d'un abonnement, d'un schéma ou d'un instantané
Abonnements BigQuery Table table Créer des abonnements BigQuery
Abonnements BigQuery Utiliser un schéma de sujet useTopicSchema Utiliser un schéma avec sujet
Abonnements BigQuery Utiliser un schéma de table useTableSchema Utiliser un schéma de table
Abonnements BigQuery Écrire des métadonnées writeMetadata Écrire des métadonnées
Abonnements BigQuery Supprimer les champs inconnus dropUnknownFields Supprimer les champs inconnus
Abonnements BigQuery Délai de confirmation (en secondes) ackDeadlineSeconds Délai de confirmation
Abonnements BigQuery Conserver les messages confirmés retainAckedMessages Conserver les messages confirmés
Abonnements BigQuery Durée de conservation des messages messageRetentionDuration Durée de conservation des messages
Abonnements BigQuery Activer l'ordre des messages enableMessageOrdering Tri des messages
Abonnements BigQuery Règle d'expiration expirationPolicy Période d'expiration
Abonnements BigQuery Filter filter Filtre d'abonnement
Abonnements BigQuery Sujet des lettres mortes deadLetterTopic Sujet des lettres mortes
Abonnements BigQuery Intervalle maximal entre les tentatives maximumBackoff Règle de nouvelle tentative
Abonnements BigQuery Intervalle minimal entre les tentatives minimumBackoff Règle de nouvelle tentative
Abonnements Cloud Storage Nom name Consignes de dénomination d'un sujet, d'un abonnement, d'un schéma ou d'un instantané
Abonnements Cloud Storage Bucket bucket Nom du bucket
Abonnements Cloud Storage Préfixe du nom de fichier filenamePrefix Préfixe, suffixe et date/heure du nom de fichier
Abonnements Cloud Storage Suffixe du nom de fichier filenameSuffix Préfixe, suffixe et date/heure du nom de fichier
Abonnements Cloud Storage Format de date et d'heure du nom de fichier filenameDatetimeFormat Préfixe, suffixe et date/heure du nom de fichier
Abonnements Cloud Storage Durée max. maxDuration Traitement des fichiers par lot
Abonnements Cloud Storage Max Bytes maxBytes Traitement des fichiers par lot
Abonnements Cloud Storage Nombre maximal de messages maxMessages Traitement des fichiers par lot
Abonnements Cloud Storage Format de sortie textConfig ou avroConfig Format de fichier
Abonnements Cloud Storage Écrire des métadonnées writeMetadata Format de fichier
Abonnements Cloud Storage Utiliser un schéma de sujet useTopicSchema Format de fichier
Abonnements Cloud Storage Délai de confirmation (en secondes) ackDeadlineSeconds Délai de confirmation
Abonnements Cloud Storage Conserver les messages confirmés retainAckedMessages Conserver les messages confirmés
Abonnements Cloud Storage Durée de conservation des messages messageRetentionDuration Durée de conservation des messages
Abonnements Cloud Storage Activer l'ordre des messages enableMessageOrdering Tri des messages
Abonnements Cloud Storage Règle d'expiration expirationPolicy Période d'expiration
Abonnements Cloud Storage Filter filter Filtre d'abonnement
Abonnements Cloud Storage Sujet des lettres mortes deadLetterTopic Sujet des lettres mortes
Abonnements Cloud Storage Intervalle maximal entre les tentatives maximumBackoff Règle de nouvelle tentative
Abonnements Cloud Storage Intervalle minimal entre les tentatives minimumBackoff Règle de nouvelle tentative
Étiquettes d'abonnement Clé labels Signaler l'utilisation avec des étiquettes
Étiquettes d'abonnement Valeur labels Signaler l'utilisation avec des étiquettes
Durée de conservation des messages par sujet topicMessageRetentionDuration Durée de conservation des messages
Nom de la clé KMS du sujet kmsKeyName Utiliser une clé de chiffrement gérée par le client (CMEK)
Accorder des rôles de projet BigQuery Par défaut, les rôles Lecteur de métadonnées BigQuery (roles/bigquery.metadataViewer) et Éditeur de données BigQuery (roles/bigquery.dataEditor) sont attribués au compte de service Pub/Sub par défaut. Si vous ne souhaitez pas accorder ces rôles, décochez la case. Attribuer des rôles IAM au compte de service
Accorder le rôle "Créateur de jetons" Par défaut, le rôle Créateur de jetons du compte de service est attribué au compte de service Pub/Sub par défaut. Si vous ne souhaitez pas attribuer ce rôle, décochez la case. Configurer l'authentification pour Pub/Sub
Schéma Nom name Informations importantes sur les schémas
Schéma Type type Types de schémas
Schéma Définition définition Types de schémas
Schéma Encodage encodage Consignes pour associer un schéma à un sujet