---
title: Kaeso auf Google Cloud ausrollen
description: "Zwei Terraform-Konfigurationen betreiben Kaeso auf Google Cloud. Der schnelle Server legt das Compose-Paket aus Cloud Shell auf eine Compute-Engine-Instanz; die verwaltete Konfiguration betreibt es auf Cloud Run mit Load Balancer, Cloud SQL und Memorystore."
url: https://kaeso.app/de/articles/deploy-kaeso-on-google-cloud
markdown: https://kaeso.app/de/articles/deploy-kaeso-on-google-cloud.md
language: de
alternates:
  en: https://kaeso.app/articles/deploy-kaeso-on-google-cloud.md
  zh-CN: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-google-cloud.md
published: 2026-11-11
authors:
  - Kaeso Team
tags:
  - Selbst hosten
  - google-cloud
  - Bereitstellung
  - Anleitung
image: https://kaeso.app/articles/deploy-kaeso-on-google-cloud/cover.jpg
index: https://kaeso.app/de/llms.txt
---

# Kaeso auf Google Cloud ausrollen

Zwei Terraform-Konfigurationen betreiben Kaeso auf Google Cloud. Der schnelle Server legt das Compose-Paket aus Cloud Shell auf eine Compute-Engine-Instanz; die verwaltete Konfiguration betreibt es auf Cloud Run mit Load Balancer, Cloud SQL und Memorystore.

> Jede Seite, jeder Artikel und jede Seite der Doku von Kaeso steht in https://kaeso.app/de/llms.txt.

- Veröffentlicht: 11. November 2026
- Lesezeit: 3 Min.
- Autor: Kaeso Team

`deploy/gcp/` im Kaeso-Repository enthält zwei Terraform-Konfigurationen, die auch OpenTofu anwendet. Der **schnelle Server** ist das Compose-Paket auf einer virtuellen Maschine, wie auf Ihrem eigenen Server. Die **verwaltete Konfiguration** betreibt Kaeso auf Cloud Run mit den Datenspeichern von Google, für Installationen, denen eine Maschine nicht mehr reicht.

## Der schnelle Server

`deploy/gcp/quick-server/` legt eine Compute-Engine-Instanz mit Ubuntu 24.04 an, eine statische Adresse, Firewall-Regeln für HTTP, HTTPS und HTTP/3, SSH aus den Adressbereichen, die Sie wählen, und einen optionalen Cloud-DNS-Eintrag. Beim ersten Start führt die Instanz das Installationsskript von Kaeso aus, das Docker installiert, die Einstellungen schreibt und das Compose-Paket mit Caddy, einem gebündelten ClickHouse und dem Updater startet.

