Zum Inhalt springen

Kaeso auf Render ausrollen

Betreiben Sie Kaeso auf Render mit dem Blueprint aus dem Repository, mit öffentlichem Edge, privatem Gateway und privater Konsole, Render Postgres und Key Value. Schritt für Schritt, vom Hauptschlüssel bis zu Ihrer eigenen Domain.

Veröffentlicht
Lesezeit
3 Min.
Autor
Kaeso Team
Ein blasser Verlauf aus Orange, Rosa und Violett, diagonal ansteigend gefaltet, mit warmem Licht in einer Ecke

Render liest einen Blueprint, render.yaml, und legt jeden Dienst darin an. Das Repository von Kaeso hat einen im Wurzelverzeichnis, festgelegt auf das neueste Release. Er betreibt Kaeso auf fünf Render-Ressourcen, von denen nur eine öffentlich ist.

Was Sie bekommen

  • kaeso-edge
    Typ
    Web Service
    Image
    Das Konsolen-Image, das kaeso-edge ausführt
    Plan
    0,5 CPU, 512 MB
  • kaeso-gateway
    Typ
    Private Service
    Image
    Das Gateway-Image
    Plan
    2 CPU, 4 GB
  • kaeso-console
    Typ
    Private Service
    Image
    Das Konsolen-Image
    Plan
    0,5 CPU, 512 MB
  • kaeso-valkey
    Typ
    Key Value
    Image
    Das von Render, mit noeviction
    Plan
    256 MB
  • kaeso-postgres
    Typ
    Postgres
    Image
    Das von Render, Version 18
    Plan
    1 CPU, 2 GB

Nur der Edge ist öffentlich. Er sendet die APIs, den MCP-Server und seine Anmeldung an das Gateway und jeden anderen Pfad an die Konsole, über das private Netz von Render. Postgres und Key Value haben eine leere ipAllowList, sodass nur die Dienste sie erreichen. Jeder Dienst hat autoDeployTrigger: off: Render rollt nie bei einem Commit neu aus, und Ihre Installation bleibt auf dem Release, das Sie gewählt haben.

Ändern Sie einen Plan oder die Region im Blueprint, bevor Sie ihn anlegen; Render behält sie danach.

Bevor Sie beginnen

Sie brauchen ein Render-Konto, einen SMTP-Server für die E-Mails von Kaeso und Docker auf Ihrem Rechner, um den Hauptschlüssel zu erzeugen:

docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate

Bewahren Sie den Schlüssel in einem Passwort-Manager auf. Kaeso verschlüsselt Anbieter-Schlüssel damit, sodass sich ein Datenbank-Backup ohne ihn nicht lesen lässt.

Für Anfrageprotokolle brauchen Sie außerdem ein ClickHouse, etwa ClickHouse Cloud. Ohne es sind Anfrageprotokolle aus, und Nutzung, Limits und Budgets funktionieren gleich.

Ausrollen

  1. Öffnen Sie Deploy to Render (öffnet in einem neuen Tab). Es legt einen Blueprint aus dem Repository logicplanes/kaeso auf dem Branch prod an, der das neueste Release enthält.

  2. Tragen Sie die Werte ein, die der Blueprint abfragt:

    WertWas einzutragen ist
    KAESO_PUBLIC_URLhttps:// und die Adresse des Edge, etwa https://kaeso-edge.onrender.com
    KAESO_MASTER_KEYSDer Hauptschlüssel
    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, oder leer
  3. Wenden Sie den Blueprint an, und warten Sie, bis jeder Dienst läuft.

  4. Öffnen Sie den einmaligen Einrichtungslink, den das Gateway an KAESO_SETUP_EMAIL gesendet hat, und legen Sie den ersten Benutzer an. Das Gateway sendet bei jedem Start einen neuen Link, bis ein Benutzer existiert.

Fügen Sie dann in der Konsole einen Anbieter-Schlüssel hinzu, erstellen Sie einen Projektschlüssel und senden Sie eine erste Anfrage an https://kaeso-edge.onrender.com/v1.

Ihre eigene Domain

Fügen Sie die Domain bei kaeso-edge unter Settings hinzu, und richten Sie ihren DNS-Eintrag so ein, wie Render es angibt. Setzen Sie dann KAESO_PUBLIC_URL bei kaeso-gateway auf https:// und die Domain, und rollen Sie das Gateway neu aus.

Wie Client-Adressen ehrlich bleiben

Limits, Protokolle und Audit-Einträge von Kaeso halten die Adresse des Clients fest, also darf sie nichts sein, was sich ein Aufrufer ausdenken kann. Öffentlicher Verkehr erreicht vor Render Cloudflare, und Render hängt an das X-Forwarded-For des Aufrufers an, statt es zu ersetzen. Der Edge liest deshalb CF-Connecting-IP, das Cloudflare überschreibt, und sendet dem Gateway eine Adresse. Das Gateway vertraut allein dem Edge.

Das Gateway lauscht auf Port 8080 und hält seine Metriken auf seiner Loopback-Adresse, denn Render nimmt den einen Port, den ein Private Service auf allen Schnittstellen bindet, als seinen Port.

Aktualisieren und zurückrollen

Ein Release ändert die Image-Tags in render.yaml auf prod. Auf der Seite des Blueprints rollt Manual sync die Dienste auf dem neuen Release neu aus, und das Gateway migriert die Datenbank beim Start. Zum Zurückrollen nutzen Sie Rollback bei jedem Dienst auf sein vorheriges Deployment. Migrationen laufen nur vorwärts, sodass ein Zurückrollen über ein Release hinweg, dessen Migrationen die frühere Version nicht ausführen kann, bleibt, wo es ist, wie auf jeder Installation.

Was getestet wurde

Am 7. November 2026, während der Release-Kandidaten, wurde der Blueprint aus einem leeren Render-Projekt in Frankfurt angelegt. Er legte alle fünf Ressourcen an, die Einrichtungs-E-Mail kam an, Health- und Readiness-Prüfungen bestanden, und eine gestreamte Completion erreichte das Anfrageprotokoll der Konsole. Der Test fand außerdem, dass Render an X-Forwarded-For anhängt, was zur oben beschriebenen Änderung auf CF-Connecting-IP führte; diese Änderung besteht den lokalen Edge-Test und die Prüfung der Konfiguration, wurde aber noch nicht erneut live getestet.

Nächste Schritte

Von Kaeso Team

Auf dieser Seite

Ihr Gateway.Ihre Request-Logs.

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