Skip to content

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.

Nächste Schritte


Doku-Status

AspektDetail
Zustandverfügbar — gehostete Cluster mit verbundenem Hetzner-Token
Zuletzt geprüft2026-07-10