Pub/Sub-Thema und -Abo konfigurieren

Im Application 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 auf GitHub 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.
  • Dem Dienstkonto wird die Rolle roles/pubsub.editor zugewiesen.
  • Der Name und die E-Mail-Adresse des Dienstkontos werden dem Pub/Sub-Pull-Abo hinzugefügt.
Zugriffssteuerung mit Identity and Access Management (IAM)

BigQuery

  • Das Pub/Sub-Abo kann Nachrichten in eine Tabelle im BigQuery-Dataset schreiben.
  • Die BigQuery-Dataset- und -Tabelleninformationen werden den Pub/Sub-Abofeldern 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.
  • Dem Cloud Run-Dienstkonto werden die Rollen roles/pubsub.publisher und roles/pubsub.subscriber zugewiesen.
  • 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
Themenlabels Wert labels Labels erstellen und verwalten
Push-Abos Name name Richtlinien für die Benennung eines Themas, Abos, Schemas oder Snapshots
Push-Abos Bestätigungsfrist in Sekunden ackDeadlineSeconds Bestätigungsfrist
Push-Abos Push-Endpunkt pushEndpoint Endpoints
Push-Abos X-goog-version Das Pub/Sub API-Format der Push-Nachricht. Beispiel: v1beta1. attributes
Push-Abos E-Mail-Adresse des OIDC-Dienstkontos serviceAccountEmail Authentifizierung
Push-Abos Zielgruppe Zielgruppe Authentifizierung
Push-Abos Ablaufrichtlinie expirationPolicy Ablaufzeitraum
Push-Abos Thema für unzustellbare Nachrichten deadLetterTopic Thema für unzustellbare Nachrichten
Push-Abos Bestätigte Nachrichten beibehalten retainAckedMessages Bestätigte Nachrichten speichern
Push-Abos Aufbewahrungsdauer für Nachrichten messageRetentionDuration Aufbewahrungsdauer für Nachrichten
Push-Abos Maximale Anzahl von Übermittlungsversuchen maxDeliveryAttempts Thema für unzustellbare Nachrichten
Push-Abos Maximaler Backoff maximumBackoff Wiederholungsrichtlinie
Push-Abos Mindest-Backoff minimumBackoff Wiederholungsrichtlinie
Push-Abos Filter filter Abofilter
Push-Abos Nachrichtenreihenfolge aktivieren enableMessageOrdering Nachrichtenreihenfolge
Pull-Abos Name name Richtlinien für die Benennung eines Themas, Abos, Schemas oder Snapshots
Pull-Abos Bestätigungsfrist in Sekunden ackDeadlineSeconds Bestätigungsfrist
Pull-Abos Thema für unzustellbare Nachrichten deadLetterTopic Thema für unzustellbare Nachrichten
Pull-Abos Maximale Anzahl von Übermittlungsversuchen maxDeliveryAttempts Thema für unzustellbare Nachrichten
Pull-Abos Bestätigte Nachrichten beibehalten retainAckedMessages Bestätigte Nachrichten speichern
Pull-Abos Aufbewahrungsdauer für Nachrichten messageRetentionDuration Aufbewahrungsdauer für Nachrichten
Pull-Abos Maximaler Backoff maximumBackoff Wiederholungsrichtlinie
Pull-Abos Mindest-Backoff minimumBackoff Wiederholungsrichtlinie
Pull-Abos Filter filter Abofilter
Pull-Abos Nachrichtenreihenfolge aktivieren enableMessageOrdering Nachrichtenreihenfolge
Pull-Abos Dienstkonto Das Dienstkonto, dem die Rolle roles/pubsub.subscriber für das Abo zugewiesen wird. Zugriffssteuerung mit IAM
Pull-Abos Genau einmalige Zustellung aktivieren enableExactlyOnceDelivery Genau einmalige Zustellung
BigQuery-Abos Name name Richtlinien für die Benennung eines Themas, Abos, Schemas oder Snapshots
BigQuery-Abos Tabelle table BigQuery-Abos erstellen
BigQuery-Abos Schema des Themas verwenden useTopicSchema Themenschema verwenden
BigQuery-Abos Schema der Tabelle verwenden useTableSchema Schema der Tabelle verwenden
BigQuery-Abos Metadaten schreiben writeMetadata Metadaten schreiben
BigQuery-Abos Unbekannte Felder löschen dropUnknownFields Unbekannte Felder löschen
BigQuery-Abos Bestätigungsfrist in Sekunden ackDeadlineSeconds Bestätigungsfrist
BigQuery-Abos Bestätigte Nachrichten beibehalten retainAckedMessages Bestätigte Nachrichten speichern
BigQuery-Abos Aufbewahrungsdauer für Nachrichten messageRetentionDuration Aufbewahrungsdauer für Nachrichten
BigQuery-Abos Nachrichtenreihenfolge aktivieren enableMessageOrdering Nachrichtenreihenfolge
BigQuery-Abos Ablaufrichtlinie expirationPolicy Ablaufzeitraum
BigQuery-Abos Filter filter Abofilter
BigQuery-Abos Thema für unzustellbare Nachrichten deadLetterTopic Thema für unzustellbare Nachrichten
BigQuery-Abos Maximaler Backoff maximumBackoff Wiederholungsrichtlinie
BigQuery-Abos Mindest-Backoff minimumBackoff Wiederholungsrichtlinie
Cloud Storage-Abos Name name Richtlinien für die Benennung eines Themas, Abos, Schemas oder Snapshots
Cloud Storage-Abos Bucket Bucket Bucket-Name
Cloud Storage-Abos Präfix für Dateinamen filenamePrefix Präfix, Suffix und Datum/Uhrzeit für Dateinamen
Cloud Storage-Abos Suffix für Dateinamen filenameSuffix Präfix, Suffix und Datum/Uhrzeit für Dateinamen
Cloud Storage-Abos Datums-/Zeitformat des Dateinamens filenameDatetimeFormat Präfix, Suffix und Datum/Uhrzeit für Dateinamen
Cloud Storage-Abos Max. Vorheizzeit maxDuration Batchverarbeitung von Dateien
Cloud Storage-Abos Max. Byte maxBytes Batchverarbeitung von Dateien
Cloud Storage-Abos Maximale Anzahl von Nachrichten maxMessages Batchverarbeitung von Dateien
Cloud Storage-Abos Ausgabeformat textConfig oder avroConfig Dateiformat
Cloud Storage-Abos Metadaten schreiben writeMetadata Dateiformat
Cloud Storage-Abos Schema des Themas verwenden useTopicSchema Dateiformat
Cloud Storage-Abos Bestätigungsfrist in Sekunden ackDeadlineSeconds Bestätigungsfrist
Cloud Storage-Abos Bestätigte Nachrichten beibehalten retainAckedMessages Bestätigte Nachrichten speichern
Cloud Storage-Abos Aufbewahrungsdauer für Nachrichten messageRetentionDuration Aufbewahrungsdauer für Nachrichten
Cloud Storage-Abos Nachrichtenreihenfolge aktivieren enableMessageOrdering Nachrichtenreihenfolge
Cloud Storage-Abos Ablaufrichtlinie expirationPolicy Ablaufzeitraum
Cloud Storage-Abos Filter filter Abofilter
Cloud Storage-Abos Thema für unzustellbare Nachrichten deadLetterTopic Thema für unzustellbare Nachrichten
Cloud Storage-Abos Maximaler Backoff maximumBackoff Wiederholungsrichtlinie
Cloud Storage-Abos Mindest-Backoff minimumBackoff Wiederholungsrichtlinie
Abolabels Schlüssel labels Labels erstellen und verwalten
Abolabels 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-Metadaten-Betrachter (roles/bigquery.metadataViewer) und BigQuery-Dateneditor (roles/bigquery.dataEditor) zugewiesen. Wenn Sie diese Rollen nicht zuweisen möchten, entfernen Sie das Häkchen aus dem Kästchen. IAM-Rollen dem 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
Schema Typ type Schematypen
Schema Definition Definition Schematypen
Schema Encoding encoding Richtlinien zum Verknüpfen eines Schemas mit einem Thema