Note :

Mettez à niveau la version de Kubernetes sur Oracle Cloud Native Environment

Présentation

Les meilleures pratiques recommandent de mettre à niveau votre grappe Kubernetes dès que possible après une nouvelle version. Les raisons de la mise à niveau le plus rapidement possible sont les suivantes :

Ce tutoriel explique comment mettre à niveau la version de Kubernetes utilisée sur votre grappe Oracle CNE.

Pour plus d'informations sur Oracle CNE, consultez la documentation de version actuelle.

Objectifs

Dans ce tutoriel, vous apprendrez à :

Préalables

Déployer l'environnement natif Oracle Cloud

Note : Si vous exécutez votre propre location, lisez les préalables du projet linux-virt-labs GitHub README.md et remplissez les conditions requises avant de déployer l'environnement de laboratoire.

  1. Ouvrez un terminal sur le Luna Desktop.

  2. Clonez le projet linux-virt-labs GitHub.

    git clone https://github.com/oracle-devrel/linux-virt-labs.git

  3. Accédez au répertoire de travail.

    cd linux-virt-labs/ocne2

  4. Installez les collections requises.

    ansible-galaxy collection install -r requirements.yml

  5. Déployez l'environnement de l'exercice.

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

    L'environnement de laboratoire gratuit nécessite la variable supplémentaire local_python_interpreter, qui définit ansible_python_interpreter pour les lectures exécutées sur localhost. Cette variable est nécessaire car l'environnement installe l'ensemble RPM pour la trousse SDK Oracle Cloud Infrastructure pour Python, située sous les modules python3.6.

    La forme de déploiement par défaut utilise le processeur AMD et Oracle Linux 8. Pour utiliser une unité centrale Intel ou Oracle Linux 9, ajoutez -e instance_shape="VM.Standard3.Flex" ou -e os_version="9" à la commande de déploiement.

    Important : Attendez que le livre de jeu s'exécute avec succès et atteignez la tâche Mettre en pause. À ce stade du livre de jeux, l'installation d'Oracle CNE est terminée et les instances sont prêtes. Prenez note de la lecture précédente, qui imprime les adresses IP publiques et privées des noeuds qu'il déploie et toutes les autres informations de déploiement nécessaires lors de l'exécution de l'exercice.

Démarrer une grappe Kubernetes

Nous utiliserons un plan de contrôle unique et une grappe de noeuds de travail basés sur Kubernetes v1.30 avec des plans de mise à niveau vers la version 1.31.

  1. Ouvrez un terminal et connectez-vous via SSH à l'instance ocne.

    ssh oracle@<ip_address_of_node>

  2. Démarrez la grappe.

    ocne cluster start --version 1.30 -n 1 -w 1 -u false

  3. Définissez la variable d'environnement kubeconfig pour votre nouvelle grappe.

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

    Où ocne est le nom par défaut d'une grappe, sauf indication contraire. Vous pouvez ensuite utiliser kubectl get nodes pour afficher les deux noeuds et vérifier qu'ils exécutent la version 1.30.

Mettre à jour Kubernetes

Kubernetes exige que vous mettiez à jour une version à la fois. Par conséquent, si vous devez mettre à niveau plusieurs versions, vous devrez répéter ces étapes pour chaque version.

  1. Mettez en scène la prochaine version de Kubernetes.

    ocne cluster stage -v 1.31

  2. Obtenir la liste des noeuds de la grappe.

    kubectl get nodes

  3. Vérifiez si des mises à jour sont disponibles.

    watch ocne cluster info

    Surveillez jusqu'à ce que des noeuds avec des mises à jour disponibles : 2 soient signalés dans la sortie. Entrez Ctrl-c pour quitter la commande watch.

  4. Mettez à jour le noeud de plan de contrôle.

    Vous devez d'abord mettre à jour tous les noeuds de plan de contrôle dans la grappe.

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

    La mise à jour peut prendre quelques minutes après la fin de la commande. Vous pouvez utiliser kubectl get nodes pour vérifier la version du noeud de plan de contrôle.

  5. Mettez à jour le noeud de travail.

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

    Répétez la commande si vous recevez un avertissement indiquant qu'une mise à niveau n'est pas disponible ou que le cluster ne peut pas l'exécuter. La stabilisation de cette petite grappe peut prendre quelques minutes avant la mise à jour du noeud de travail.

    Le noeud de travail nécessite l'option --delete-emptydir-data, car le pod ui utilise un volume emptyDir pour partager du contenu entre ses conteneurs en cours d'exécution.

  6. Vérifiez la version des noeuds de la grappe.

    kubectl get nodes

    Répétez la commande jusqu'à ce que la sortie indique que chaque noeud est à la version attendue.

Étapes suivantes

Le fait de savoir comment conserver la dernière version de Kubernetes déployée sur votre grappe Oracle CNE permet à votre grappe de rester à jour avec tous les derniers correctifs de sécurité et de stabilité.

Autres ressources d'apprentissage

Explorez d'autres laboratoires sur le site docs.oracle.com/learn ou accédez à plus de contenu d'apprentissage gratuit sur le canal Oracle Learning YouTube. De plus, visitez education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour obtenir la documentation sur le produit, visitez Oracle Help Center.