Kaeso auf Fly.io ausrollen
Betreiben Sie Kaeso auf Fly.io als vier Apps im privaten Netz, einen Edge, ein Gateway, eine Konsole und Valkey, mit Fly Managed Postgres. Jeder Befehl, vom Anlegen der Apps bis zu Ihrem eigenen Zertifikat.
- Veröffentlicht
- Lesezeit
- 3 Min.
- Autor
- Kaeso Team

Fly.io betreibt eine App pro fly.toml, und Kaeso braucht vier. deploy/fly/ im Repository enthält eine Fly-Launch-Konfiguration für jede, festgelegt auf ein Release, und Fly Managed Postgres hält die Datenbank. Fly hat keinen Deploy-Button für ein Projekt aus mehreren Apps, also besteht diese Anleitung aus einer Handvoll fly-Befehlen.
Was Sie bekommen01
…-edge- Datei
edge.toml- Image
- Das Konsolen-Image, das
kaeso-edgeausführt - Maschine
shared-cpu-1x, 256 MB
…-gateway- Datei
gateway.toml- Image
- Das Gateway-Image
- Maschine
shared-cpu-2x, 2 GB
…-console- Datei
console.toml- Image
- Das Konsolen-Image
- Maschine
shared-cpu-1x, 256 MB
…-valkey- Datei
valkey.toml- Image
- Valkey, auf einem Volume von 1 GB
- Maschine
shared-cpu-1x, 512 MB
| App | Datei | Image | Maschine |
|---|---|---|---|
…-edge | edge.toml | Das Konsolen-Image, das kaeso-edge ausführt | shared-cpu-1x, 256 MB |
…-gateway | gateway.toml | Das Gateway-Image | shared-cpu-2x, 2 GB |
…-console | console.toml | Das Konsolen-Image | shared-cpu-1x, 256 MB |
…-valkey | valkey.toml | Valkey, auf einem Volume von 1 GB | shared-cpu-1x, 512 MB |
Nur der Edge hat einen öffentlichen Dienst. Die anderen sind nur unter <app>.internal im privaten Netz Ihrer Organisation erreichbar, das IPv6 ist, also lauscht das Gateway auf [::]:8080. Der Edge liest Fly-Client-IP, das der Proxy von Fly setzt, statt des vom Aufrufer kontrollierten X-Forwarded-For.
Valkey hält seine Daten innerhalb von 256 MB und verdrängt nie einen Schlüssel, sodass ein volles Valkey Schreibzugriffe ablehnt, statt Limitzähler zu verwerfen. Es läuft auf einer Maschine mit einem Volume, das Fly nicht repliziert. Für seinen Inhalt ist das vertretbar: Das Gateway baut Budgetzähler aus PostgreSQL wieder auf, und Ratenfenster beginnen neu.
Ausrollen02
1. Erzeugen Sie einen Hauptschlüssel in eine Variable, und kopieren Sie, was echo ausgibt, in einen Passwort-Manager:
export KAESO_MASTER_KEYS=$(docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate)echo $KAESO_MASTER_KEYS2. Melden Sie sich an und klonen Sie den Branch prod, der das neueste Release enthält:
fly auth logingit clone --branch prod https://github.com/logicplanes/kaeso.gitcd kaeso3. Legen Sie die vier Apps an. App-Namen sind auf Fly.io eindeutig, also wählen Sie ein eigenes Präfix:
export KAESO_APP=kaeso-examplefly apps create $KAESO_APP-edgefly apps create $KAESO_APP-gatewayfly apps create $KAESO_APP-consolefly apps create $KAESO_APP-valkey4. Legen Sie die Datenbank in der Region der Apps an, und hängen Sie sie an das Gateway. fly mpg list zeigt die ID des Clusters:
fly mpg create --name $KAESO_APP --region fra --pg-major-version 17fly mpg attach $CLUSTER_ID --app $KAESO_APP-gateway --variable-name KAESO_POSTGRES_URL5. Setzen Sie die Secrets, mit Ihrem SMTP-Server anstelle der Beispiele:
export VALKEY_PASSWORD=$(openssl rand -hex 24)fly secrets set --stage --app $KAESO_APP-valkey VALKEY_PASSWORD=$VALKEY_PASSWORDfly secrets set --stage --app $KAESO_APP-edge \ KAESO_GATEWAY_UPSTREAM=$KAESO_APP-gateway.internal:8080 \ KAESO_CONSOLE_UPSTREAM=$KAESO_APP-console.internal:3000fly secrets set --stage --app $KAESO_APP-gateway \ KAESO_PUBLIC_URL=https://$KAESO_APP-edge.fly.dev \ KAESO_VALKEY_URL=redis://:$VALKEY_PASSWORD@$KAESO_APP-valkey.internal:6379 \ KAESO_MASTER_KEYS="$KAESO_MASTER_KEYS" \ KAESO_SETUP_EMAIL=owner@example.com KAESO_SMTP_HOST=smtp.example.com KAESO_SMTP_USER=kaeso \ KAESO_SMTP_PASSWORD=secret KAESO_SMTP_FROM="Kaeso <kaeso@example.com>"6. Rollen Sie aus: Valkey und die Konsole als je eine Maschine, dann das Gateway und den Edge:
fly deploy --config deploy/fly/valkey.toml --app $KAESO_APP-valkey --ha=falsefly deploy --config deploy/fly/console.toml --app $KAESO_APP-console --ha=falsefly deploy --config deploy/fly/gateway.toml --app $KAESO_APP-gatewayfly deploy --config deploy/fly/edge.toml --app $KAESO_APP-edge7. Legen Sie den ersten Benutzer an, mit dem einmaligen Einrichtungslink, den das Gateway an KAESO_SETUP_EMAIL sendet. Das Gateway-Image hat keine Shell; kommt die E-Mail nicht an, lesen Sie also den SMTP-Fehler in den Protokollen des Gateways, korrigieren Sie die Secrets, und das Gateway sendet bei seinem nächsten Start einen neuen Link.
Für Anfrageprotokolle setzen Sie KAESO_CLICKHOUSE_URL beim Gateway auf eine ClickHouse-HTTP-URL, etwa von ClickHouse Cloud. Ohne sie sind Anfrageprotokolle aus, und Nutzung, Limits und Budgets funktionieren gleich.
Ihre eigene Domain03
Fügen Sie dem Edge ein Zertifikat hinzu, richten Sie die DNS-Einträge so ein, wie fly certs add es angibt, und geben Sie dem Gateway die neue Adresse:
fly certs add kaeso.example.com --app $KAESO_APP-edgefly secrets set --app $KAESO_APP-gateway KAESO_PUBLIC_URL=https://kaeso.example.comAktualisieren und zurückrollen04
Ein Release ändert die Image-Tags in edge.toml, gateway.toml und console.toml. Holen Sie prod, und rollen Sie das Gateway, dann die Konsole und den Edge mit den Befehlen aus Schritt 6 aus. Das Gateway migriert die Datenbank beim Start, nur vorwärts, und eine Maschine bekommt 75 Sekunden, um sich zu leeren, wenn sie stoppt. Zum Zurückrollen rollen Sie ein früheres Image aus:
fly deploy --config deploy/fly/gateway.toml --app $KAESO_APP-gateway \ --image ghcr.io/logicplanes/kaeso-gateway:0.6.0Gut zu wissen05
- Fly Machines haben kein schreibgeschütztes Root-Dateisystem und keine Einstellung, um Linux-Capabilities zu entziehen, also laufen die Apps nur mit den Benutzern der Images.
- Managed Postgres bietet PostgreSQL 16 und 17, während das Compose-Paket 18 betreibt. Kaeso läuft auf 17, wie auf Google Cloud.
- Das Gateway vertraut jeder Adresse im privaten Netz der Organisation. Betreiben Sie Kaeso in einer eigenen Organisation, wenn andere Apps dort die Client-Adresse, die das Gateway protokolliert, nicht setzen können sollen.
Was getestet wurde06
Die Dateien bestehen das SchemaStore-Schema für fly.toml, und Weiterleitung, Streaming und Umgang mit Client-Adressen des Edge bestehen die lokalen Edge-Tests. Kaeso wurde noch nicht aus einem leeren Konto auf Fly.io ausgerollt. Wenn Sie es tun, sagen Sie uns, wie es lief.
Nächste Schritte07
- Fly.io in den Docs (öffnet in einem neuen Tab), mit den Dateien erklärt.
- Backups und Hauptschlüssel (öffnet in einem neuen Tab): Sichern Sie Managed Postgres und bewahren Sie den Hauptschlüssel außerhalb von Fly.io auf.
- Wo Sie Kaeso betreiben: wie sich Fly.io mit den anderen Plattformen vergleicht.
Von Kaeso Team


