Note:

Este tutorial está disponible en un entorno de prácticas gratuito proporcionado por Oracle.
Utiliza valores de ejemplo para credenciales, arrendamiento y compartimentos de Oracle Cloud Infrastructure. Al finalizar la práctica, sustituya estos valores por otros específicos de su entorno en la nube.

Actualización de la versión de Kubernetes en Oracle Cloud Native Environment

Introducción

Las mejores prácticas recomiendan actualizar el cluster de Kubernetes lo antes posible después de una nueva versión. Las razones para actualizar lo más rápido posible incluyen:

Aplique las últimas correcciones de seguridad
Mejoras en la estabilidad y el rendimiento del acceso
Acceder a nuevas funciones, API y funcionalidad

En este tutorial se muestra cómo actualizar la versión de Kubernetes utilizada en el cluster de CNE de Oracle.

Para obtener más información sobre Oracle CNE, consulte el sitio actual de documentación de la versión.

Objetivos

En este tutorial, aprenderá a:

Actualizar la versión de Kubernetes desplegada en el cluster

Requisitos

Mínimo de una instancia de Oracle Linux
Cada sistema debe tener Oracle Linux instalado y configurado con:
- Cuenta de usuario de Oracle (utilizada durante la instalación) con acceso sudo
- SSH basado en claves, también conocido como SSH sin contraseña, entre los hosts
- Un entorno libvirt de KVM en funcionamiento.

Despliegue de Oracle Cloud Native Environment

Nota: Si se ejecuta en su propio arrendamiento, lea el proyecto linux-virt-labs GitHub README.md y complete los requisitos antes de desplegar el entorno de prácticas.

Abra un terminal en el escritorio Luna.

Clone el proyecto linux-virt-labs GitHub.

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

Cambie al directorio de trabajo.
```
cd linux-virt-labs/ocne2
```

Instale las recopilaciones necesarias.

ansible-galaxy collection install -r requirements.yml

Despliegue el entorno de prácticas.
```
ansible-playbook create_instance.yml -e localhost_python_interpreter="/usr/bin/python3.6" -e install_ocne_rpm=true
```
El entorno de prácticas gratuito necesita la variable adicional local_python_interpreter, que define ansible_python_interpreter para las reproducciones que se ejecutan en localhost. Esta variable es necesaria porque el entorno instala el paquete de RPM para el SDK para Python de Oracle Cloud Infrastructure, ubicado en los módulos python3.6.

La unidad de despliegue por defecto utiliza la CPU AMD y Oracle Linux 8. Para utilizar una CPU de Intel u Oracle Linux 9, agregue -e instance_shape="VM.Standard3.Flex" o -e os_version="9" al comando de despliegue.

Importante: Espere a que el cuaderno de estrategias se ejecute correctamente y alcance la tarea de pausa. En esta etapa del manual, la instalación de Oracle CNE está completa y las instancias están listas. Tome nota de la reproducción anterior, que imprime las direcciones IP públicas y privadas de los nodos que despliega y cualquier otra información de despliegue necesaria durante la ejecución del laboratorio.

Inicio de un cluster de Kubernetes

Utilizaremos un único plano de control y cluster de nodos de trabajador basado en Kubernetes v1.30 con planes de actualización a la versión 1.31.

Abra un terminal y conéctese mediante SSH a la instancia de ocne.
```
ssh oracle@<ip_address_of_node>
```

Iniciar el cluster.

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

Defina la variable de entorno kubeconfig para el nuevo cluster.
```
export KUBECONFIG=$(ocne cluster show -C ocne)
```
Donde ocne es el nombre por defecto de un cluster, a menos que se especifique. A continuación, puede utilizar kubectl get nodes para mostrar los dos nodos y verificar que se están ejecutando en la versión 1.30.

Actualizar Kubernetes

Kubernetes requiere que actualices una versión a la vez, por lo que si necesitas actualizar más de una versión, tendrás que repetir estos pasos para cada versión.

Ubique temporalmente la siguiente versión de Kubernetes.
```
ocne cluster stage -v 1.31
```
Obtenga una lista de sus nodos de cluster.
```
kubectl get nodes
```
Compruebe si hay actualizaciones disponibles.
```
watch ocne cluster info
```
Supervise hasta que vea nodos con actualizaciones disponibles: 2 informados en la salida. Introduzca Ctrl-c para salir del comando watch.
Actualice el nodo de plano de control.

Primero debe actualizar todos los nodos de plano de control del cluster.
```
ocne node update -N ocne-control-plane-1
```
La actualización puede tardar unos minutos en completarse después de que finalice el comando. Puede utilizar kubectl get nodes para comprobar la versión del nodo de plano de control.
Actualice el nodo de trabajador.
```
ocne node update -N ocne-worker-1 --delete-emptydir-data
```
Repita el comando si recibe una advertencia de que una actualización no está disponible o el cluster no puede realizarla. Este pequeño cluster puede tardar unos minutos en estabilizarse antes de poder actualizar el nodo de trabajador.

El nodo de trabajador necesita la opción --delete-emptydir-data porque el pod ui utiliza un volumen emptyDir para compartir contenido en sus contenedores en ejecución.
Verifique la versión de los nodos del cluster.
```
kubectl get nodes
```
Repita el comando hasta que la salida muestre que cada nodo tiene la versión esperada.

Pasos Siguientes

Saber cómo mantener la última versión de Kubernetes desplegada en el cluster de CNE de Oracle garantiza que el cluster se mantenga actualizado con todas las últimas correcciones de seguridad y estabilidad.

Más recursos de aprendizaje

Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de formación gratuita en el canal YouTube de Oracle Learning. Además, visite education.oracle.com/learning-explorer para convertirse en un explorador de Oracle Learning.

Para obtener documentación sobre el producto, visite Oracle Help Center.

Título e Información de Copyright

Upgrade the Kubernetes Version on Oracle Cloud Native Environment

G32052-01