Zum Inhalt springen

Google-Cloud-Architekturdiagramm: Web-App mit Cloud Run und Cloud SQL

Eine Google-Cloud-Referenzarchitektur für eine Web-App, gezeichnet und erklärt: Load Balancer, Cloud Run, Cloud SQL, Memorystore, Pub/Sub, IAM und Netzwerkentscheidungen.

· Gründer & Entwickler

Veröffentlicht am

Diagramm eines Google-Cloud-Projekts mit der Region us-central1. Nutzer senden HTTPS an einen globalen Load Balancer, der an die Services web und api auf Cloud Run leitet. Die api nutzt Cloud SQL und veröffentlicht in Pub/Sub, das an einen Worker pusht (PDFs nach Cloud Storage).

Ein Security-Reviewer öffnet dein Google-Cloud-Architekturdiagramm und stellt drei Fragen. Kann jemand die Cloud-Run-URL direkt aufrufen und Cloud Armor umgehen? Wie erreicht ein Serverless-Service eine Datenbank, die nur eine private IP hat? Was passiert mit einem Bestell-Event, wenn der Worker fehlschlägt? Ist das Diagramm ein Raster aus Produktsymbolen, steht keine der Antworten darauf.

Ein brauchbares GCP-Architekturdiagramm zeigt, wo die Dinge liegen, wie Requests laufen und welche Einstellungen über Sicherheit und Kapazität entscheiden. Dieser Beitrag geht eine typische Google-Cloud-Web-App durch, vom Load Balancer und Cloud Run bis zu Cloud SQL und Pub/Sub, samt den Entscheidungen hinter jedem Teil.

Beginne mit der Ressourcenhierarchie

Google-Cloud-Ressourcen liegen in einem Baum: eine Organisation, optionale Ordner und Projekte. IAM-Rollen und Organisationsrichtlinien, die auf einem Knoten gesetzt sind, gelten für alles darunter (Ressourcenhierarchie). Ordner lassen sich bis zu 10 Ebenen tief verschachteln und übernehmen die Rolle der Management Groups einer Azure-Landing-Zone oder der OUs einer AWS-Landing-Zone.

Ein gängiges Layout ist ein Ordner pro Umgebung und ein Projekt pro Anwendung und Umgebung, etwa shop-prod unter production. Das Projekt begrenzt Abrechnung, Kontingente und die meisten IAM-Berechtigungen, und der interne Ingress von Cloud Run vertraut Pub/Sub nur aus demselben Projekt oder demselben VPC-Service-Controls-Perimeter.

Das Beispiel, Request für Request

