Pub/Sub in Application Design Center konfigurieren

Pub/Sub ist ein asynchroner, skalierbarer Messaging-Dienst, der Dienste, die Nachrichten erzeugen, von Diensten entkoppelt, die diese Nachrichten verarbeiten. Weitere Informationen finden Sie unter Was ist Pub/Sub?

In diesem Dokument werden die Verbindungen und Parameter beschrieben, die Sie konfigurieren können, wenn Sie mit dem App Design Center ein Pub/Sub-Thema und ein Abo erstellen. Die Konfigurationsparameter basieren auf dem Terraform-Modul terraform-google-pubsub.

Komponentenverbindungen

Die folgende Tabelle enthält die Komponenten, die Sie mit einem Pub/Sub-Thema oder ‑Abo verbinden können, sowie die daraus 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 daraus 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 des Dienstkontos und die E-Mail-Informationen werden dem Pub/Sub-Pull-Abo hinzugefügt.
Zugriffssteuerung mit IAM

BigQuery

  • Über das Pub/Sub-Abo können Nachrichten in das BigQuery-Dataset geschrieben werden.
  • 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 Feldern für Pub/Sub-Push- und Pull-Abos hinzugefügt.
Pub/Sub mit Cloud Run verwenden

Cloud Storage

  • Das Pub/Sub-Abo kann Nachrichten in den Cloud Storage-Bucket schreiben.
  • Die Informationen zum Cloud Storage-Bucket 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 die folgenden Parameter konfigurieren, bevor Sie sie bereitstellen.

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 aufrufen möchten, wählen Sie im Bereich Konfiguration die Option Erweiterte Felder anzeigen aus.

Funktion

Parametername

Beschreibung und Informationen zu Einschränkungen

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. Attribute
E-Mail-Adresse des OIDC-Dienstkontos serviceAccountEmail Authentifizierung
Zielgruppe Zielgruppe 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 von Nachrichten messageRetentionDuration Aufbewahrungsdauer für Nachrichten
Maximale Anzahl der Zustellversuche maxDeliveryAttempts Thema für unzustellbare Nachrichten
Maximum Backoff maximumBackoff Wiederholungsrichtlinie
Mindest-Backoff minimumBackoff Wiederholungsrichtlinie
Filter filter Abo-Filter
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 der Zustellversuche maxDeliveryAttempts Thema für unzustellbare Nachrichten
Bestätigte Nachrichten beibehalten retainAckedMessages Bestätigte Nachrichten speichern
Aufbewahrungsdauer von Nachrichten messageRetentionDuration Aufbewahrungsdauer für Nachrichten
Maximum Backoff maximumBackoff Wiederholungsrichtlinie
Mindest-Backoff minimumBackoff Wiederholungsrichtlinie
Filter filter Abo-Filter
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 Tabelle BigQuery-Abos erstellen
Schema des Themas 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 von Nachrichten messageRetentionDuration Aufbewahrungsdauer für Nachrichten
Nachrichtenreihenfolge aktivieren enableMessageOrdering Nachrichtenreihenfolge
Ablaufrichtlinie expirationPolicy Ablaufzeitraum
Filter filter Abo-Filter
Thema für unzustellbare Nachrichten deadLetterTopic Thema für unzustellbare Nachrichten
Maximum 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-/Zeitformat für Dateinamen filenameDatetimeFormat Präfix, Suffix und Datum/Uhrzeit für Dateinamen
Höchstdauer maxDuration Batchverarbeitung von Dateien
Max. Bytes maxBytes Batchverarbeitung von Dateien
Maximale Anzahl an Nachrichten maxMessages Batchverarbeitung von Dateien
Ausgabeformat textConfig oder avroConfig Dateiformat
Metadaten schreiben writeMetadata Metadaten schreiben
Schema des Themas verwenden useTopicSchema Schema des Themas verwenden
Bestätigungsfrist in Sekunden ackDeadlineSeconds Bestätigungsfrist
Bestätigte Nachrichten beibehalten Bestätigte Nachrichten speichern
Aufbewahrungsdauer von Nachrichten messageRetentionDuration Aufbewahrungsdauer für Nachrichten
Nachrichtenreihenfolge aktivieren enableMessageOrdering Nachrichtenreihenfolge
Ablaufrichtlinie expirationPolicy Ablaufzeitraum
Filter filter Abo-Filter
Thema für unzustellbare Nachrichten deadLetterTopic Thema für unzustellbare Nachrichten
Maximum Backoff maximumBackoff Wiederholungsrichtlinie
Mindest-Backoff minimumBackoff Wiederholungsrichtlinie

Abo-Labels

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

Schema

Name name Wichtige Informationen zu Schemas
Typ type Arten von Schemas
Definition Definition Arten von Schemas
Encoding Codierung Richtlinien zum Verknüpfen eines Schemas mit einem Thema