Kaeso auf AWS ausrollen
Zwei CloudFormation-Vorlagen betreiben Kaeso auf AWS. Der schnelle Server legt das Compose-Paket mit einem Klick auf eine Graviton-Instanz; der verwaltete Stack betreibt es auf ECS Fargate mit Application Load Balancer, RDS und ElastiCache.
- Veröffentlicht
- Lesezeit
- 3 Min.
- Autor
- Kaeso Team

deploy/aws/ im Kaeso-Repository enthält zwei CloudFormation-Vorlagen für zwei verschiedene Bedürfnisse. Der schnelle Server ist das Compose-Paket auf einer EC2-Instanz, genau wie auf Ihrem eigenen Server, und startet mit einem Klick. Der verwaltete Stack betreibt Kaeso auf ECS Fargate mit den eigenen Datenspeichern von AWS, für Installationen, denen eine Maschine nicht mehr reicht.
Jedes Release lädt beide Vorlagen nach https://kaeso-cloudformation.s3.amazonaws.com/vX.Y.Z/ hoch, und ein stabiles Release auch nach latest/.
Der schnelle Server01
Launch on AWS (öffnet in einem neuen Tab) öffnet die veröffentlichte Vorlage in CloudFormation. Sie legt an:
- eine Graviton-Instanz mit Ubuntu 24.04, standardmäßig
t4g.mediummit einer 40-GB-Festplatte; - eine Elastic IP und eine Sicherheitsgruppe für HTTP, HTTPS und HTTP/3, mit SSH nur aus einem Adressbereich, den Sie wählen;
- einen optionalen Route-53-Eintrag für Ihre Domain.
Beim ersten Start führt die Instanz das Installationsskript von Kaeso aus. Es installiert Docker, schreibt die Einstellungen, erzeugt den Hauptschlüssel und startet das Compose-Paket mit Caddy, einem gebündelten ClickHouse für Anfrageprotokolle und dem Updater. So funktioniert Update in der Konsole, wie auf jeder Compose-Installation.
Über die CLI, mit einem Klon des Repositorys:
aws cloudformation deploy --stack-name kaeso --template-file deploy/aws/quick-server.yaml \ --parameter-overrides Domain=kaeso.example.com KeyName=my-key \ AllowedSshCidr=203.0.113.0/24 HostedZoneId=Z0123456789| Parameter | Was er ist |
|---|---|
Domain | Die Domain, auf der Kaeso antwortet; ohne HostedZoneId richten Sie ihren A-Eintrag auf die Ausgabe PublicIp |
KaesoVersion | Ein Release, das installiert wird; leer installiert das neueste stabile Release |
InstanceType, DiskSizeGb | Standardmäßig t4g.medium und 40 GB |
KeyName, AllowedSshCidr | SSH-Zugang, den kaeso setup-link braucht |
HostedZoneId | Eine Route-53-Zone der Domain, um ihren Eintrag anzulegen |
Sobald der Stack fertig ist und Caddy sein Zertifikat hat, führen Sie die Ausgabe SetupLink über SSH aus. Sie gibt den einmaligen Link aus, der den ersten Benutzer anlegt.
Der verwaltete Stack02
deploy/aws/managed.yaml baut Kaeso aus AWS-Diensten:
- eine VPC mit zwei öffentlichen und zwei privaten Subnetzen und einem NAT-Gateway;
- einen Application Load Balancer mit Ihrem ACM-Zertifikat, HTTP auf HTTPS umgeleitet, Pfadregeln, die die APIs, den MCP-Server und seine Anmeldung an das Gateway und alles andere an die Konsole senden, und einem Leerlauf-Timeout von 300 Sekunden für lange Streams;
- einen ECS-Cluster auf Fargate mit Graviton, in den privaten Subnetzen: einen Gateway-Dienst mit standardmäßig 2 Tasks zu je 2 vCPUs und 4 GB, und einen Konsolen-Dienst;
- RDS PostgreSQL 18 und ElastiCache Valkey mit
noeviction, TLS und einem AUTH-Token, beide nur vom Gateway erreichbar; - Secrets-Manager-Secrets für die Hauptschlüssel, das Datenbankpasswort, das Valkey-Token, das SMTP-Passwort und die ClickHouse-URL;
- CloudWatch-Log-Gruppen und einen optionalen Route-53-Alias.
aws cloudformation deploy --stack-name kaeso --template-file deploy/aws/managed.yaml \ --capabilities CAPABILITY_IAM --parameter-overrides \ Domain=kaeso.example.com \ CertificateArn=arn:aws:acm:eu-central-1:123456789012:certificate/example \ MasterKeys="$(docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate)" \ SetupEmail=owner@example.com SmtpHost=smtp.example.com SmtpUser=kaeso \ SmtpPassword=secret SmtpFrom="Kaeso <kaeso@example.com>"Bewahren Sie eine Kopie des Hauptschlüssels auch in einem Passwort-Manager auf: Kaeso verschlüsselt Anbieter-Schlüssel damit. Weitere Parameter bestimmen die Größe des Stacks: GatewayCpu, GatewayMemory und GatewayCount für das Gateway, und DatabaseInstanceClass, DatabaseStorageGb und CacheNodeType für die Datenspeicher. Mehrere Gateway-Tasks teilen Limits, Caches und die Wartezeiten der Routen über Valkey. Für Anfrageprotokolle setzen Sie ClickHouseUrl auf ein ClickHouse wie ClickHouse Cloud; leer lässt sie aus.
Das Gateway sendet den einmaligen Einrichtungslink an SetupEmail, bis der erste Benutzer existiert. Es vertraut X-Forwarded-For nur aus der VPC, in der die Knoten des Load Balancers sitzen. Der Load Balancer prüft /readyz beim Gateway und /healthz bei der Konsole, und ein Gateway-Task bekommt 75 Sekunden, um sich zu leeren, wenn er stoppt.
Aktualisieren und zurückrollen03
Auf dem schnellen Server aktualisieren Sie aus der Konsole, automatisch in einem Zeitfenster Ihrer Wahl oder von Hand, wie auf jeder Compose-Installation. Die Vorlage erneut auszurollen aktualisiert Kaeso nicht.
Beim verwalteten Stack ändert ein Release die Image-Tags in managed.yaml. Rollen Sie die neue Vorlage über den Stack aus: ECS ersetzt die Tasks mit einem Circuit Breaker, der bei einem Fehler zurückrollt, und das Gateway migriert die Datenbanken beim Start, nur vorwärts. Um absichtlich zurückzurollen, rollen Sie die Vorlage des vorherigen Releases aus.
Was getestet wurde04
Am 7. November 2026 wurde der schnelle Server als CloudFormation-Stack in us-east-1 aus einem leeren Konto gestartet, mit dem achten Release-Kandidaten. Er legte seinen ersten Benutzer an und bestand die Prüfungen für Weiterleitung, Streaming und Protokollierung, nachdem die Datei des Hauptschlüssels auf der Testinstanz wieder dem Installationsskript gehörte. Die Vorlage lässt diesen Besitz jetzt unverändert, aber die korrigierte Vorlage wurde noch nicht erneut aus einem leeren Konto ausgerollt. Der verwaltete Stack wird in CI gelintet und formatiert und wurde noch nicht ausgerollt.
Nächste Schritte05
- AWS in den Docs (öffnet in einem neuen Tab), mit jedem Parameter.
- Mehrere Gateways (öffnet in einem neuen Tab): was ein, zwei und drei Gateways bedienen.
- Wo Sie Kaeso betreiben: wie sich AWS mit den anderen Plattformen vergleicht.
Von Kaeso Team


