Zum Inhalt springen

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
Ein heller Verlauf aus Koralle und Rosa, in senkrechten Falten wie ein Vorhang, mit warmem Licht in einer Ecke

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 bekommen

  • 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_v2 mit 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 ausrollen

  1. Ö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.
  2. Wählen Sie ein Abonnement, eine neue Ressourcengruppe und eine Region, und tragen Sie die Parameter unten ein.
  3. Legen Sie die Bereitstellung an, und warten Sie, bis sie abgeschlossen ist. Sie endet, sobald das Installationsskript fertig ist.
  4. Kopieren Sie unter Outputs der Bereitstellung setupLink und 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.
  5. Mit einer eigenen Domain richten Sie ihren CNAME-Eintrag auf die Ausgabe fqdn, oder einen A-Eintrag auf publicIp. Caddy versucht es weiter, bis der Name aufgelöst wird, und holt dann das Zertifikat.

Mit der Azure CLI ausrollen

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/24

Der Befehl gibt die Ausgaben aus, sobald die Bereitstellung abgeschlossen ist. Führen Sie daraus setupLink aus, wie in Schritt 4 oben.

Parameter

ParameterWas er ist
domainDie Domain, auf der Kaeso antwortet; leer nutzt den DNS-Namen der Adresse
dnsLabelDer DNS-Name der Adresse unter <region>.cloudapp.azure.com; leer bildet einen aus der Ressourcengruppe
kaesoVersionEin Release, das installiert wird; leer installiert das neueste stabile Release
vmSize, diskSizeGb, diskTypeStandardmäßig Standard_B2als_v2, 40 GB und Standard SSD
adminUsername, authenticationType, adminPasswordOrKeyDer Administrator des Servers, mit einem öffentlichen SSH-Schlüssel oder einem Passwort
sshSourceAddressEin Adressbereich, der SSH erreichen darf; leer hält Port 22 geschlossen
locationDie Region; standardmäßig die der Ressourcengruppe

Den Hauptschlüssel aufbewahren

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.

Aktualisieren

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 wissen

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

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 Schritte

Von Kaeso Team

Auf dieser Seite

Ihr Gateway.Ihre Request-Logs.

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