Pub/Sub-Thema und -Abo konfigurieren

Im App Design Center können Sie ein Pub/Sub-Thema und ein Abo konfigurieren, um asynchrones, skalierbares Messaging bereitzustellen, das Dienste, die Nachrichten erzeugen, von Diensten entkoppelt, die diese Nachrichten verarbeiten. Sie können die Komponentenverbindungen und Konfigurationsparameter für Ihr Thema und Ihr Abo basierend auf dem Terraform-Modul terraform-google-pubsub anpassen.

Komponentenverbindungen

Die folgende Tabelle enthält die Komponenten, die Sie mit einem Pub/Sub-Thema oder -Abo verbinden können, sowie die resultierenden Aktualisierungen Ihrer Anwendung und des generierten Terraform-Codes.

Verbundene Komponente

Anwendungsupdates

Hintergrundinformationen:

Compute Engine-Instanzvorlage

  • Die Compute Engine-Instanzen können Nachrichten im Pub/Sub-Thema veröffentlichen und von dort empfangen.
  • Die Pub/Sub-Themen-ID wird den Metadaten der Compute Engine-Instanzvorlage hinzugefügt.
Instanzvorlagen

Dienstkonto

  • Das Dienstkonto kann Pub/Sub-Themen verwalten und Nachrichten aus Abos abrufen.
  • Die Rolle roles/pubsub.editor wird dem Dienstkonto hinzugefügt.
  • Der Name und die E-Mail-Adresse des Dienstkontos werden dem Pub/Sub-Pull-Abo hinzugefügt.
Zugriffssteuerung mit IAM

BigQuery

  • Das Pub/Sub-Abo kann Nachrichten in das BigQuery-Dataset schreiben.
  • Die BigQuery-Dataset-Informationen werden den BigQuery-Abo-Feldern hinzugefügt.
BigQuery-Abos

Cloud Run

  • Der Cloud Run-Dienst kann Nachrichten empfangen oder im Pub/Sub-Thema veröffentlichen.
  • Die Pub/Sub-Themen-ID wird den Cloud Run-Umgebungsvariablen hinzugefügt.
  • Die Rollen roles/pubsub.publisher und roles/pubsub.subscriber werden dem Cloud Run-Dienstkonto hinzugefügt.
  • Der Cloud Run-Dienst wird den Pub/Sub-Push- und Pull-Abofeldern hinzugefügt.
Pub/Sub mit Cloud Run verwenden

Cloud Storage

  • Das Pub/Sub-Abo kann Nachrichten in den Cloud Storage-Bucket schreiben.
  • Die Cloud Storage-Bucket-Informationen werden den Pub/Sub-Abo-Feldern hinzugefügt.
Cloud Storage-Abos

Erforderliche Konfigurationsparameter

Wenn Ihre Vorlage eine Pub/Sub-Komponente enthält, müssen Sie vor der Bereitstellung die folgenden Parameter konfigurieren.

Parametername

Beschreibung und Einschränkungen

Hintergrundinformationen:

Projekt-ID

Das Projekt, in dem Sie die Pub/Sub-Ressource bereitstellen möchten.

Komponenten konfigurieren

Thema

name Richtlinien für die Benennung eines Themas, Abos, Schemas oder Snapshots

Optionale Konfigurationsparameter

Die folgenden Parameter sind optional. Wenn Sie erweiterte Parameter anzeigen möchten, wählen Sie im Bereich Konfiguration die Option Erweiterte Felder anzeigen aus.

Funktion

Parametername

Beschreibung und Informationen zur Einschränkung

Hintergrundinformationen:

Thema erstellen Standardmäßig wird ein Thema erstellt. Entfernen Sie das Häkchen aus dem Kästchen, wenn Sie kein Thema erstellen möchten. Thema erstellen
Abos erstellen Standardmäßig wird ein Abo erstellt. Entfernen Sie das Häkchen aus dem Kästchen, wenn Sie kein Abo erstellen möchten. Aboübersicht

Themenlabels

Schlüssel labels Labels erstellen und verwalten
Wert labels Labels erstellen und verwalten

Push-Abos

Name name Richtlinien für die Benennung eines Themas, Abos, Schemas oder Snapshots
Bestätigungsfrist in Sekunden ackDeadlineSeconds Bestätigungsfrist
Push-Endpunkt pushEndpoint Endpoints
X-goog-version Das Pub/Sub API-Format der Push-Nachricht. Beispiel: v1beta1. attributes
E-Mail-Adresse des OIDC-Dienstkontos serviceAccountEmail Authentifizierung
Zielgruppe audience Authentifizierung
Ablaufrichtlinie expirationPolicy Ablaufzeitraum
Thema für unzustellbare Nachrichten deadLetterTopic Thema für unzustellbare Nachrichten
Bestätigte Nachrichten beibehalten retainAckedMessages Bestätigte Nachrichten speichern
Aufbewahrungsdauer für Nachrichten messageRetentionDuration Aufbewahrungsdauer für Nachrichten
Maximale Anzahl von Übermittlungsversuchen maxDeliveryAttempts Thema für unzustellbare Nachrichten
Maximaler Backoff maximumBackoff Wiederholungsrichtlinie
Mindest-Backoff minimumBackoff Wiederholungsrichtlinie
Filter filter Abofilter
Nachrichtenreihenfolge aktivieren enableMessageOrdering Nachrichtenreihenfolge

