Configurare Pub/Sub in App Design Center

Pub/Sub è un servizio di messaggistica asincrono e scalabile che disaccoppia i servizi che producono messaggi dai servizi che li elaborano. Per maggiori informazioni, consulta Che cos'è Pub/Sub?

Questo documento descrive le connessioni e i parametri che puoi configurare quando utilizzi App Design Center per creare un argomento e una sottoscrizione Pub/Sub. I parametri di configurazione si basano sul modulo Terraform terraform-google-pubsub.

Connessioni dei componenti

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

Componente connesso

Aggiornamenti delle applicazioni

Informazioni introduttive

Modello di istanza Compute Engine

  • Le istanze Compute Engine possono pubblicare e ricevere messaggi dall'argomento Pub/Sub.
  • L'ID argomento Pub/Sub viene aggiunto ai metadati del modello 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 aggiunto all'account di servizio.
  • Il nome account di servizio e le informazioni email vengono aggiunti alla sottoscrizione pull Pub/Sub.
Controllo dell'accesso con IAM

BigQuery

  • La sottoscrizione Pub/Sub può scrivere messaggi nel set di dati BigQuery.
  • Le informazioni sul set di dati BigQuery vengono aggiunte ai campi dell'abbonamento BigQuery.
Abbonamenti 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 Cloud Run.
  • I ruoli roles/pubsub.publisher e roles/pubsub.subscriber vengono aggiunti all'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 dell'abbonamento Pub/Sub.
Abbonamenti 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.

Configurare i componenti

Argomento

name Linee guida per denominare un argomento, una sottoscrizione, uno schema o uno snapshot

Parametri di configurazione facoltativi

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

Funzionalità

Nome parametro

Informazioni su descrizione e 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
Creare abbonamenti Per impostazione predefinita, viene creata una sottoscrizione. Deseleziona la casella di controllo se non vuoi creare un abbonamento. Panoramica degli abbonamenti

Etichette degli argomenti

Key (Chiave) labels Creazione di report sull'utilizzo con etichette
Valore labels Creazione di report sull'utilizzo con etichette

Sottoscrizioni push

Nome name Linee guida per denominare un argomento, una sottoscrizione, uno schema o uno snapshot
Ack Deadline Seconds ackDeadlineSeconds Acknowledgment deadline
Endpoint push pushEndpoint Endpoint
X-goog-version Il formato API Pub/Sub del messaggio push. Ad esempio, v1beta1. attributi
Email dell'account di servizio OIDC serviceAccountEmail Autenticazione
Pubblico segmento di pubblico Autenticazione
Norme sulla scadenza expirationPolicy Periodo di scadenza
Argomento messaggi non recapitabili deadLetterTopic Argomento messaggi non recapitabili
Retain Acked Messages retainAckedMessages Conservare i messaggi confermati
Durata di conservazione dei messaggi messageRetentionDuration Durata di conservazione dei messaggi
Tentativi di consegna massimi maxDeliveryAttempts Argomento messaggi non recapitabili
Backoff massimo maximumBackoff Policy di ripetizione
Backoff minimo minimumBackoff Policy di ripetizione
Filtro filtro Filtro sottoscrizioni
Attivare l'ordinamento dei messaggi enableMessageOrdering Ordinamento messaggi

Sottoscrizioni pull

Nome name Linee guida per denominare un argomento, una sottoscrizione, uno schema o uno snapshot
Ack Deadline Seconds ackDeadlineSeconds Acknowledgment deadline
Argomento messaggi non recapitabili deadLetterTopic Argomento messaggi non recapitabili
Tentativi di consegna massimi maxDeliveryAttempts Argomento messaggi non recapitabili
Retain Acked Messages retainAckedMessages Conservare i messaggi confermati
Durata di conservazione dei messaggi messageRetentionDuration Durata di conservazione dei messaggi
Backoff massimo maximumBackoff Policy di ripetizione
Backoff minimo minimumBackoff Policy di ripetizione
Filtro filtro Filtro sottoscrizioni
Attivare l'ordinamento dei messaggi enableMessageOrdering Ordinamento messaggi
Account di servizio
Abilitare la consegna "exactly-once" enableExactlyOnceDelivery Consegna "exactly-once"

