New
placement_groups_enableddecides whether Hetzner spread placement groups are created. They are off by default now, because Hetzner rejects server creation withinvalid_inputfor the server types and locations that do not support them,cpx31inashandhilfor example. Set it totrueon EU clusters with compatible server types to keep masters and the static worker pools on separate physical hosts. - by @mrmx
Fixes
createno longer reuses a private network from another region without saying so. A network found by name is now checked against the network zone of the masters' location, and a mismatch stops the run with thehcloud network deletecommand to clear it, instead of failing later on every server creation. - by @mrmx- The zone check also covers a network passed in with
networking.private_network.existing_network_name, and it looks at every subnet of the network rather than the first one. - Instance creation no longer dies with
Arithmetic overflowafter about an hour of retries. The back-off exponent is capped, and a permanentinvalid_inputrejection is reported with its hint straight away instead of being retried. - The project wide network listing no longer fails to decode for a subnet that comes back without an
ip_range, which used to breakcreateanddeletefor every cluster in the project.
Improvements
deletestill removes the placement groups of a cluster created before the option existed, and of one whose flag was turned off later, since a leftover group counts against the 50 per project limit.- The troubleshooting guide covers both MTU mismatch directions, pods larger than the configured MTU as well as smaller.
- 19 new specs cover the placement group flag, the zone check on real payload shapes, and the retry delay.
Upgrading
No configuration change is required, and the bundled addon pins are unchanged since v2.16.0.
Placement groups are opt-in now. A cluster built by an earlier version has them, and its next create adds nodes without a group unless you set placement_groups_enabled: true. Nodes that already exist keep the group they were created in, and delete removes them either way. Groups apply to the masters and to the static worker pools; autoscaled and external nodes never had one.
The important upgrade notes cover both changes.
If hetzner-k3s is useful to you or your company, please consider sponsoring its development.
Sponsorship helps ensure continued maintenance and new features. Thank you to our current sponsors! 🙏