Schnellstart

Bringe in 5 Minuten einen Kubernetes-Cluster auf Hetzner zum Laufen.

Voraussetzungen

• Ein Hetzner Cloud-Konto
• lok8s CLI installiert (b env add github.com/kernpilot/lok8s)
• Ein SSH-Schlüsselpaar (Ed25519 empfohlen)

1. Cluster-Konfiguration erstellen

# 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 oder hel1
    sshPublicKeyFile: "~/.ssh/id_ed25519.pub"
  ssh:
    user: root
    publicKeyFile: "~/.ssh/id_ed25519.pub"
    privateKeyFile: "~/.ssh/id_ed25519"
  controlPlane:
    replicas: 1                  # 1 für Dev, 3 für HA
    type: cx33
  workers:
    platform:
      replicas: 2
      type: cpx31

2. Bereitstellen

lo provision

Dies erstellt deine Control Plane und Worker-Nodes auf Hetzner Cloud. Die kubeconfig wird automatisch gespeichert.

3. Überprüfen

kubectl get nodes

Deine Control Plane und Worker-Nodes sollten im Zustand Ready erscheinen.

4. Bei kubehz registrieren (optional)

Verbinde deinen Cluster mit dem kubehz-Dashboard für schreibgeschützte Zustandssichtbarkeit. Die Registrierung ist nur ausgehend — kubehz erhält niemals Zugriff in deinen Cluster.

lo kubehz register

Dies meldet den Cluster als pending an. Beanspruche ihn anschließend unter app.kubehz.cloud, um den Besitz nachzuweisen und ihn mit deinem Konto zu verknüpfen (registrieren → beanspruchen → besitzen). Siehe Registrierung für die Details und was das Dashboard anzeigt.

Nächste Schritte

• Erster-Cluster-Walkthrough — detaillierte Konfigurationsreferenz
• Dashboard & Konto — das Dashboard, Team und Konto erkunden
• Wie es funktioniert — das Modell, die Vertrauensgrenze und deine Daten
• Self-Hosted-Leitfaden — fortgeschrittene Self-Hosted-Einrichtung
• Gehostete Control Plane — der delegierte Weg (Early Access)