Zum Inhalt springen

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.

Veröffentlicht
Lesezeit
3 Min.
Autor
Kaeso Team
Ein tiefer Verlauf aus tiefem und hellem Blau, diagonal abfallend gefaltet, mit warmem Licht in einer Ecke

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 (öffnet in einem neuen Tab). 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:

cd deploy/gcp/quick-servertofu inittofu apply -var project=my-project -var domain=kaeso.example.com \  -var 'ssh_source_ranges=["203.0.113.0/24"]'
VariableWas sie ist
project, region, zoneWo die Instanz läuft; standardmäßig europe-west3-a
domainDie Domain, auf der Kaeso antwortet; ohne dns_zone richten Sie ihren A-Eintrag auf die Ausgabe public_ip
kaeso_versionEin Release, das installiert wird; leer installiert das neueste stabile Release
machine_type, disk_size_gbStandardmäßig e2-medium und 40 GB
ssh_source_rangesWer SSH erreichen darf, das kaeso setup-link braucht
dns_zoneEine 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.
cd deploy/gcp/managedtofu inittofu 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

Von Kaeso Team

Auf dieser Seite

Ihr Gateway.Ihre Request-Logs.

curl -fsSLhttps://kaeso.app/install.sh | sh