Quickstart

Avvia un cluster Kubernetes su Hetzner in 5 minuti.

Prerequisiti

• Un account Hetzner Cloud
• La CLI lok8s installata (b env add github.com/kernpilot/lok8s)
• Una coppia di chiavi SSH (Ed25519 consigliata)

1. Crea la configurazione del cluster

# cluster.lok8s.yaml
apiVersion: cluster.lok8s.dev/v1beta1
kind: KubeOne
metadata:
  name: my-cluster
spec:
  kubernetes:
    version: "v1.35.5"
  provider: hetzner
  hcloud:
    region: fsn1                 # fsn1, nbg1 o hel1
    sshPublicKeyFile: "~/.ssh/id_ed25519.pub"
  ssh:
    user: root
    publicKeyFile: "~/.ssh/id_ed25519.pub"
    privateKeyFile: "~/.ssh/id_ed25519"
  controlPlane:
    replicas: 1                  # 1 per dev, 3 per HA
    type: cx33
  workers:
    platform:
      replicas: 2
      type: cpx31

2. Provisioning

lo provision

Questo crea il control plane e i worker node su Hetzner Cloud. Il kubeconfig viene salvato automaticamente.

3. Verifica

kubectl get nodes

Dovresti vedere il control plane e i worker node nello stato Ready.

4. Registrazione con kubehz (opzionale)

Collega il tuo cluster alla dashboard kubehz per la visibilità della salute in sola lettura. La registrazione è solo in uscita — kubehz non ottiene mai accesso dentro il tuo cluster.

lo kubehz register

Questo annuncia il cluster come pending (in attesa). Poi rivendicalo (claim) su app.kubehz.cloud per dimostrare la proprietà e collegarlo al tuo account (register → claim → owned). Vedi Registrazione per i dettagli e cosa mostra la dashboard.

Prossimi passi

• Guida al primo cluster — riferimento dettagliato della configurazione
• Dashboard e account — esplora la dashboard, il team e l'account
• Come funziona — il modello, il confine di fiducia e i tuoi dati
• Guida Self-Hosted — configurazione self-hosted avanzata
• Control plane hosted — il percorso delegato (early access)