Cluster aktualisieren

Diese Anleitung erklärt, wie Sie die Kubernetes-Version eines Hikube-Clusters aktualisieren. Die Aktualisierungen erfolgen per Rolling Update, ohne Unterbrechung der Steuerungsebene.

Voraussetzungen

• Ein bereitgestellter Kubernetes-Hikube-Cluster (siehe Schnellstart)
• kubectl konfiguriert für die Interaktion mit der Hikube-API
• Die kubeconfig des Child-Clusters abgerufen

Schritte

1. Aktuelle Version prüfen

Identifizieren Sie die aktuell auf Ihrem Cluster bereitgestellte Kubernetes-Version:

# Version in der Hikube-Konfiguration
kubectl get kubernetes my-cluster -o yaml | grep version

# Von den Knoten gemeldete Version
kubectl --kubeconfig=cluster-admin.yaml get nodes

Erwartetes Ergebnis:

NAME                         STATUS   ROLES    AGE   VERSION
my-cluster-general-xxxxx     Ready    <none>   30d   v1.29.0
my-cluster-general-yyyyy     Ready    <none>   30d   v1.29.0

2. Verfügbare Versionen prüfen

Bevor Sie aktualisieren, prüfen Sie die von Hikube unterstützten Versionen:

# Aktuelle Cluster-Konfiguration prüfen
kubectl get kubernetes my-cluster -o yaml

Warnung

Testen Sie das Update immer in einer Staging-Umgebung vor der Produktion. Einige Anwendungen sind möglicherweise nicht mit den neuen Kubernetes-Versionen kompatibel.

Hinweis

Die Updates müssen inkrementell erfolgen (zum Beispiel v1.29 auf v1.30). Überspringen Sie nicht mehrere Minor-Versionen auf einmal.

3. Version aktualisieren

Option A: Direkter Patch

kubectl patch kubernetes my-cluster --type='merge' -p='
spec:
  version: "v1.30.0"
'

Option B: YAML-Datei bearbeiten

cluster-upgrade.yaml

apiVersion: apps.cozystack.io/v1alpha1
kind: Kubernetes
metadata:
  name: my-cluster
spec:
  version: "v1.30.0"

  controlPlane:
    replicas: 3

  nodeGroups:
    general:
      minReplicas: 2
      maxReplicas: 5
      instanceType: "s1.large"
      ephemeralStorage: 50Gi
      roles:
        - ingress-nginx

kubectl apply -f cluster-upgrade.yaml

4. Rolling Update verfolgen

Beobachten Sie den Ablauf des Updates:

# Status des Hikube-Clusters verfolgen
kubectl get kubernetes my-cluster -w

# Austausch der Maschinen beobachten
kubectl get machines -l cluster.x-k8s.io/cluster-name=my-cluster -w

# Events prüfen
kubectl describe kubernetes my-cluster

Tipp

Die Updates erfolgen per Rolling Update: Die Knoten werden einzeln ersetzt. Die Steuerungsebene wird zuerst aktualisiert, gefolgt von den Node Groups. Ihre Workloads laufen während des Updates weiter.

5. Update überprüfen

Sobald das Rolling Update abgeschlossen ist, bestätigen Sie die neue Version:

# Knoten-Version prüfen
kubectl --kubeconfig=cluster-admin.yaml get nodes

# API Server Version prüfen
kubectl --kubeconfig=cluster-admin.yaml version

Überprüfung

Validieren Sie, dass der Cluster nach dem Update ordnungsgemäß funktioniert:

# Knoten im Zustand Ready mit neuer Version
kubectl --kubeconfig=cluster-admin.yaml get nodes

# System-Pods betriebsbereit
kubectl --kubeconfig=cluster-admin.yaml get pods -n kube-system

# Ihre Workloads funktionieren
kubectl --kubeconfig=cluster-admin.yaml get pods -A

Erwartetes Ergebnis:

NAME                         STATUS   ROLES    AGE   VERSION
my-cluster-general-xxxxx     Ready    <none>   5m    v1.30.0
my-cluster-general-yyyyy     Ready    <none>   3m    v1.30.0

Warnung

Wenn Pods nach dem Update fehlerhaft bleiben, prüfen Sie die Kompatibilität Ihrer Manifeste mit der neuen Kubernetes-Version. Einige veraltete APIs könnten entfernt worden sein.

Weiterführende Informationen

• API-Referenz -- Feld version und vollständige Konfiguration
• Konzepte -- Architektur der Steuerungsebene und Rolling Updates
• Zugang und Tools -- Debugging- und Monitoring-Befehle