hcloud-talos

Commands

This CLI tool provides an easy way to manage Talos powered Kubernetes clusters on the Hetzner Cloud. Bootstrapping a new cluster performs the following steps:

• Create private network 10.0.0.0/16 for inter-node communication
• Create placement group to ensure controlplane nodes to not run on the same physical machine
• Create load balancer to access the controlplane nodes Kubernetes API server (port 6443) or Talos API server (port 50000)
• Create firewall rules to block access to nodes from outside of the private network
• Create first controlplane node
• Install Hetzner Cloud Controller Manger
• Install Hetzner CSI Driver

Usage

# ATTENTION: this folder will contain all crucial files and they must be stored somewhere secure!
mkdir my-cluster
cd my-cluster

export HCLOUD_TOKEN=...
# bootstrap cluster
hcloud-talos -v bootstrap-cluster --talos-version=1.8.4 --kubernetes-version=1.31.12 my-cluster controlplane-%id%

# add more nodes
hcloud-talos -v add-node --talos-version=1.8.4 controlplane-%id% --controlplane
hcloud-talos -v add-node --talos-version=1.8.4 worker-%id%