Pull-Abos

Name name Richtlinien für die Benennung eines Themas, Abos, Schemas oder Snapshots
Bestätigungsfrist in Sekunden ackDeadlineSeconds Bestätigungsfrist
Thema für unzustellbare Nachrichten deadLetterTopic Thema für unzustellbare Nachrichten
Maximale Anzahl von Übermittlungsversuchen maxDeliveryAttempts Thema für unzustellbare Nachrichten
Bestätigte Nachrichten beibehalten retainAckedMessages Bestätigte Nachrichten speichern
Aufbewahrungsdauer für Nachrichten messageRetentionDuration Aufbewahrungsdauer für Nachrichten
Maximaler Backoff maximumBackoff Wiederholungsrichtlinie
Mindest-Backoff minimumBackoff Wiederholungsrichtlinie
Filter filter Abofilter
Nachrichtenreihenfolge aktivieren enableMessageOrdering Nachrichtenreihenfolge
Dienstkonto
Genau einmalige Zustellung aktivieren enableExactlyOnceDelivery Genau einmalige Zustellung

BigQuery-Abos

Name name Richtlinien für die Benennung eines Themas, Abos, Schemas oder Snapshots
Tabelle table BigQuery-Abos erstellen
Themenschema verwenden useTopicSchema Themenabo verwenden
Schema der Tabelle verwenden useTableSchema Schema der Tabelle verwenden
Metadaten schreiben writeMetadata Metadaten schreiben
Unbekannte Felder löschen dropUnknownFields Unbekannte Felder löschen
Bestätigungsfrist in Sekunden ackDeadlineSeconds Bestätigungsfrist
Bestätigte Nachrichten beibehalten retainAckedMessages Bestätigte Nachrichten speichern
Aufbewahrungsdauer für Nachrichten messageRetentionDuration Aufbewahrungsdauer für Nachrichten
Nachrichtenreihenfolge aktivieren enableMessageOrdering Nachrichtenreihenfolge
Ablaufrichtlinie expirationPolicy Ablaufzeitraum
Filter filter Abofilter
Thema für unzustellbare Nachrichten deadLetterTopic Thema für unzustellbare Nachrichten
Maximaler Backoff maximumBackoff Wiederholungsrichtlinie
Mindest-Backoff minimumBackoff Wiederholungsrichtlinie

Cloud Storage-Abos

Name name Richtlinien für die Benennung eines Themas, Abos, Schemas oder Snapshots
Bucket Bucket Bucket-Name
Präfix für Dateinamen filenamePrefix Präfix, Suffix und Datum/Uhrzeit für Dateinamen
Suffix für Dateinamen filenameSuffix Präfix, Suffix und Datum/Uhrzeit für Dateinamen
Datums-/Uhrzeitformat des Dateinamens filenameDatetimeFormat Präfix, Suffix und Datum/Uhrzeit für Dateinamen
Max. Vorheizzeit maxDuration Batchverarbeitung von Dateien
Max. Byte maxBytes Batchverarbeitung von Dateien
Maximale Anzahl von Nachrichten maxMessages Batchverarbeitung von Dateien
Ausgabeformat textConfig oder avroConfig Dateiformat
Metadaten schreiben writeMetadata Metadaten schreiben
Themenschema verwenden useTopicSchema Themenschema verwenden
Bestätigungsfrist in Sekunden ackDeadlineSeconds Bestätigungsfrist
Bestätigte Nachrichten beibehalten Bestätigte Nachrichten speichern
Aufbewahrungsdauer für Nachrichten messageRetentionDuration Aufbewahrungsdauer für Nachrichten
Nachrichtenreihenfolge aktivieren enableMessageOrdering Nachrichtenreihenfolge
Ablaufrichtlinie expirationPolicy Ablaufzeitraum
Filter filter Abofilter
Thema für unzustellbare Nachrichten deadLetterTopic Thema für unzustellbare Nachrichten
Maximaler Backoff maximumBackoff Wiederholungsrichtlinie
Mindest-Backoff minimumBackoff Wiederholungsrichtlinie

Abolabels

Schlüssel labels Labels erstellen und verwalten
Wert labels Labels erstellen und verwalten
Aufbewahrungsdauer für Themennachrichten topicMessageRetentionDuration Aufbewahrungsdauer für Nachrichten
KMS-Schlüsselname des Themas kmsKeyName Kundenverwalteten Verschlüsselungsschlüssel (CMEK) verwenden
BigQuery-Projektrollen zuweisen Standardmäßig werden dem Pub/Sub-Standarddienstkonto die Rollen BigQuery-Metadatenbetrachter und BigQuery-Datenbearbeiter zugewiesen. Wenn Sie diese Rollen nicht zuweisen möchten, entfernen Sie das Häkchen aus dem Kästchen. BigQuery-Rollen dem Pub/Sub-Dienstkonto zuweisen
Grant Token Creator Standardmäßig wird dem Pub/Sub-Standarddienstkonto die Rolle Ersteller von Dienstkonto-Tokens zugewiesen. Wenn Sie diese Rolle nicht zuweisen möchten, entfernen Sie das Häkchen aus dem Kästchen. Authentifizierung für Pub/Sub einrichten

Schema

Name name Wichtige Informationen zu Schemas
Typ type Schematypen
Definition Definition Schematypen
Encoding encoding Richtlinien zum Verknüpfen eines Schemas mit einem Thema