Zum Inhalt springen

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
Ein heller Verlauf aus Orange und Pfirsich, diagonal abfallend gefaltet, mit warmem Licht in einer Ecke

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 bekommen

  • 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

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üllen

WertWas einzutragen ist
KAESO_MASTER_KEYSEin Hauptschlüssel, den Sie auch in einem Passwort-Manager aufbewahren
KAESO_SETUP_EMAILIhre Adresse; das Gateway sendet den Einrichtungslink dorthin
KAESO_SMTP_HOST, KAESO_SMTP_USER, KAESO_SMTP_PASSWORD, KAESO_SMTP_FROMIhr SMTP-Server
KAESO_CLICKHOUSE_URLEine 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 generate

App Platform verschlüsselt einen SECRET-Wert, sobald sie ihn erhält.

Mit dem Button ausrollen

  1. Öffnen Sie Deploy to DigitalOcean (öffnet in einem neuen Tab). App Platform liest die Spec vom Branch prod, der das neueste Release enthält.
  2. Tragen Sie in den Umgebungsvariablen von kaeso-gateway die Werte oben ein, und wählen Sie, wenn Sie möchten, eine andere Region.
  3. Legen Sie die App an, und warten Sie, bis ihr erstes Deployment läuft.
  4. Ö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 ausrollen

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 --wait

Setzen 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 --wait

Der 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 Domain

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ückrollen

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 --wait

Das 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 wurde

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 Schritte

Von Kaeso Team

Auf dieser Seite

Ihr Gateway.Ihre Request-Logs.

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