Prvi cluster

Podroben sprehod skozi konfiguracijsko datoteko cluster.lok8s.yaml.

Predpogoji

• Nameščen lok8s CLI
• Račun Hetzner Cloud z API žetonom
• Par SSH ključev (priporočamo Ed25519)

Celotna referenca konfiguracije

# cluster.lok8s.yaml
apiVersion: cluster.lok8s.dev/v1beta1
kind: KubeOne
metadata:
  name: my-cluster
spec:
  kubernetes:
    version: "v1.35.5"
  cluster:
    domain: example.com          # domena clustra za ingress/certifikate
    namespace: default           # privzeti namespace za workloade
  provider: hetzner
  hcloud:
    region: fsn1                 # fsn1, nbg1 ali hel1
    sshPublicKeyFile: "~/.ssh/id_ed25519.pub"
    network:
      cidr: "10.0.0.0/16"       # obseg zasebnega omrežja
  ssh:
    user: root
    publicKeyFile: "~/.ssh/id_ed25519.pub"
    privateKeyFile: "~/.ssh/id_ed25519"
  controlPlane:
    replicas: 3                  # 1 za razvoj, 3 za HA produkcijo
    type: cx33                   # tip Hetzner strežnika
  workers:
    platform:
      replicas: 2
      type: cpx31                # ali 'dedicated' za namenske strežnike
  bootstrap:                     # cluster-infra dodatki, uporabljeni po vrsti
    - cilium                     # CNI (privzeto, če je polje izpuščeno)
    - ccm                        # Hetzner cloud-controller-manager
    - cert-manager
    - monitoring
  kubehz:
    hosting: self                # 'self' (na voljo) ali 'hosted' (zgodnji dostop)
    access: registered           # 'none', 'registered' ali 'managed' (Supporter+)
    apiUrl: https://api.kubehz.cloud

Ključni razdelki

spec.kubernetes

Nastavi različico Kubernetesa. Podprte različice: od v1.33 do v1.35.

spec.hcloud

Nastavitve Hetzner Cloud. region določa lokacijo podatkovnega centra. network.cidr definira zasebno omrežje za komunikacijo med podi.

spec.controlPlane

Uporabi replicas: 1 za razvojne clustre in replicas: 3 za produkcijski HA. Polje type se preslika na tipe Hetzner strežnikov.

spec.workers

Definiraj enega ali več naborov workerjev. Vsak nabor določa replicas in type. Za namenske strežnike uporabi dedicated.

spec.bootstrap

Urejen seznam cluster-infra dodatkov (CNI, CCM, cert-manager, monitoring, …), ki se uveljavijo ob vzpostavitvi, preden pristanejo delovne obremenitve. Vsak vnos se uveljavi in počaka na pripravljenost, preden pride na vrsto naslednji. Gola imena se razrešijo v framework dodatke lok8s; vnosi ./pot kažejo na tvoje lastne kustomize imenike. Če je polje izpuščeno, je privzeta vrednost cilium — vsak cluster potrebuje CNI. Celoten seznam najdeš v vodiču za dodatke lok8s.

spec.kubehz

Neobvezna integracija s platformo kubehz na dveh neodvisnih oseh. Na voljo danes: hosting: self z access: registered — cluster poganjaš na svojem računu, kubehz pa ti da vidljivost samo za branje na nadzorni plošči. hosting: hosted (kubehz poganja kontrolno ravnino) je v zgodnjem dostopu; access: managed na vrh registered doda funkcije kubehz za upravljanje — politike samodejnega okrevanja, nadzor kapacitet in upravljanje želenega stanja z nadzorne plošče — in zahteva naročnino Supporter ali višjo. Ukrepanje temelji na vleki: znotrajclustrski agent želeno stanje prevzame s platforme in ga uveljavi s poverilnicami tvojega clustra — kubehz nikoli nima dohodnega dostopa. Za celoten model in mejo zaupanja glej Kako deluje, za vklop vidljivosti pa Registracijo.

Vzpostavi svoj cluster

lo provision

Preveri

kubectl get nodes
kubectl get pods -A

Naslednji koraki

• Vzpostavitev nadzorne plošče — spremljaj svoj cluster
• Registracija — poveži se z nadzorno ploščo kubehz
• Vodnik za KubeOne — napredna konfiguracija KubeOne

---

Status dokumenta

Vidik	Podrobnost
Stanje	aktivno
Zadnji pregled	2026-07-10