Configura un argomento e una sottoscrizione Pub/Sub

In Application Design Center, puoi configurare un argomento e una sottoscrizione Pub/Sub per fornire messaggistica asincrona e scalabile che disaccoppia i producer di servizi che producono messaggi dai servizi che li elaborano. Puoi personalizzare le connessioni dei componenti e i parametri di configurazione per l'argomento e la sottoscrizione in base al modulo Terraform terraform-google-pubsub su GitHub.

Connessioni dei componenti

La tabella seguente include i componenti che puoi connettere a un argomento o a una sottoscrizione Pub/Sub e i relativi aggiornamenti alla tua applicazione e al codice Terraform generato.

Componente collegato Aggiornamenti delle applicazioni Informazioni introduttive

Template di istanza Compute Engine

  • Le istanze di Compute Engine possono pubblicare e ricevere messaggi dall'argomento Pub/Sub.
  • L'ID argomento Pub/Sub viene aggiunto ai metadati del template di istanza Compute Engine.
Template di istanza

Service account

  • Il account di servizio può gestire gli argomenti Pub/Sub ed eseguire il pull dei messaggi dalle sottoscrizioni.
  • Il ruolo roles/pubsub.editor viene concesso al account di servizio.
  • Il nome e l'indirizzo email del account di servizio vengono aggiunti alla sottoscrizione pull Pub/Sub.
Controllo degli accessi con Identity and Access Management (IAM)

BigQuery

  • La sottoscrizione Pub/Sub può scrivere messaggi in una tabella del set di dati BigQuery.
  • Le informazioni sul set di dati e sulla tabella BigQuery vengono aggiunte ai campi della sottoscrizione Pub/Sub.
Sottoscrizioni BigQuery

Cloud Run

  • Il servizio Cloud Run può ricevere messaggi o pubblicare nell'argomento Pub/Sub.
  • L'ID argomento Pub/Sub viene aggiunto alle variabili di ambiente di Cloud Run.
  • I ruoli roles/pubsub.publisher e roles/pubsub.subscriber vengono concessi al account di servizio Cloud Run.
  • Il servizio Cloud Run viene aggiunto ai campi della sottoscrizione push e pull di Pub/Sub.
Tutorial sull'utilizzo di Pub/Sub con Cloud Run

Cloud Storage

  • La sottoscrizione Pub/Sub può scrivere messaggi nel bucket Cloud Storage.
  • Le informazioni sul bucket Cloud Storage vengono aggiunte ai campi della sottoscrizione Pub/Sub.
Sottoscrizioni Cloud Storage

Parametri di configurazione obbligatori

Se il modello include un componente Pub/Sub, devi configurare i seguenti parametri prima del deployment.

Nome parametro Descrizione e vincoli Informazioni introduttive

ID progetto

Il progetto in cui vuoi eseguire il deployment della risorsa Pub/Sub.

Configura i componenti

Argomento

name Linee guida per assegnare un nome a un argomento, una sottoscrizione, uno schema o uno snapshot

Parametri di configurazione facoltativi

I seguenti parametri sono facoltativi. Per visualizzare i parametri avanzati, nell'area Configurazione, seleziona Mostra campi avanzati.

