Kaeso auf Azure ausrollen
Betreiben Sie Kaeso auf einer virtuellen Maschine in Azure, mit dem Button Deploy to Azure oder der Azure CLI. Das Installationsskript läuft beim ersten Start, und der Einrichtungslink kommt über Cloud Shell, ohne SSH.
- Veröffentlicht
- Lesezeit
- 3 Min.
- Autor
- Kaeso Team

Die Azure-Vorlage von Kaeso ist ein schneller Server: das Compose-Paket auf einer virtuellen Maschine, wie auf Ihrem eigenen Server, mit Caddy für TLS, einem gebündelten ClickHouse für Anfrageprotokolle und dem Updater. Für den Start braucht sie keine eigene Domain, denn Azure gibt der Maschine einen DNS-Namen, und Caddy bekommt dafür ein Zertifikat. Die ganze Bereitstellung dauert etwa fünf Minuten.
deploy/azure/ im Repository enthält die Azure-Resource-Manager-Vorlage, und createUiDefinition.json daneben gestaltet das Formular im Portal.
Was Sie bekommen01
- Ein virtuelles Netz mit einem Subnetz und eine Netzwerksicherheitsgruppe, die nur HTTP, HTTPS und HTTP/3 hereinlässt, und SSH nur aus einem Adressbereich, den Sie angeben.
- Eine statische öffentliche Adresse mit einem DNS-Namen unter
<region>.cloudapp.azure.com. - Eine virtuelle Maschine mit Ubuntu 24.04, Trusted Launch, Startdiagnose und einer 40-GB-Festplatte, standardmäßig
Standard_B2als_v2mit 2 vCPUs und 4 GB. - Eine Custom-Script-Erweiterung, die beim ersten Start das Installationsskript von Kaeso ausführt: Es installiert Docker, schreibt die Einstellungen und startet das Compose-Paket.
Die Vorlage enthält keines der Geheimnisse von Kaeso. Das Installationsskript erzeugt Hauptschlüssel und Passwörter auf dem Server selbst.
Mit dem Button ausrollen02
- 01Öffnen Sie Deploy to Azure (öffnet in einem neuen Tab) und melden Sie sich an. Das Portal liest die Vorlage vom Branch
prod, der das neueste Release enthält. - 02Wählen Sie ein Abonnement, eine neue Ressourcengruppe und eine Region, und tragen Sie die Parameter unten ein.
- 03Legen Sie die Bereitstellung an, und warten Sie, bis sie abgeschlossen ist. Sie endet, sobald das Installationsskript fertig ist.
- 04Kopieren Sie unter Outputs der Bereitstellung
setupLinkund führen Sie es in Azure Cloud Shell (öffnet in einem neuen Tab) oder mit der Azure CLI aus. Es gibt den einmaligen Einrichtungslink ohne SSH aus. Öffnen Sie ihn, um den ersten Benutzer anzulegen. - 05Mit einer eigenen Domain richten Sie ihren CNAME-Eintrag auf die Ausgabe
fqdn, oder einen A-Eintrag aufpublicIp. Caddy versucht es weiter, bis der Name aufgelöst wird, und holt dann das Zertifikat.
Mit der Azure CLI ausrollen03
Legen Sie aus einem Klon des Repositorys eine Ressourcengruppe an und rollen Sie die Vorlage darin aus:
az group create --name kaeso --location westeuropeaz deployment group create --resource-group kaeso \ --template-file deploy/azure/quick-server.json \ --parameters domain=kaeso.example.com \ adminPasswordOrKey="$(cat ~/.ssh/id_ed25519.pub)" sshSourceAddress=203.0.113.0/24Der Befehl gibt die Ausgaben aus, sobald die Bereitstellung abgeschlossen ist. Führen Sie daraus setupLink aus, wie in Schritt 4 oben.
Parameter04
| Parameter | Was er ist |
|---|---|
domain | Die Domain, auf der Kaeso antwortet; leer nutzt den DNS-Namen der Adresse |
dnsLabel | Der DNS-Name der Adresse unter <region>.cloudapp.azure.com; leer bildet einen aus der Ressourcengruppe |
kaesoVersion | Ein Release, das installiert wird; leer installiert das neueste stabile Release |
vmSize, diskSizeGb, diskType | Standardmäßig Standard_B2als_v2, 40 GB und Standard SSD |
adminUsername, authenticationType, adminPasswordOrKey | Der Administrator des Servers, mit einem öffentlichen SSH-Schlüssel oder einem Passwort |
sshSourceAddress | Ein Adressbereich, der SSH erreichen darf; leer hält Port 22 geschlossen |
location | Die Region; standardmäßig die der Ressourcengruppe |
Den Hauptschlüssel aufbewahren05
Kaeso verschlüsselt Anbieter-Schlüssel mit dem Hauptschlüssel in /opt/kaeso/master-keys, sodass sich ein Backup der Datenbank ohne ihn nicht lesen lässt. Bewahren Sie eine Kopie getrennt von Ihren Backups auf: Führen Sie den Befehl der Ausgabe setupLink mit cat /opt/kaeso/master-keys als Skript aus, um ihn auszugeben, und legen Sie ihn in einen Passwort-Manager.
Aktualisieren06
Updates funktionieren wie auf jeder Compose-Installation: aus der Konsole, automatisch in einem Zeitfenster Ihrer Wahl oder von Hand. Die Vorlage legt nur den Server an; sie erneut auszurollen aktualisiert Kaeso nicht.
Gut zu wissen07
- Dies ist nur ein schneller Server. Das Repository hat noch keine Vorlage für Azure Container Apps mit Azure Database for PostgreSQL und einem verwalteten Cache.
- Die Größen sind x64. Für eine Arm64-Größe rollen Sie Ubuntu 24.04 für Arm64 aus und führen das Installationsskript von Hand aus.
Was getestet wurde08
Die Vorlage besteht das ARM Template Test Toolkit von Microsoft. Sie wurde noch nicht aus einem leeren Azure-Konto ausgerollt; dasselbe Installationsskript schon, auf AWS und Google Cloud. Wenn Sie sie ausrollen, sagen Sie uns, wie es lief.
Nächste Schritte09
- Azure in den Docs (öffnet in einem neuen Tab), mit jedem Parameter.
- Upgrades (öffnet in einem neuen Tab): wie der Updater neue Releases installiert.
- Wo Sie Kaeso betreiben: wie sich Azure mit den anderen Plattformen vergleicht.
Von Kaeso Team


