Kaeso auf DigitalOcean ausrollen
Betreiben Sie Kaeso auf DigitalOcean App Platform mit dem Button Deploy to DigitalOcean, oder mit doctl und einem verwalteten Valkey für den Produktivbetrieb. Der eigene Edge der App leitet Konsole und APIs auf einer Domain.
- Veröffentlicht
- Lesezeit
- 3 Min.
- Autor
- Kaeso Team

App Platform von DigitalOcean betreibt Container hinter einem Edge, der TLS terminiert und nach Pfad weiterleitet. Kaeso nutzt diesen Edge direkt: Die App sendet die APIs an das Gateway und alles andere an die Konsole, sodass hier kein kaeso-edge läuft.
Das Repository hat zwei App-Specs. .do/deploy.template.yaml liest der Button Deploy to DigitalOcean, mit Valkey innerhalb der App. .do/app.yaml nutzt stattdessen eine verwaltete Valkey-Datenbank, und Sie legen sie mit doctl an. Nutzen Sie den Button, um Kaeso auszuprobieren, und doctl für eine Installation, die Sie behalten.
Was Sie bekommen01
kaeso-gateway- Art
- Dienst auf Port 8080, das Gateway-Image
- Größe
apps-s-1vcpu-2gb
kaeso-console- Art
- Dienst auf Port 3000, das Konsolen-Image
- Größe
apps-s-1vcpu-0.5gb
kaeso-postgres- Art
- Dev-Datenbank, PostgreSQL 18
- Größe
- 512 MB
kaeso-valkey(Button)- Art
- Dienst auf Port 6379, nur für die Komponenten der App
- Größe
apps-s-1vcpu-0.5gb
kaeso-valkey(doctl)- Art
- Verwaltete Valkey-Datenbank, zuerst angelegt
- Größe
- Nach Ihrer Wahl
| Komponente | Art | Größe |
|---|---|---|
kaeso-gateway | Dienst auf Port 8080, das Gateway-Image | apps-s-1vcpu-2gb |
kaeso-console | Dienst auf Port 3000, das Konsolen-Image | apps-s-1vcpu-0.5gb |
kaeso-postgres | Dev-Datenbank, PostgreSQL 18 | 512 MB |
kaeso-valkey (Button) | Dienst auf Port 6379, nur für die Komponenten der App | apps-s-1vcpu-0.5gb |
kaeso-valkey (doctl) | Verwaltete Valkey-Datenbank, zuerst angelegt | Nach Ihrer Wahl |
Der Edge leitet /v1, /v1beta, /v2, /platform, /mcp, /oauth und /.well-known an das Gateway und jeden anderen Pfad an die Konsole. Das Gateway vertraut X-Forwarded-For aus dem privaten Netz, in dem der Edge sitzt, und hält seine Metriken auf seiner Loopback-Adresse.
KAESO_PUBLIC_URL ist ${APP_URL}, die primäre Adresse der App, und die Datenbankadressen kommen von den Datenbanken, sodass Sie keine davon eintippen.
Die Werte zum Ausfüllen02
| Wert | Was einzutragen ist |
|---|---|
KAESO_MASTER_KEYS | Ein Hauptschlüssel, den Sie auch in einem Passwort-Manager aufbewahren |
KAESO_SETUP_EMAIL | Ihre Adresse; das Gateway sendet den Einrichtungslink dorthin |
KAESO_SMTP_HOST, KAESO_SMTP_USER, KAESO_SMTP_PASSWORD, KAESO_SMTP_FROM | Ihr SMTP-Server |
KAESO_CLICKHOUSE_URL | Eine ClickHouse-HTTP-URL mit Benutzer und Passwort für Anfrageprotokolle, oder leer |
Erzeugen Sie den Hauptschlüssel mit Docker:
docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generateApp Platform verschlüsselt einen SECRET-Wert, sobald sie ihn erhält.
Mit dem Button ausrollen03
- 01Öffnen Sie Deploy to DigitalOcean (öffnet in einem neuen Tab). App Platform liest die Spec vom Branch
prod, der das neueste Release enthält. - 02Tragen Sie in den Umgebungsvariablen von
kaeso-gatewaydie Werte oben ein, und wählen Sie, wenn Sie möchten, eine andere Region. - 03Legen Sie die App an, und warten Sie, bis ihr erstes Deployment läuft.
- 04Öffnen Sie den einmaligen Einrichtungslink, den Ihnen das Gateway gesendet hat, und legen Sie den ersten Benutzer an.
Der Button kann nur Dev-Datenbanken anlegen, und die gibt es nur für PostgreSQL. Sein Valkey läuft deshalb als Dienst in der App, hält seine Daten innerhalb von 256 MB und verdrängt nie einen Schlüssel. Er beginnt bei jedem seiner Deployments leer, was für seinen Inhalt in Ordnung ist: Das Gateway baut Budgetzähler aus PostgreSQL wieder auf, und Ratenfenster beginnen neu. Die Dev-Datenbank hält allerdings keine Backups, also nutzen Sie für den Produktivbetrieb doctl, oder verlegen Sie die App auf einen verwalteten PostgreSQL-Cluster und einen verwalteten Valkey.
Mit doctl ausrollen04
Installieren Sie doctl (öffnet in einem neuen Tab), melden Sie sich an und legen Sie die Valkey-Datenbank in der Region der App an:
doctl auth initdoctl databases create kaeso-valkey --engine valkey --region fra1 --size db-s-1vcpu-1gb --num-nodes 1 --waitSetzen Sie in den Settings der Datenbank Eviction policy auf No eviction, sodass eine volle Datenbank Schreibzugriffe ablehnt, statt Limitzähler zu verwerfen. Kopieren Sie dann .do/app.yaml aus dem Release, das Sie ausrollen, tragen Sie die Werte ein und legen Sie die App an:
doctl apps create --spec app.yaml --waitDer verwaltete Valkey spricht TLS mit einem Zertifikat von DigitalOceans eigener Zertifizierungsstelle, das die Spec dem Gateway als KAESO_VALKEY_CA übergibt. Für eine Datenbank mit Backups legen Sie einen verwalteten PostgreSQL-Cluster an und richten kaeso-postgres mit production: true und seinem cluster_name darauf.
Ihre eigene Domain05
Aus dem Button: Fügen Sie die Domain in den Settings der App unter Domains hinzu, und richten Sie den DNS-Eintrag so ein, wie App Platform es angibt. ${APP_URL} folgt der primären Domain, sodass das Gateway mit der neuen Adresse neu ausgerollt wird.
Aus doctl: Fügen Sie sie in der Spec unter domains mit type: PRIMARY hinzu, wenden Sie die Spec mit doctl apps update an, und richten Sie den DNS-Eintrag so ein, wie es der Tab Networking der App angibt.
Aktualisieren und zurückrollen06
Ein Release ändert die Image-Tags von kaeso-gateway und kaeso-console. Setzen Sie beide Tags in der Spec Ihrer App und wenden Sie sie an:
doctl apps spec get $APP_ID > app.yamldoctl apps update $APP_ID --spec app.yaml --waitDas Gateway migriert die Datenbanken beim Start, nur vorwärts. Zum Zurückrollen wählen Sie Rollback neben einem früheren Deployment im Tab Activity der App; App Platform behält die zehn letzten erfolgreichen Deployments.
Was getestet wurde07
Die Validierungs- und Proposal-API von App Platform hat die Spec des Buttons am 9. November 2026 angenommen. Kaeso wurde noch nicht aus einem leeren Konto auf DigitalOcean ausgerollt. Wenn Sie es tun, sagen Sie uns, wie es lief.
Nächste Schritte08
- DigitalOcean in den Docs (öffnet in einem neuen Tab), mit beiden Specs vollständig.
- Backups und Hauptschlüssel (öffnet in einem neuen Tab): Wechseln Sie auf einen verwalteten PostgreSQL-Cluster mit Backups.
- Wo Sie Kaeso betreiben: wie sich DigitalOcean mit den anderen Plattformen vergleicht.
Von Kaeso Team