Am schnellsten geht es mit [Open in Cloud Shell](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://github.com/logicplanes/kaeso&cloudshell_git_branch=prod&cloudshell_workspace=deploy/gcp/quick-server). Es klont den Branch `prod`, der das neueste Release enthält, mit diesem Ordner geöffnet. Cloud Shell hat `terraform` statt `tofu`, also nutzen Sie diesen Namen:

```bash
cd deploy/gcp/quick-server
tofu init
tofu apply -var project=my-project -var domain=kaeso.example.com \
  -var 'ssh_source_ranges=["203.0.113.0/24"]'
```

| Variable | Was sie ist |
| --- | --- |
| `project`, `region`, `zone` | Wo die Instanz läuft; standardmäßig `europe-west3-a` |
| `domain` | Die Domain, auf der Kaeso antwortet; ohne `dns_zone` richten Sie ihren A-Eintrag auf die Ausgabe `public_ip` |
| `kaeso_version` | Ein Release, das installiert wird; leer installiert das neueste stabile Release |
| `machine_type`, `disk_size_gb` | Standardmäßig `e2-medium` und 40 GB |
| `ssh_source_ranges` | Wer SSH erreichen darf, das `kaeso setup-link` braucht |
| `dns_zone` | Eine verwaltete Cloud-DNS-Zone der Domain, um ihren Eintrag anzulegen |

Sobald die Instanz läuft und das Zertifikat ausgestellt ist, führen Sie die Ausgabe `setup_link` aus, um den einmaligen Link auszugeben, der den ersten Benutzer anlegt. **Update** in der Konsole funktioniert von da an, wie auf jeder Compose-Installation.

## Die verwaltete Konfiguration

`deploy/gcp/managed/` baut Kaeso aus Diensten von Google Cloud:

- eine VPC mit einem Subnetz, einem Serverless-VPC-Connector und Private Services Access;
- Cloud SQL for PostgreSQL 17 nur mit privater Adresse, und Memorystore for Valkey mit `noeviction`, nur über die VPC erreichbar;
- Secret-Manager-Secrets für die Hauptschlüssel, die PostgreSQL-URL, das SMTP-Passwort und die ClickHouse-URL, gelesen vom Dienstkonto des Gateways;
- Cloud-Run-Dienste für das Gateway, standardmäßig mit 2 CPUs und 4 GB, mindestens einer warm gehaltenen Instanz und einem Anfrage-Timeout von einer Stunde, und für die Konsole, beide nur über den Load Balancer erreichbar;
- einen globalen externen Application Load Balancer mit verwaltetem Zertifikat, HTTP auf HTTPS umgeleitet, Pfadregeln für Gateway und Konsole und einem Backend-Timeout von einer Stunde für lange Streams;
- einen optionalen Cloud-DNS-Eintrag.

```bash
cd deploy/gcp/managed
tofu init
tofu apply -var project=my-project -var domain=kaeso.example.com \
  -var "master_keys=$(docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate)" \
  -var setup_email=owner@example.com -var smtp_host=smtp.example.com \
  -var smtp_user=kaeso -var smtp_password=secret \
  -var 'smtp_from=Kaeso <kaeso@example.com>'
```

Bewahren Sie eine Kopie des Hauptschlüssels in einem Passwort-Manager auf: Kaeso verschlüsselt Anbieter-Schlüssel damit. `gateway_cpu`, `gateway_memory`, `gateway_min_instances` und `gateway_max_instances` bestimmen die Größe des Gateways, und mehrere Instanzen teilen Limits, Caches und die Wartezeiten der Routen über Valkey. `database_tier`, `database_disk_gb` und `cache_node_type` bestimmen die Größe der Datenspeicher. Für Anfrageprotokolle setzen Sie `clickhouse_url` auf ein ClickHouse wie ClickHouse Cloud.

Das verwaltete Zertifikat wird ausgestellt, sobald die Domain auf die Adresse des Load Balancers zeigt, was bis zu einer Stunde dauern kann. Dann sendet das Gateway den einmaligen Einrichtungslink an `setup_email`.

Memorystore wird ohne Passwort und ohne TLS erreicht, nur über das private Netz, weil das Gateway weder IAM-Tokens von Google noch dessen private Zertifizierungsstelle vorweisen kann. Das Gateway vertraut `X-Forwarded-For` nur aus den Proxy-Bereichen des Load Balancers und dem eigenen Frontend von Cloud Run.

## Aktualisieren und zurückrollen

Auf dem schnellen Server aktualisieren Sie aus der Konsole, automatisch oder von Hand. Bei der verwalteten Konfiguration ändert ein Release die Image-Tags in `main.tf`: Wenden Sie die neue Konfiguration an, und Cloud Run legt neue Revisionen an und verlagert den Verkehr, sobald sie gesund sind. Das Gateway migriert die Datenbanken beim Start, nur vorwärts. Um absichtlich zurückzurollen, wenden Sie die Konfiguration des vorherigen Releases an, oder verlagern Sie den Verkehr in Cloud Run auf die vorherige Revision.

## Was getestet wurde

Am 7. November 2026 wurde der schnelle Server in einem neuen Projekt in `europe-west3` ausgerollt, mit dem achten Release-Kandidaten. Er legte den ersten Benutzer an, lieferte Konsole und APIs auf einem HTTPS-Ursprung aus, streamte fünf Ereignisse, deren Text genau `Kaeso stream works.` war, schrieb die Anfrage nach ClickHouse und ignorierte eine gefälschte `X-Forwarded-For`-Adresse. Die verwaltete Konfiguration wird in CI gelintet und formatiert und wurde noch nicht ausgerollt.

## Nächste Schritte

- [Google Cloud in den Docs](https://docs.kaeso.app/de/self-hosting/platforms/gcp), mit jeder Variable.
- [Mehrere Gateways](https://docs.kaeso.app/de/self-hosting/scaling): was ein, zwei und drei Gateways bedienen.
- [Wo Sie Kaeso betreiben](https://kaeso.app/de/articles/where-to-run-kaeso): wie sich Google Cloud mit den anderen Plattformen vergleicht.

Von Kaeso Team

## Weitere Artikel

- [Kaeso auf Azure ausrollen](https://kaeso.app/de/articles/deploy-kaeso-on-azure.md): Betreiben Sie Kaeso auf einer virtuellen Maschine in Azure, mit dem Button Deploy to Azure oder der Azure CLI. Das Installationsskript läuft beim ersten Start, und der Einrichtungslink kommt über Cloud Shell, ohne SSH.
- [Kaeso auf Coolify ausrollen](https://kaeso.app/de/articles/deploy-kaeso-on-coolify.md): Betreiben Sie Kaeso auf Ihrem eigenen Coolify-Server aus einer Compose-Datei. Coolify erzeugt jedes Passwort und den Hauptschlüssel, sein Proxy übernimmt TLS, und PostgreSQL, ClickHouse und Valkey laufen neben Kaeso.

[Alle Artikel ansehen](https://kaeso.app/de/articles.md)

## Ihr Gateway. Ihre Request-Logs

```bash
curl -fsSL https://kaeso.app/install.sh | sh
```

[Kaeso installieren](https://docs.kaeso.app/de/self-hosting/installation) · [Live-Demo öffnen](https://demo.kaeso.app)