Funzionalità Nome parametro Descrizione e informazioni sui vincoli Informazioni introduttive
Crea argomento Per impostazione predefinita, viene creato un argomento. Deseleziona la casella di controllo se non vuoi creare un argomento. Crea un argomento
Crea sottoscrizioni Per impostazione predefinita, viene creata una sottoscrizione. Deseleziona la casella di controllo se non vuoi creare una sottoscrizione. Panoramica degli abbonamenti
Etichette degli argomenti Key (Chiave) labels Crea report sull'utilizzo con etichette
Etichette degli argomenti Valore labels Crea report sull'utilizzo con etichette
Sottoscrizioni push Nome name Linee guida per assegnare un nome a un argomento, una sottoscrizione, uno schema o uno snapshot
Sottoscrizioni push Ack Deadline Seconds ackDeadlineSeconds Scadenza conferma
Sottoscrizioni push Endpoint push pushEndpoint Endpoint
Sottoscrizioni push X-goog-version Il formato dell'API Pub/Sub del messaggio inviato tramite push. Ad esempio, v1beta1. attributes
Sottoscrizioni push Email del service account OIDC serviceAccountEmail Autenticazione
Sottoscrizioni push Pubblico audience Autenticazione
Sottoscrizioni push Policy di scadenza expirationPolicy Periodo di scadenza
Sottoscrizioni push Argomento messaggi non recapitabili deadLetterTopic Argomento messaggi non recapitabili
Sottoscrizioni push Conserva i messaggi confermati retainAckedMessages Conserva messaggi confermati
Sottoscrizioni push Durata di conservazione dei messaggi messageRetentionDuration Durata di conservazione dei messaggi
Sottoscrizioni push Tentativi di consegna massimi maxDeliveryAttempts Argomento messaggi non recapitabili
Sottoscrizioni push Backoff massimo maximumBackoff Policy di ripetizione
Sottoscrizioni push Backoff minimo minimumBackoff Policy di ripetizione
Sottoscrizioni push Filtro filter Filtro di abbonamento
Sottoscrizioni push Abilita l'ordinamento dei messaggi enableMessageOrdering Ordinamento dei messaggi
Sottoscrizioni pull Nome name Linee guida per assegnare un nome a un argomento, una sottoscrizione, uno schema o uno snapshot
Sottoscrizioni pull Ack Deadline Seconds ackDeadlineSeconds Scadenza conferma
Sottoscrizioni pull Argomento messaggi non recapitabili deadLetterTopic Argomento messaggi non recapitabili
Sottoscrizioni pull Tentativi di consegna massimi maxDeliveryAttempts Argomento messaggi non recapitabili
Sottoscrizioni pull Conserva i messaggi confermati retainAckedMessages Conserva messaggi confermati
Sottoscrizioni pull Durata di conservazione dei messaggi messageRetentionDuration Durata di conservazione dei messaggi
Sottoscrizioni pull Backoff massimo maximumBackoff Policy di ripetizione
Sottoscrizioni pull Backoff minimo minimumBackoff Policy di ripetizione
Sottoscrizioni pull Filtro filter Filtro di abbonamento
Sottoscrizioni pull Abilita l'ordinamento dei messaggi enableMessageOrdering Ordinamento dei messaggi
Sottoscrizioni pull Account di servizio Il account di servizio a cui viene concesso il ruolo roles/pubsub.subscriber nella sottoscrizione. Controllo dell'accesso con IAM
Sottoscrizioni pull Abilita la consegna "exactly-once" enableExactlyOnceDelivery Consegna "exactly-once"
Sottoscrizioni BigQuery Nome name Linee guida per assegnare un nome a un argomento, una sottoscrizione, uno schema o uno snapshot
Sottoscrizioni BigQuery Tabella table Crea sottoscrizioni BigQuery
Sottoscrizioni BigQuery Utilizza schema argomento useTopicSchema Utilizza schema argomento
Sottoscrizioni BigQuery Utilizza schema tabella useTableSchema Utilizza schema tabella
Sottoscrizioni BigQuery Scrivi metadati writeMetadata Scrivi metadati
Sottoscrizioni BigQuery Rilascia campi sconosciuti dropUnknownFields Rilascia campi sconosciuti
Sottoscrizioni BigQuery Ack Deadline Seconds ackDeadlineSeconds Scadenza conferma
Sottoscrizioni BigQuery Conserva i messaggi confermati retainAckedMessages Conserva messaggi confermati
Sottoscrizioni BigQuery Durata di conservazione dei messaggi messageRetentionDuration Durata di conservazione dei messaggi
Sottoscrizioni BigQuery Abilita l'ordinamento dei messaggi enableMessageOrdering Ordinamento dei messaggi
Sottoscrizioni BigQuery Policy di scadenza expirationPolicy Periodo di scadenza
Sottoscrizioni BigQuery Filtro filter Filtro di abbonamento
Sottoscrizioni BigQuery Argomento messaggi non recapitabili deadLetterTopic Argomento messaggi non recapitabili
Sottoscrizioni BigQuery Backoff massimo maximumBackoff Policy di ripetizione
Sottoscrizioni BigQuery Backoff minimo minimumBackoff Policy di ripetizione
Sottoscrizioni Cloud Storage Nome name Linee guida per assegnare un nome a un argomento, una sottoscrizione, uno schema o uno snapshot
Sottoscrizioni Cloud Storage Bucket bucket Nome bucket
Sottoscrizioni Cloud Storage Prefisso nome file filenamePrefix Prefisso, suffisso e data e ora del nome file
Sottoscrizioni Cloud Storage Suffisso nome file filenameSuffix Prefisso, suffisso e data e ora del nome file
Sottoscrizioni Cloud Storage Formato data e ora del nome file filenameDatetimeFormat Prefisso, suffisso e data e ora del nome file
Sottoscrizioni Cloud Storage Durata massima maxDuration Batch di file
Sottoscrizioni Cloud Storage Max Bytes maxBytes Batch di file
Sottoscrizioni Cloud Storage Max Messages maxMessages Batch di file
Sottoscrizioni Cloud Storage Formato di output textConfig o avroConfig Formato file
Sottoscrizioni Cloud Storage Scrivi metadati writeMetadata Formato file
Sottoscrizioni Cloud Storage Utilizza schema argomento useTopicSchema Formato file
Sottoscrizioni Cloud Storage Ack Deadline Seconds ackDeadlineSeconds Scadenza conferma
Sottoscrizioni Cloud Storage Conserva i messaggi confermati retainAckedMessages Conserva messaggi confermati
Sottoscrizioni Cloud Storage Durata di conservazione dei messaggi messageRetentionDuration Durata di conservazione dei messaggi
Sottoscrizioni Cloud Storage Abilita l'ordinamento dei messaggi enableMessageOrdering Ordinamento dei messaggi
Sottoscrizioni Cloud Storage Policy di scadenza expirationPolicy Periodo di scadenza
Sottoscrizioni Cloud Storage Filtro filter Filtro di abbonamento
Sottoscrizioni Cloud Storage Argomento messaggi non recapitabili deadLetterTopic Argomento messaggi non recapitabili
Sottoscrizioni Cloud Storage Backoff massimo maximumBackoff Policy di ripetizione
Sottoscrizioni Cloud Storage Backoff minimo minimumBackoff Policy di ripetizione
Etichette di abbonamento Key (Chiave) labels Crea report sull'utilizzo con etichette
Etichette di abbonamento Valore labels Crea report sull'utilizzo con etichette
Durata di conservazione dei messaggi dell'argomento topicMessageRetentionDuration Durata di conservazione dei messaggi
Nome chiave KMS argomento kmsKeyName Utilizza una chiave di crittografia gestita dal cliente (CMEK)
Concedi i ruoli di progetto BigQuery Per impostazione predefinita, i ruoli BigQuery Metadata Viewer (roles/bigquery.metadataViewer) e BigQuery Data Editor (roles/bigquery.dataEditor) vengono concessi al account di servizio Pub/Sub predefinito. Se non vuoi concedere questi ruoli, deseleziona la casella di controllo. Concedi i ruoli IAM al service account
Concedi il ruolo Creatore token Per impostazione predefinita, il ruolo Creatore token account di servizio viene concesso al service account Pub/Sub predefinito. Se non vuoi concedere questo ruolo, deseleziona la casella di controllo. Configura l'autenticazione per Pub/Sub
Schema Nome name Informazioni importanti sugli schemi
Schema Tipo type Tipi di schemi
Schema Definizione definizione Tipi di schemi
Schema Codifica encoding Linee guida per associare uno schema a un argomento