Abbonamenti BigQuery

Nome name Linee guida per denominare un argomento, una sottoscrizione, uno schema o uno snapshot
Tabella table Crea abbonamenti BigQuery
Utilizza schema argomento useTopicSchema Utilizzare la sottoscrizione per un argomento
Utilizzare schema tabella useTableSchema Utilizzare lo schema della tabella
Scrivi metadati writeMetadata Scrivi metadati
Rilascia campi sconosciuti dropUnknownFields Rilascia campi sconosciuti
Ack Deadline Seconds ackDeadlineSeconds Acknowledgment deadline
Retain Acked Messages retainAckedMessages Conservare i messaggi confermati
Durata di conservazione dei messaggi messageRetentionDuration Durata di conservazione dei messaggi
Attivare l'ordinamento dei messaggi enableMessageOrdering Ordinamento messaggi
Norme sulla scadenza expirationPolicy Periodo di scadenza
Filtro filtro Filtro sottoscrizioni
Argomento messaggi non recapitabili deadLetterTopic Argomento messaggi non recapitabili
Backoff massimo maximumBackoff Policy di ripetizione
Backoff minimo minimumBackoff Policy di ripetizione

Abbonamenti Cloud Storage

Nome name Linee guida per denominare un argomento, una sottoscrizione, uno schema o uno snapshot
Bucket bucket Nome bucket
Prefisso nome file filenamePrefix Prefisso, suffisso e data/ora del nome file
Suffisso nome file filenameSuffix Prefisso, suffisso e data/ora del nome file
Formato data/ora del nome file filenameDatetimeFormat Prefisso, suffisso e data/ora del nome file
Durata massima maxDuration Batch di file
Max Bytes maxBytes Batch di file
Max Messages maxMessages Batch di file
Formato di output textConfig o avroConfig Formato file
Scrivi metadati writeMetadata Scrivi metadati
Utilizza schema argomento useTopicSchema Utilizzare schema argomento
Ack Deadline Seconds ackDeadlineSeconds Acknowledgment deadline
Retain Acked Messages Conservare i messaggi confermati
Durata di conservazione dei messaggi messageRetentionDuration Durata di conservazione dei messaggi
Attivare l'ordinamento dei messaggi enableMessageOrdering Ordinamento messaggi
Norme sulla scadenza expirationPolicy Periodo di scadenza
Filtro filtro Filtro sottoscrizioni
Argomento messaggi non recapitabili deadLetterTopic Argomento messaggi non recapitabili
Backoff massimo maximumBackoff Policy di ripetizione
Backoff minimo minimumBackoff Policy di ripetizione

Etichette degli abbonamenti

Key (Chiave) labels Creazione di report sull'utilizzo con etichette
Valore labels Creazione di report sull'utilizzo con etichette
Durata di conservazione dei messaggi dell'argomento topicMessageRetentionDuration Durata di conservazione dei messaggi
Nome della chiave KMS dell'argomento kmsKeyName Utilizzare una chiave di crittografia gestita dal cliente (CMEK)
Concedere ruoli di progetto BigQuery Per impostazione predefinita, i ruoli Visualizzatore metadati BigQuery e BigQuery Data Editor vengono concessi all'account di servizio Pub/Sub predefinito. Se non vuoi concedere questi ruoli, deseleziona la casella di controllo. Assegna ruoli BigQuery al service account Pub/Sub
Concedi Creatore token Per impostazione predefinita, il ruolo Creatore token account di servizio viene concesso all'account di servizio 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
Tipo type Tipi di schemi
Definizione definizione Tipi di schemi
Codifica codifica Linee guida per associare uno schema a un argomento