Hinweis:

Kubernetes-Version auf Oracle Cloud Native Environment upgraden

Einführung

Best Practices empfehlen, Ihr Kubernetes-Cluster so bald wie möglich nach einem neuen Release upzugraden. Die Gründe für ein schnelles Upgrade sind:

Dieses Tutorial zeigt, wie Sie die Kubernetes-Version upgraden, die in Ihrem Oracle CNE-Cluster verwendet wird.

Weitere Informationen zu Oracle CNE finden Sie auf der aktuellen Website zur Releasedokumentation.

Ziele

In diesem Tutorial lernen Sie Folgendes:

Voraussetzungen

Oracle Cloud Native Environment bereitstellen

Hinweis: Wenn Sie in Ihrem eigenen Mandanten ausgeführt werden, lesen Sie das Projekt linux-virt-labs GitHub README.md, und schließen Sie die Voraussetzungen ab, bevor Sie die Übungsumgebung bereitstellen.

  1. Öffnen Sie ein Terminal auf dem Luna Desktop.

  2. Klonen Sie das Projekt linux-virt-labs GitHub.

    git clone https://github.com/oracle-devrel/linux-virt-labs.git
    
  3. Wechseln Sie in das Arbeitsverzeichnis.

    cd linux-virt-labs/ocne2
    
  4. Installieren Sie die erforderlichen Sammlungen.

    ansible-galaxy collection install -r requirements.yml
    
  5. Stellen Sie die Übungsumgebung bereit.

    ansible-playbook create_instance.yml -e localhost_python_interpreter="/usr/bin/python3.6" -e install_ocne_rpm=true
    

    Die kostenlose Übungsumgebung erfordert die zusätzliche Variable local_python_interpreter, die ansible_python_interpreter für Wiedergaben festlegt, die auf localhost ausgeführt werden. Diese Variable ist erforderlich, da die Umgebung das RPM-Package für das Oracle Cloud Infrastructure-SDK für Python installiert, das sich unter den python3.6-Modulen befindet.

    Die Standard-Deployment-Ausprägung verwendet die AMD-CPU und Oracle Linux 8. Um eine Intel-CPU oder Oracle Linux 9 zu verwenden, fügen Sie dem Deployment-Befehl -e instance_shape="VM.Standard3.Flex" oder -e os_version="9" hinzu.

    Wichtig: Warten Sie, bis die Arbeitsmappe erfolgreich ausgeführt wurde, und erreichen Sie die Aufgabe "Unterbrechen". In dieser Phase des Handbuchs ist die Installation von Oracle CNE abgeschlossen, und die Instanzen sind bereit. Beachten Sie die vorherige Wiedergabe, in der die öffentlichen und privaten IP-Adressen der bereitgestellten Knoten sowie alle anderen Deployment-Informationen gedruckt werden, die während der Ausführung der Übung benötigt werden.

Kubernetes-Cluster starten

Wir verwenden ein einzelnes Control Plane- und Worker-Knotencluster auf Basis von Kubernetes v1.30 mit Plänen für ein Upgrade auf 1.31.

  1. Öffnen Sie ein Terminal, und stellen Sie eine SSH-Verbindung zur OCNE-Instanz her.

    ssh oracle@<ip_address_of_node>
    
  2. Starten Sie das Cluster

    ocne cluster start --version 1.30 -n 1 -w 1 -u false
    
  3. Legen Sie die kubeconfig-Umgebungsvariable für das neue Cluster fest.

    export KUBECONFIG=$(ocne cluster show -C ocne)
    

    Dabei ist ocne der Standardname für ein Cluster, sofern nicht anders angegeben. Anschließend können Sie mit kubectl get nodes die beiden Knoten anzeigen und prüfen, ob sie Version 1.30 ausführen.

Kubernetes aktualisieren

Kubernetes erfordert, dass Sie jeweils eine Version aktualisieren. Wenn Sie also mehr als eine Version upgraden müssen, müssen Sie diese Schritte für jede Version wiederholen.

  1. Stellen Sie die nächste Kubernetes-Version bereit.

    ocne cluster stage -v 1.31
    
  2. Rufen Sie eine Liste der Clusterknoten ab.

    kubectl get nodes
    
  3. Prüfen Sie, ob Updates verfügbar sind.

    watch ocne cluster info
    

    Überwachen Sie, bis Knoten mit verfügbaren Updates: 2 in der Ausgabe angezeigt werden. Geben Sie Ctrl-c ein, um den Überwachungsbefehl zu beenden.

  4. Aktualisieren Sie den Control-Plane-Knoten.

    Sie müssen zuerst alle Control-Plane-Knoten im Cluster aktualisieren.

    ocne node update -N ocne-control-plane-1
    

    Nach Abschluss des Befehls kann die Aktualisierung einige Minuten dauern. Mit kubectl get nodes können Sie die Version des Control-Plane-Knotens prüfen.

  5. Auf dieser Seite aktualisieren Sie den Worker-Knoten.

    ocne node update -N ocne-worker-1 --delete-emptydir-data
    

    Wiederholen Sie den Befehl, wenn Sie eine Warnung erhalten, dass ein Upgrade nicht verfügbar ist oder das Cluster es nicht ausführen kann. Die Stabilisierung dieses kleinen Clusters kann einige Minuten dauern, bevor Sie den Worker-Knoten aktualisieren können.

    Der Worker-Knoten erfordert die Option --delete-emptydir-data, weil der ui-Pod ein emptyDir-Volume verwendet, um Inhalt über seine ausgeführten Container hinweg freizugeben.

  6. Prüfen Sie die Version der Clusterknoten.

    kubectl get nodes
    

    Wiederholen Sie den Befehl, bis die Ausgabe anzeigt, dass jeder Knoten die erwartete Version hat.

Nächste Schritte

Wenn Sie wissen, wie Sie die neueste Kubernetes-Version auf Ihrem Oracle CNE-Cluster bereitstellen, wird sichergestellt, dass Ihr Cluster mit den neuesten Sicherheits- und Stabilitätsfixes auf dem neuesten Stand bleibt.

Weitere Lernressourcen

Sehen Sie sich andere Übungen zu docs.oracle.com/learn an, oder greifen Sie im Oracle Learning YouTube-Channel auf weitere kostenlose Lerninhalte zu. Besuchen Sie außerdem education.oracle.com/learning-explorer, um Oracle Learning Explorer zu werden.

Die Produktdokumentation finden Sie im Oracle Help Center.