Cluster API (CAPI) na Hetznerju

Vzpostavi Kubernetes clustre z uporabo Cluster API in Hetznerjevega infrastrukturnega ponudnika (CAPH).

Predpogoji

• Nameščen lok8s CLI
• Upravljalni CAPI cluster (ali uporabi lo za njegovo vzpostavitev)
• Nameščen clusterctl
• Hetzner Cloud API žeton, izvožen kot HCLOUD_TOKEN

Konfiguracija clustra

Ustvari cluster.lok8s.yaml s kind: Capi:

apiVersion: cluster.lok8s.dev/v1beta1
kind: Capi
metadata:
  name: capi-cluster
spec:
  kubernetes:
    version: "v1.35.5"
  provider: hetzner
  hcloud:
    region: fsn1
    sshPublicKeyFile: "~/.ssh/id_ed25519.pub"
    network:
      cidr: "10.0.0.0/16"
  controlPlane:
    replicas: 3
    type: cx33
  workers:
    platform:
      replicas: 2
      type: cpx31

Kako deluje vzpostavitev s CAPI

Ko zaženeš lo provision s kind: Capi, lok8s:

1. Generira manifeste CAPI Cluster in MachineDeployment
2. Jih uveljavi na upravljalnem clustru
3. CAPH ustvari Hetzner Cloud strežnike
4. Kubeadm vzpostavi Kubernetes na vozliščih
5. Kubeconfig se izvleče in lokalno shrani

Vzpostavi

lo provision

Struktura predloge

lok8s iz tvoje konfiguracije generira te CAPI vire:

• Cluster — nastavitve na ravni clustra (omrežje, regija)
• HetznerCluster — infrastruktura, specifična za Hetzner
• KubeadmControlPlane — stroji kontrolne ravnine
• MachineDeployment — nabori worker vozlišč
• HetznerMachineTemplate — tip strežnika in slika (image)

Preveri

# Preveri stanje CAPI clustra
kubectl get clusters -A

# Preveri vozlišča delovnega clustra
kubectl --kubeconfig=kubeconfig get nodes

Kdaj uporabiti CAPI in kdaj KubeOne

Vidik	KubeOne	CAPI
Upravljalni cluster	Ni potreben	Potreben
Deklarativni življenjski cikel	Delno	Popolno
Več clustrov	Ročno	Izvorno (native)
Kompleksnost	Nižja	Višja

KubeOne uporabi za posamezne clustre s preprostimi zahtevami. CAPI uporabi za okolja z več clustri ali infrastrukturo, vodeno z GitOps.

Naslednji koraki

• GitHub Actions — avtomatizacija vzpostavitve s CAPI v CI
• Registracija — registracija v nadzorno ploščo kubehz
• KubeOne — preprostejše alternativno orodje za vzpostavitev

---

Status dokumenta

Vidik	Podrobnost
Stanje	aktivno
Nazadnje pregledano	2026-07-10