Das Beispiel ist ein Online-Shop im Projekt shop-prod: eine Drei-Schichten-Architektur mit Serverless-Compute in us-central1.

  1. Die Domain zeigt auf die Anycast-IP eines globalen externen Application Load Balancers, der TLS mit einem von Google verwalteten Zertifikat terminiert, eine Cloud-Armor-Richtlinie anwendet und gecachte Antworten aus Cloud CDN ausliefert.
  2. Die URL-Map schickt /api/* an den Service api und alles andere an web, jeweils über eine Serverless Network Endpoint Group (NEG).
  3. web hält Sessions und einen Seiten-Cache in Memorystore for Valkey. api nutzt Cloud SQL for PostgreSQL über eine private IP.
  4. api veröffentlicht Bestell-Events in Pub/Sub, das sie an worker pusht, einen dritten Cloud-Run-Service, der Rechnungs-PDFs in Cloud Storage schreibt.
  5. Zugangsdaten liegen in Secret Manager; Logs und Metriken gehen an Cloud Logging und Cloud Monitoring.

Zum Zeitpunkt des Schreibens (November 2026) nimmt eine Cloud-Run-Instanz standardmäßig 80 gleichzeitige Requests an (80 pro vCPU über gcloud oder Terraform), und eine Revision skaliert auf 100 Instanzen.

Ingress und Service-Accounts

Jeder Cloud-Run-Service erhält eine run.app-URL, und der Ingress steht standardmäßig auf all; jeder mit der URL kann also Load Balancer und Cloud Armor umgehen. Setze den Ingress von web und api auf internal-and-cloud-load-balancing (Ingress-Einstellungen). Requests vom Load Balancer tragen keine Google-Identität, deshalb müssen diese Services zusätzlich öffentlich sein; Google empfiehlt, die Invoker-IAM-Prüfung zu deaktivieren, statt die Invoker-Rolle an allUsers zu vergeben. Der worker nutzt den Ingress internal, der Pub/Sub aus demselben Projekt trotzdem zulässt, und behält sowohl die IAM-Prüfung als auch seine Standard-URL, die der Pub/Sub-Push aufruft.

Standardmäßig führt Cloud Run den Code mit dem Standard-Service-Account von Compute Engine aus, der je nach Organisationsrichtlinie die Rolle Editor im Projekt halten kann. Gib jedem Service einen eigenen:

Service-Account Rollen (Ressource)
web-sa Keine; erreicht Memorystore über das VPC
api-sa Pub/Sub Publisher (Topic orders), Secret Manager Secret Accessor (eigene Secrets)
worker-sa Storage Object Creator (Bucket invoices), Secret Manager Secret Accessor (eigene Secrets)
push-sa Cloud Run Invoker (worker), genutzt von der Push-Subscription

Secrets in Umgebungsvariablen werden beim Start einer Instanz gelesen, also pinne eine Version (unten db-password:3).

Serverless-Netzwerk: Direct VPC egress oder Connector

Cloud Run läuft nicht in deinem VPC. Um die privaten IPs von Cloud SQL oder Memorystore zu erreichen, muss sein ausgehender Traffic in ein Subnetz gelangen. Google empfiehlt Direct VPC egress statt eines Serverless-VPC-Access-Connectors; beide sind allgemein verfügbar.

Direct VPC egress VPC-Access-Connector
Kosten Nur Netzwerk-Egress Egress plus Connector-VMs
Latenz und Durchsatz Geringere Latenz, höherer Durchsatz Höhere Latenz, geringerer Durchsatz
IP-Adressen Etwa zwei pro Instanz Weniger

Das Subnetz muss /26 oder größer sein, Cloud Run verbraucht doppelt so viele Adressen wie Instanzen, und eine herunterskalierende Revision behält ihre Adressen bis zu 20 Minuten. Bei einem Rollout kann api, auf 40 Instanzen begrenzt, (40 + 40) × 2 = 160 Adressen belegen. Beim Standard von 100 braucht ein Service 400, mehr als die 252 nutzbaren eines /24; addiere also alle Services im Subnetz. Neue Instanzen können außerdem eine Minute oder länger warten, bis Egress funktioniert, also ergänze eine Startup-Probe, die eine echte Abhängigkeit testet.

gcloud run deploy api \
  --image=us-central1-docker.pkg.dev/shop-prod/app/api:1.42 \
  --region=us-central1 \
  --service-account=api-sa@shop-prod.iam.gserviceaccount.com \
  --ingress=internal-and-cloud-load-balancing \
  --no-invoker-iam-check \
  --network=shop-vpc --subnet=run-us-central1 \
  --vpc-egress=private-ranges-only \
  --max-instances=40 \
  --set-secrets=DB_PASSWORD=db-password:3

Den Datenspeicher wählen

Die SLAs unten sind monatliche Verfügbarkeit in den meisten Regionen:

Service Wähle ihn, wenn SLA
Cloud SQL Standard-PostgreSQL, -MySQL oder -SQL-Server unter 64 TB Mit HA: 99,95 %, oder 99,99 % bei Enterprise Plus
AlloyDB PostgreSQL mit hoher Last oder Analytics auf Live-Daten 99,99 % mit HA
Spanner Relationale Daten über einen Primary hinaus oder Schreibzugriffe in mehreren Regionen 99,99 % regional, 99,999 % multiregional
Firestore Dokumente für Web- und Mobile-Clients mit Offline-Sync 99,99 % regional, 99,999 % multiregional
Bigtable Terabytes an Daten mit einem Schlüssel bei niedriger Latenz 99,9 % bis 99,999 %, je nach Replikation

Cloud SQL HA hält einen synchron replizierten Standby in einer zweiten Zone, und ein Failover dauert etwa 60 Sekunden (Hochverfügbarkeit). Achte bei Cloud Run auf die Verbindungen: max_connections steht standardmäßig auf 500 bei 15 bis 30 GB Speicher, und jede Cloud-Run-Instanz kann bis zu 100 öffnen. Begrenzt du api auf 40 Instanzen mit einem Pool von 10, kommt sie auf höchstens 400 und lässt Spielraum.

Asynchrone Arbeit: Pub/Sub oder Cloud Tasks

Beim Pub/Sub-Push müssen vier Details stimmen:

  • Der Worker bestätigt, indem er 102, 200, 201, 202 oder 204 zurückgibt.
  • Die Bestätigungsfrist (10 bis 600 Sekunden, Standard 10) muss die Verarbeitungszeit übersteigen, sonst liefert Pub/Sub erneut aus, während der erste Versuch noch läuft.
  • Ein Dead-Letter-Topic übernimmt eine Nachricht standardmäßig nach 5 Zustellversuchen; der Pub/Sub-Service-Agent braucht die Berechtigung, dorthin zu veröffentlichen.
  • Die Zustellung erfolgt mindestens einmal, also mach den Worker idempotent; benenne jede PDF nach ihrer Bestell-ID.

Wähle Cloud Tasks, wenn der Sender die Zustellung steuern soll: geplante Tasks, Ratenlimits von bis zu 500 Dispatches pro Sekunde und Queue sowie Deduplizierung. Pub/Sub passt für Fan-out an mehrere Subscriber. Das Serverless-Architekturdiagramm behandelt weitere Event-Muster.

Regionen und Hochverfügbarkeit

Zonenausfälle sind abgedeckt: Cloud Run verteilt sich über Zonen, Memorystore-Replikate landen in anderen Zonen und der Cloud-SQL-Standby übernimmt. SLAs multiplizieren sich jedoch: 99,95 % für Cloud Run mal 99,95 % für Cloud SQL HA ergibt etwa 99,90 %, also 43 Minuten Ausfall in einem Monat mit 30 Tagen (0,1 % von 43.200 Minuten).

Für einen Regionsausfall stellst du eine zweite Region bereit und fügst ihre Serverless-NEG jedem Backend-Service hinzu. Der Load Balancer schickt Nutzer dann in die nächste Region, und Outlier Detection leitet Traffic von einer ausfallenden weg. Die Daten sind der schwierige Teil: ein Cloud-SQL-Cross-Region-Replikat, das du hochstufst, oder Spanner multiregional. Multi-Region-Failover auf AWS und das Disaster-Recovery-Architekturdiagramm behandeln diese Abwägungen.

Zuordnung von AWS zu Google Cloud

AWS Google Cloud
Organizations, OUs, Accounts Organisation, Ordner, Projekte
ALB, CloudFront, AWS WAF Globaler externer Application Load Balancer, Cloud CDN, Cloud Armor
ECS on Fargate, Lambda Cloud-Run-Services, -Jobs, -Worker-Pools und -Functions
RDS, Aurora Cloud SQL, AlloyDB
ElastiCache Memorystore
SQS, SNS Cloud Tasks, Pub/Sub
CloudWatch Cloud Logging, Cloud Monitoring
VPC (regional) VPC (global, mit regionalen Subnetzen)

Die Zuordnungen sind ungefähr; Googles Service-Vergleich listet mehr. Für die AWS-Seite siehe Subnetze und Routentabellen in einer VPC fürs Netzwerk und ECS on Fargate für Container.

Das Google-Cloud-Web-App-Diagramm

Diagramm eines Google-Cloud-Projekts mit der Region us-central1. Nutzer senden HTTPS an einen globalen Load Balancer, der an die Services web und api auf Cloud Run leitet. Die api nutzt Cloud SQL und veröffentlicht in Pub/Sub, das an einen Worker pusht (PDFs nach Cloud Storage).

19 Komponenten · 8 Verbindungen

In Archboard öffnen
Diagramminhalt
  • Project shop-prod (folder: production)
  • us-central1
  • Users
  • Global external Application LB
  • web frontend
  • api
  • worker
  • Memorystore for Valkey
  • Cloud SQL for PostgreSQL
  • Cloud Storage
  • Pub/Sub topic
  • Secret Manager
  • Cloud Logging and Monitoring
  • HTTPS
  • /*
  • /api/*
  • sessions, page cache
  • SQL over private IP
  • publish
  • push
  • invoice PDFs
Eine Web-App in einem Google-Cloud-Projekt. Ein globaler Application Load Balancer mit Cloud Armor und Cloud CDN leitet an Cloud-Run-Services in us-central1, die Cloud SQL und Memorystore über private IPs erreichen und langsame Arbeit über Pub/Sub an einen Worker übergeben.

So liest du es:

  • Rahmen zeigen den Geltungsbereich. Der äußere Rahmen ist das Projekt shop-prod im Ordner production; der blaue Kasten ist die Region us-central1. Globale Services liegen außerhalb der Region.
  • Blaue Kanten sind der Request-Pfad: HTTPS zum Load Balancer, dann /* zum Web-Frontend und /api/* zur api; die Notiz nennt Cloud Armor, Cloud CDN und das Zertifikat.
  • Grüne Kanten sind Datenzugriff: Memorystore für Sessions, die HA-Cloud-SQL-Instanz über private IP und Cloud Storage für Rechnungs-PDFs.
  • Gestrichelte violette Kanten sind asynchron. Die api veröffentlicht, Pub/Sub pusht an den Worker, und ein Dead-Letter-Topic fängt Nachrichten nach fünf Versuchen auf.
  • Secret Manager und Logging tragen Notizen statt Kanten, und der Markdown-Block listet die wichtigsten Einstellungen.

Google-Cloud-Architekturdiagramme klar zeichnen

  • Verschachtele die Hierarchie: ein Projektrahmen mit seinem Ordner im Label, darin die Region, globale Services außerhalb der Region. Zeichne Cloud Run nicht in ein Subnetz; es sendet Egress dorthin, lebt dort aber nicht.
  • Nenne in jedem Label das Produkt. Ein Kasten namens Datenbank provoziert eine Frage; Cloud SQL for PostgreSQL with HA beantwortet sie.
  • Bring Sicherheitseinstellungen aufs Blatt: Ingress, private IPs und Service-Accounts.
  • Beschrifte Kanten mit Routen und Daten, und strichele die asynchronen.
  • Lass weg: Build-Tooling, Kopien regionaler Services pro Zone und IAM-Bindings; halte Rollen in einer Tabelle.

In Archboard nachbauen

  1. Melde dich mit Google oder GitHub an und lege ein Diagramm an.
  2. Füge aus dem Paket Basis einen Rahmen mit dem Label Project shop-prod (folder: production) hinzu und darin aus dem Paket Cloud eine Cloud-Region mit dem Label us-central1.
  3. Setze für die Nutzer eine Person aus dem Paket C4-Modell links neben den Rahmen. Füge im Rahmen, links der Region, einen Cloud-Lastverteiler aus dem Paket Cloud und eine Basis-Text-Notiz für Cloud Armor, Cloud CDN und das Zertifikat hinzu.
  4. Füge in der Region drei Cloud-Ressource-Nodes aus dem Paket Cloud mit den Namen web frontend, api und worker hinzu und setze ihren Ressourcentyp auf Cloud Run service.
  5. Füge daneben einen Redis-Node aus dem Paket Daten für Memorystore hinzu, dann Verwaltete Datenbank und Objektspeicher aus dem Paket Cloud für Cloud SQL und Cloud Storage.
  6. Füge außerhalb der Region ein Thema aus dem Paket Daten für Pub/Sub, einen Tresor aus dem Paket Sicherheit für Secret Manager und einen Protokolle-Node aus dem Paket DevOps hinzu, dazu Basis-Text-Notizen.
  7. Zeichne beschriftete Kanten: HTTPS, /, /api/, sessions and page cache, SQL over private IP und invoice PDFs. Mache publish und push gestrichelt.
  8. Füge einen Markdown-Block aus dem Paket Basis mit den wichtigsten Einstellungen hinzu.

Archboard importiert nicht aus einem Live-Google-Cloud-Konto; liegt das Projekt in Terraform, liefert dir das kostenlose Tool Terraform to diagram einen bearbeitbaren ersten Entwurf. Die Cloud-Node-Typen findest du unter Cloud-Architekturdiagramme. Das Beispiel nutzt 14 Diagramm-Nodes und bleibt damit im Free-Plan.

FAQ

Was sollte ein Google-Cloud-Architekturdiagramm zeigen? Das Projekt und den Ordner, die Region, jede Komponente auf dem Request-Pfad und die Einstellungen, die über Sicherheit entscheiden: Ingress, private IPs und Service-Accounts. Globale Services wie Pub/Sub gehören außerhalb des Regionskastens.

Läuft Cloud Run in einem VPC? Nein. Es läuft auf von Google verwalteter Infrastruktur; Direct VPC egress oder ein Connector leitet den ausgehenden Traffic in dein Subnetz, damit es private IPs erreicht.

Soll ich Direct VPC egress oder einen Serverless-VPC-Access-Connector nutzen? Für die meisten Services Direct VPC egress: Google empfiehlt es, die Latenz ist geringer und du zahlst nur für Egress. Ein Connector braucht weniger IP-Adressen und bietet schnellere Cold Starts hinter Cloud NAT.

Wie verhindere ich, dass Nutzer Cloud Armor umgehen? Setze den Cloud-Run-Ingress auf internal-and-cloud-load-balancing, damit Internet-Traffic den externen Application Load Balancer passieren muss, und deaktiviere die Standard-URL run.app, wo kein Google-Service sie braucht.

Wie viele Verbindungen kann Cloud Run zu Cloud SQL öffnen? Bis zu 100 pro Instanz. Halte maximale Instanzen mal Pool-Größe unter max_connections (standardmäßig 500 bei 15 bis 30 GB Speicher), oder nutze Managed Connection Pooling bei Enterprise Plus.

Kostenlos starten — ein Seat, keine Kreditkarte.

Ähnliche Beiträge

← Zurück zum Blog

In einer Minute ein Canvas öffnen

Melden Sie sich mit Google oder GitHub an. Kostenlos für einen Sitzplatz. Upgraden Sie, wenn das Team dazukommt.