Worker-Pools (Hosted)
Bei einem gehosteten Cluster betreibt kubehz die Control Plane und stellt deine Worker-Pools auf deinem eigenen Hetzner-Konto bereit, mit dem Hetzner-API-Token, das du verbunden hast. Die Worker-Server erscheinen in deinem Hetzner-Projekt wie jeder andere Server: Du bezahlst sie direkt an Hetzner, zu Hetzner-Preisen; kubehz berechnet nur die Control Plane. Auf Worker gibt es keinen kubehz-Aufschlag.
Du verwaltest Pools im Dashboard: beim Erstellen des Clusters oder später auf der Detailseite des Clusters.
Self-Hosted?
Auf einem Self-Hosted-Cluster stellt lok8s Worker auf deinem Konto bereit, ohne dass kubehz beteiligt ist; siehe KubeOne auf Hetzner.
Voraussetzungen
- Ein verbundenes Hetzner-API-Token mit Read-&-Write-Berechtigung. Worker-Pools sind genau der Delegationsschritt der Vertrauensgrenze: kubehz erstellt Server auf deinem Konto und braucht dafür ein Token, das das kann. Siehe Das Hetzner-Token.
- Ein gehosteter Cluster, erstellt mit bereits verbundenem Token. Der Bereitstellungsmodus wird beim Erstellen festgelegt: Ein gehosteter Cluster, der ohne verbundenes Token erstellt wurde, kann später keine Worker-Pools erhalten. Verbinde ein Token und erstelle den Cluster neu.
Was du tun kannst
- Pools hinzufügen und entfernen: beim Erstellen des Clusters oder jederzeit danach. Bis zu 4 Pools pro Cluster, jeder mit 0–20 Nodes.
- Die Node-Anzahl eines Pools skalieren, nach oben oder unten.
- Einen Pool autoskalieren: statt einer festen Anzahl ein Minimum und ein Maximum setzen; der Cluster-Autoscaler passt den Pool an die Last an. Solange Autoscaling aktiv ist, gehört die Node-Anzahl dem Autoscaler; manuelles Skalieren wird abgelehnt. Das setzt das Cluster-Autoscaler-Addon im Cluster voraus; ohne es haben die Grenzen keine Wirkung.
- Labels und Taints pro Pool, um Workloads auf den richtigen Pool zu lenken (die reservierten Label-Präfixe
kubernetes.io//k8s.io/sind nicht erlaubt). - Den Maschinentyp eines Pools ändern. Mach dir klar, was das bedeutet: Jeder Node im Pool wird ersetzt, rollierend durch neue Server, und deine Workloads werden neu eingeplant. Das Dashboard lässt dich genau das bestätigen, bevor es beginnt.
Was du nicht tun kannst
- Region pro Pool: Jeder Pool läuft in der Region des Clusters. Brauchst du eine andere Region, ist das ein weiterer Cluster.
- Festplattengröße pro Pool: Die Festplatte folgt dem gewählten Hetzner-Servertyp, wie bei jedem Hetzner-Server.
Wir listen das lieber hier auf, als dass du es in einer Fehlermeldung entdeckst.
Statische Nodes
Ein statischer Pool enthält Worker-Nodes, die du selbst mitbringst: Bare-Metal, eine andere Cloud oder eine VM, die schon existiert. kubehz erstellt, ersetzt oder rotiert diese Server nicht. Den Join erledigt die CLI für dich, auf der Maschine selbst:
# auf der Maschine, die du hinzufügst (braucht KUBEHZ_TOKEN)
lo kubehz node join --pool static
# hinter NAT oder mit eigenem Namen
lo kubehz node join --pool static --name edge-1 --node-ip 203.0.113.7
# die kubeadm-join-Zeile ansehen und nichts ausführen
lo kubehz node join --pool static --print-only--pool benennt den statischen Pool (entfällt, wenn der Cluster nur einen hat), --name ist standardmäßig der kurze Hostname der Maschine, --node-ip die Adresse, unter der andere Nodes sie erreichen, --kubelet-version überschreibt, was die CLI von der Maschine liest, und --cluster-id zielt auf einen anderen Cluster als den der aktiven Domain. lo kubehz node status listet die Nodes, die du mitgebracht hast; lo kubehz node remove --name <node> nimmt einen heraus und gibt seinen Platz frei.
Ein statischer Node kostet 0,50 € pro Node und Monat. kubehz berechnet jede angefangene Stunde voll, solange der Node registriert ist. Die Stundenbeträge gehen nie über 0,50 € im Monat hinaus, auch in einem Monat mit 31 Tagen, denn der Monatspreis ist ein Deckel. Ein NotReady-Node ist die einzige Ausnahme: kubehz berechnet ihn nie, ein toter Node kostet also nichts. Entferne den Node, um die Kosten zu beenden.
Für die Control Plane und für jedes Add-on gelten dieselben Regeln. Siehe Preise.
Die Regel oben gilt weiter: Auf den Preis eines Servers, den du bei Hetzner kaufst, schlägt kubehz nichts auf. Der Preis für statische Nodes deckt die Last, die jeder zusätzliche Node auf deiner gehosteten Control Plane erzeugt.
Statische Pools werden pro Konto freigeschaltet, solange der Rollout läuft. Zeigt dein Cluster die Option nicht, frag im Chat.
Nächste Schritte
- Gehostete Control Plane: der Hosted-Pfad insgesamt
- Wie es funktioniert: die Vertrauensgrenze und wofür dein Token verwendet wird
- Preise: was kubehz berechnet und warum
Doku-Status
| Aspekt | Detail |
|---|---|
| Zustand | verfügbar: gehostete Cluster mit verbundenem Hetzner-Token |
| Zuletzt geprüft | 2026-09-05 |