Remarques :

Ce tutoriel est disponible dans un environnement d'atelier gratuit fourni par Oracle.
Il utilise des exemples de valeurs pour les informations d'identification, la location et les compartiments Oracle Cloud Infrastructure. Lorsque vous terminez votre atelier, remplacez ces valeurs par celles propres à votre environnement cloud.

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

Introduction

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

Appliquer les derniers correctifs de sécurité
Stabilité de l'accès et amélioration des performances
Accéder aux nouvelles fonctionnalités, API et nouvelles fonctionnalités

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

Pour plus d'informations sur Oracle CNE, reportez-vous au site actuel de la documentation sur les versions.

Objectifs

Dans ce tutoriel, vous allez apprendre à :

Mettre à niveau la version de Kubernetes déployée dans le cluster

Prérequis

Minimum d'une instance Oracle Linux
Oracle Linux doit être installé et configuré sur chaque système avec :
- Compte utilisateur Oracle (utilisé pendant l'installation) avec accès sudo
- SSH basé sur une clé, également appelé SSH sans mot de passe, entre les hôtes
- Environnement libvirt KVM fonctionnel.

Déploiement d'Oracle Cloud Native Environment

Remarque : en cas d'exécution dans votre propre location, lisez le projet linux-virt-labs GitHub README.md et respectez les prérequis avant de déployer l'environnement d'atelier.

Ouvrez un terminal sur le bureau Luna.

Clonez le projet linux-virt-labs GitHub.

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

Accédez au répertoire de travail.
```
cd linux-virt-labs/ocne2
```

Installez les collections requises.

ansible-galaxy collection install -r requirements.yml

Déployez l'environnement d'exercice.
```
ansible-playbook create_instance.yml -e localhost_python_interpreter="/usr/bin/python3.6" -e install_ocne_rpm=true
```
L'environnement d'exercice 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 le package RPM pour le kit SDK Oracle Cloud Infrastructure pour Python, situé sous les modules python3.6.

La forme de déploiement par défaut utilise la CPU AMD et Oracle Linux 8. Pour utiliser une CPU 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 playbook s'exécute correctement et atteignez la tâche de pause. A ce stade du manuel, l'installation d'Oracle CNE est terminée et les instances sont prêtes. Notez la lecture précédente, qui imprime les adresses IP publiques et privées des noeuds qu'elle déploie, ainsi que toute autre information de déploiement nécessaire lors de l'exécution de l'exercice.

Démarrer un cluster Kubernetes

Nous utiliserons un seul plan de contrôle et cluster de noeuds de processus actif basés sur Kubernetes version 1.30 avec des plans de mise à niveau vers la version 1.31.

Ouvrez un terminal et connectez-vous via SSH à l'instance ocne.
```
ssh oracle@<ip_address_of_node>
```

Démarrez le cluster.

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

Définissez la variable d'environnement kubeconfig pour votre nouveau cluster.
```
export KUBECONFIG=$(ocne cluster show -C ocne)
```
Où ocne est le nom par défaut d'un cluster, 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.

Préparez la prochaine version de Kubernetes.
```
ocne cluster stage -v 1.31
```
Obtenez la liste des noeuds de cluster.
```
kubectl get nodes
```
Vérifiez si des mises à jour sont disponibles.
```
watch ocne cluster info
```
Surveillez jusqu'à ce que les noeuds avec mises à jour disponibles : 2 soient signalés dans la sortie. Entrez Ctrl-c pour quitter la commande de surveillance.
Mettez à jour le noeud du plan de contrôle.

Vous devez d'abord mettre à jour tous les noeuds de plan de contrôle du cluster.
```
ocne node update -N ocne-control-plane-1
```
La mise à jour peut prendre quelques minutes une fois la commande terminée. Vous pouvez utiliser kubectl get nodes pour vérifier la version du noeud de plan de contrôle.
Mettez à jour le noeud de processus actif.
```
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'effectuer. La stabilisation de ce petit cluster peut prendre quelques minutes avant que vous puissiez mettre à jour le noeud de processus actif.

Le noeud de processus actif requiert 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.
Vérifiez la version des noeuds de cluster.
```
kubectl get nodes
```
Répétez la commande jusqu'à ce que la sortie indique que chaque noeud est à la version attendue.

Etapes suivantes

Savoir comment conserver la dernière version de Kubernetes déployée sur votre cluster Oracle CNE garantit que votre cluster reste à jour avec tous les derniers correctifs de sécurité et de stabilité.

Ressources de formation supplémentaires

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

Pour obtenir la documentation produit, consultez le site Oracle Help Center.

Informations relatives au titre et au copyright

Upgrade the Kubernetes Version on Oracle Cloud Native Environment

G32054-01