Worker pools (gehost)
Voor een gehost cluster draait kubehz het control plane en rolt het je worker pools uit op je eigen Hetzner-account, met de Hetzner-API-token die je hebt gekoppeld. De worker-servers verschijnen in je Hetzner-project als elke andere server: je betaalt ze rechtstreeks aan Hetzner, tegen Hetzner-prijzen; kubehz factureert alleen het control plane. Op workers zit geen kubehz-opslag.
Je beheert pools in het dashboard: bij het aanmaken van het cluster of later op de detailpagina van het cluster.
Self-hosted?
Op een self-hosted cluster rolt lok8s workers uit op je account zonder dat kubehz eraan te pas komt; zie KubeOne op Hetzner.
Vereisten
- Een gekoppelde Hetzner-API-token met Read & Write-rechten. Worker pools zijn precies de delegatiestap van de vertrouwensgrens: kubehz maakt servers aan op je account en heeft daarvoor een token nodig dat dat kan. Zie De Hetzner-token.
- Een gehost cluster dat is aangemaakt met de token al gekoppeld. De provisioningmodus ligt vast bij het aanmaken: een gehost cluster dat zonder gekoppelde token is aangemaakt, kan later geen worker pools krijgen. Koppel een token en maak het cluster opnieuw aan.
Wat je kunt doen
- Pools toevoegen en verwijderen: bij het aanmaken van het cluster of op elk moment daarna. Maximaal 4 pools per cluster, elk met 0–20 nodes.
- Het aantal nodes van een pool schalen, omhoog of omlaag.
- Een pool autoscalen: stel een minimum en maximum in in plaats van een vast aantal; de cluster-autoscaler past de pool aan op de vraag. Zolang autoscaling aanstaat, is het aantal nodes van de autoscaler; handmatig schalen wordt geweigerd. Dit vereist de cluster-autoscaler-addon in het cluster; zonder die hebben de grenzen geen effect.
- Labels en taints per pool, om workloads naar de juiste pool te sturen (de gereserveerde labelprefixen
kubernetes.io//k8s.io/zijn niet toegestaan). - Het machinetype van een pool wijzigen. Wees je bewust van wat dat betekent: elke node in de pool wordt vervangen, rollend door nieuwe servers, en je workloads worden opnieuw ingepland. Het dashboard laat je precies dat bevestigen voordat het begint.
Wat je niet kunt doen
- Regio per pool: elke pool draait in de regio van het cluster. Heb je een andere regio nodig, dan is dat een ander cluster.
- Schijfgrootte per pool: de schijf volgt het Hetzner-servertype dat je kiest, zoals op elke Hetzner-server.
We zetten dit liever hier op een rij dan dat je het ontdekt in een foutmelding.
Statische nodes
Een statische pool bevat worker-nodes die je zelf meebrengt: bare metal, een andere cloud of een VM die al bestaat. kubehz maakt, vervangt of roteert deze servers niet. De CLI doet de join voor je, op de machine zelf:
# op de machine die je toevoegt (vereist KUBEHZ_TOKEN)
lo kubehz node join --pool static
# achter NAT, of met een eigen naam
lo kubehz node join --pool static --name edge-1 --node-ip 203.0.113.7
# toon de kubeadm-join-regel en voer niets uit
lo kubehz node join --pool static --print-only--pool noemt de statische pool (weglaten mag als het cluster er maar één heeft), --name is standaard de korte hostnaam van de machine, --node-ip is het adres waarop andere nodes hem bereiken, --kubelet-version overschrijft wat de CLI van de machine afleest, en --cluster-id richt zich op een ander cluster dan dat van het actieve domein. lo kubehz node status toont de nodes die je hebt meegebracht; lo kubehz node remove --name <node> haalt er een weg en maakt zijn plek vrij.
Een statische node kost € 0,50 per node per maand. kubehz factureert elk begonnen uur volledig, zolang de node geregistreerd is. De uurbedragen komen nooit boven € 0,50 per maand uit, ook in een maand van 31 dagen, want de maandprijs is een plafond. Een NotReady-node is de enige uitzondering: kubehz factureert hem nooit, dus een dode node kost niets. Verwijder de node om de kosten te stoppen.
Voor het control plane en voor elke add-on gelden dezelfde regels. Zie Prijzen.
De regel hierboven blijft gelden: kubehz telt niets op bij de prijs van een server die je bij Hetzner koopt. De prijs voor statische nodes dekt de last die elke extra node op je gehoste control plane legt.
Statische pools gaan account voor account open tijdens de uitrol. Biedt je cluster de optie niet, vraag het dan in de chat.
Volgende stappen
- Gehost control plane: het gehoste pad als geheel
- Hoe het werkt: de vertrouwensgrens en waarvoor je token wordt gebruikt
- Prijzen: wat kubehz factureert en waarom
Documentstatus
| Aspect | Detail |
|---|---|
| Status | beschikbaar: gehoste clusters met een gekoppelde Hetzner-token |
| Laatst gecontroleerd | 2026-09-05 |