Actualización del clúster existente a la nueva versión de Kubernetes

Para actualizar la versión de Kubernetes del clúster

1. Compare la versión de Kubernetes de su plano de control de clúster con la versión de Kubernetes de sus nodos.

   • Obtenga la versión de Kubernetes del plano de control de clúster.

     kubectl version
     

   • Obtenga la versión de Kubernetes de sus nodos. Este comando devuelve todos los nodos autoadministrados y administrados de Amazon EC2 y Fargate. Cada Pod de Fargate aparece como su propio nodo.

     kubectl get nodes
     

   Antes de actualizar un plano de control a una nueva versión de Kubernetes, asegúrese de que la versión secundaria de Kubernetes de ambos nodos administrados y de Fargate en el clúster debe ser la misma que la de la versión actual del plano de control. Por ejemplo, si el plano de control se ejecuta con la versión 1.30 y uno de los nodos con la versión 1.29, debe actualizar los nodos a la versión 1.30 antes de actualizar el plano de control a la 1.31. También recomendamos que actualice los nodos autoadministrados a la misma versión que el plano de control antes de actualizar el plano de control. Para obtener más información, consulte Actualización de un grupo de nodos administrados para un clúster y Actualización de los nodos autoadministrados para un clúster. Si tiene nodos de Fargate con una versión secundaria inferior a la versión del plano de control, elimine primero el Pod que representa el nodo. Luego, actualice su plano de control. Los Pods restantes se actualizarán a la nueva versión después de volver a implementarlos.

2. Si la versión de Kubernetes con la que implementó originalmente el clúster era Kubernetes 1.25 o posterior, omita este paso.

   De manera predeterminada, el controlador de admisión de la política de seguridad del Pod se encuentra habilitado en clústeres de Amazon EKS. Antes de actualizar el clúster, asegúrese de que las políticas de seguridad del Pod adecuadas estén implementadas. Esto ocurre para evitar posibles problemas de seguridad. Puede consultar la política predeterminada con el comando kubectl get psp eks.privileged.

   kubectl get psp eks.privileged
   

   Si recibe el siguiente error, consulte Política de seguridad predeterminada del Pod de Amazon EKS antes de continuar.

   Error from server (NotFound): podsecuritypolicies.extensions "eks.privileged" not found

3. Si la versión de Kubernetes con la que implementó originalmente el clúster era Kubernetes 1.18 o posterior, omita este paso.

   Es posible que deba eliminar un término interrumpido de su manifiesto de CoreDNS.

   1. Verifique si su manifiesto CoreDNS cuenta con una línea que solo tiene la palabra upstream.

      kubectl get configmap coredns -n kube-system -o jsonpath='{$.data.Corefile}' | grep upstream
      

      Si no se devuelve un resultado, significa que el manifiesto no cuenta con la línea. En tal caso, continúe en el paso siguiente Si se devuelve la palabra upstream, elimine la línea.

   2. Elimine la línea que está cerca de la parte superior del archivo que solo tiene la palabra upstream en el archivo de configmap. No cambie nada más en el archivo. Después de eliminar la línea, guarde los cambios.

      kubectl edit configmap coredns -n kube-system -o yaml
      

4. Actualice el clúster mediante eksctl, la AWS Management Console o la AWS CLI.

   importante

   • Si va a actualizar a la versión 1.23 y usar volúmenes de Amazon EBS en el clúster, debe instalar el controlador CSI de Amazon EBS en el clúster antes de actualizar el clúster a la versión 1.23 para evitar interrupciones en la carga de trabajo. Para obtener más información, consulte Kubernetes 1.23 y Almacenamiento de volúmenes de Kubernetes con Amazon EBS.

   • Kubernetes 1.24 y versiones posteriores utilizan containerd como el tiempo de ejecución predeterminado del contenedor. Si va a cambiar al tiempo de ejecución de containerd y ya ha configurado Fluentd para Container Insights, debe migrar Fluentd a Fluent Bit antes de actualizar el clúster. Los analizadores de Fluentd están configurados para analizar únicamente los mensajes de registro en formato JSON. A diferencia de dockerd, el tiempo de ejecución del contenedor containerdcontiene mensajes de registro que no están en formato JSON. Si no migra a Fluent Bit, algunos de los analizadores de Fluentd's configurados generarán una enorme cantidad de errores dentro del contenedor de Fluentd. por el número de versión compatible con Amazon EKS al que desea actualizar su clústerPara enviar registros a CloudWatch Logs, consulte Configurar Fluent Bit como DaemonSet para enviar registros a CloudWatch Logs.

   • Puesto que Amazon EKS ejecuta un plano de control de alta disponibilidad, puede actualizar solo una versión secundaria a la vez. Para obtener más información acerca de este requisito, consulte Política de compatibilidad de versiones y diferencia de versiones de Kubernetes. Supongamos que la versión del clúster actual es la 1.29 y quiere actualizarla a la 1.31. Primero debe actualizar su clúster de versión 1.29 a la versión 1.30 y, a continuación, actualizar su clúster de versión 1.30 a la versión 1.31.

   • Revise la compatibilidad de versiones entre kube-apiserver de Kubernetes y kubelet en sus nodos.

     • A partir de la versión de Kubernetes 1.28, en kubelet puede haber hasta tres versiones secundarias anteriores a kube-apiserver. Consulte Política de compatibilidad de escalado entre versiones de Kubernetes.

     • Si el kubelet de sus nodos administrados y de Fargate corresponde a la versión de Kubernetes 1.25 o una más reciente, puede actualizar su clúster hasta tres versiones más avanzadas sin necesidad de actualizar la versión de kubelet. Por ejemplo, si kubelet está en la versión 1.25, puede actualizar la versión del clúster de Amazon EKS de 1.25 a 1.26 a 1.27 y a 1.28, mientras que kubelet permanezca en la versión 1.25.

     • Si el kubelet de sus nodos administrados y de Fargate está en la versión de Kubernetes 1.24 o anterior, es posible que solo haya hasta dos versiones secundarias anteriores a kube-apiserver. En otras palabras, si kubelet es versión 1.24 o anterior, solo puede actualizar el clúster hasta dos versiones más avanzadas. Por ejemplo, si kubelet está en la versión 1.21, puede actualizar la versión del clúster de Amazon EKS de 1.21 a 1.22 y a 1.23, pero no podrá actualizar el clúster a 1.24 mientras kubelet permanezca en 1.21.

   • Como práctica recomendada antes de iniciar una actualización, asegúrese de que el kubelet de sus nodos esté en la misma versión de Kubernetes que la de su plano de control.

   • Si el clúster está configurado con una versión de Amazon VPC CNI plugin for Kubernetes anterior a 1.8.0, le recomendamos actualizar el complemento a la versión más reciente antes de actualizar el clúster. Para actualizar el complemento, consulte Asignación de direcciones IP a Pods con CNI de Amazon VPC.

   • Si está actualizando el clúster a una versión 1.25 o posterior y ha implementado AWS Load Balancer Controller en el clúster, actualice el controlador a la versión 2.4.7 o posterior antes de actualizar la versión del clúster a 1.25. Para obtener más información, consulte las notas de la versión Kubernetes 1.25.

   eksctl

   En este procedimiento, se requiere la versión 0.191.0 o posterior de eksctl. Puede verificar la versión con el siguiente comando:

   eksctl version
   

   Para obtener instrucciones sobre cómo instalar y actualizar eksctl, consulte Instalación en la documentación de eksctl.

   Actualice la versión de Kubernetes de su plano de control de Amazon EKS. Reemplace my-cluster por el nombre del clúster. Reemplace 1.31 por el número de versión compatible con Amazon EKS al que desea actualizar el clúster. Para ver una lista de los números de versiones compatibles, consulte Descripción del ciclo de vida de las versiones de Kubernetes en EKS.

   eksctl upgrade cluster --name my-cluster --version 1.31 --approve
   

   La actualización puede tardar varios minutos en completarse.

   AWS Management Console

   1. Abra la consola de Amazon EKS en https://console.aws.amazon.com/eks/home#/clusters.

   2. Elija el nombre del clúster de Amazon EKS que desea actualizar y elija Actualizar versión del clúster.

   3. En Versión de Kubernetes, seleccione la versión a la que desea actualizar el clúster y elija Actualizar.

   4. En Nombre del clúster, escriba el nombre del clúster y seleccione Confirmar.

      La actualización puede tardar varios minutos en completarse.

   AWS CLI

   1. Actualice el clúster de Amazon EKS con el siguiente comando de la AWS CLI. Reemplace los example values por los de su propiedad. Reemplace 1.31 por el número de versión compatible con Amazon EKS al que desea actualizar el clúster. Para ver una lista de los números de versiones compatibles, consulte Descripción del ciclo de vida de las versiones de Kubernetes en EKS.

      aws eks update-cluster-version --region region-code --name my-cluster --kubernetes-version 1.31
      

      Un ejemplo de salida sería el siguiente.

      {
          "update": {
              "id": "b5f0ba18-9a87-4450-b5a0-825e6e84496f",
              "status": "InProgress",
              "type": "VersionUpdate",
              "params": [
                  {
                      "type": "Version",
                      "value": "1.31"
                  },
                  {
                      "type": "PlatformVersion",
                      "value": "eks.1"
                  }
              ],
      [...]
              "errors": []
          }
      }

   2. Monitoree el estado de la actualización del clúster con el siguiente comando. Utilice el nombre del clúster e ID de actualización devueltos por el comando anterior. Cuando se muestra el estado Successful, la actualización se ha completado. La actualización puede tardar varios minutos en completarse.

      aws eks describe-update --region region-code --name my-cluster --update-id b5f0ba18-9a87-4450-b5a0-825e6e84496f
      

      Un ejemplo de salida sería el siguiente.

      {
          "update": {
              "id": "b5f0ba18-9a87-4450-b5a0-825e6e84496f",
              "status": "Successful",
              "type": "VersionUpdate",
              "params": [
                  {
                      "type": "Version",
                      "value": "1.31"
                  },
                  {
                      "type": "PlatformVersion",
                      "value": "eks.1"
                  }
              ],
      [...]
              "errors": []
          }
      }

5. Una vez que se complete la actualización del clúster, actualice los nodos a la misma versión secundaria de Kubernetes de su clúster actualizado. Para obtener más información, consulte Actualización de los nodos autoadministrados para un clúster y Actualización de un grupo de nodos administrados para un clúster. Los Pods nuevos que se lancen en Fargate tienen una versión de kubelet que coinciden con la versión del clúster. Los Pods de Fargate existentes no cambian.

6. (Opcional) Si implementó el Escalador automático de clústeres de Kubernetes en el clúster antes de actualizar este último, actualice dicho Escalador automático de clústeres a la versión más reciente que coincida con la versión principal y secundaria de Kubernetes a las que actualizó.

   1. Abra la página de versiones del Escalador automático de clústeres en un navegador web y busque la versión más reciente del escalador automático del clúster que coincida con la versión principal y secundaria de Kubernetes de su clúster. Por ejemplo, si la versión de Kubernetes del clúster es 1.31, busque la última versión del Escalador automático de clústeres que comience por 1.31. Registre el número de versión semántica (1.31.n, por ejemplo) de esa versión para usarlo en el siguiente paso.

   2. Establezca la etiqueta de la imagen del Escalador automático de clústeres en la versión que ha registrado en el paso anterior con el siguiente comando. Si es necesario, reemplace 1.31.n por su propio valor.

      kubectl -n kube-system set image deployment.apps/cluster-autoscaler cluster-autoscaler=registry.k8s.io/autoscaling/cluster-autoscaler:v1.31.n
      

7. (Solo para clústeres con nodos de GPU) Si el clúster tiene grupos de nodos compatibles con GPU (por ejemplo, p3.2xlarge), debe actualizar el complemento del dispositivo NVIDIA para Kubernetes DaemonSet de su clúster. Reemplace vX.X.X con la versión Plugin de dispositivo NVidia/K8S deseada antes de ejecutar el siguiente comando.

   kubectl apply -f https://raw.githubusercontent.com/NVIDIA/k8s-device-plugin/vX.X.X/deployments/static/nvidia-device-plugin.yml
   

8. Actualice los complementos Amazon VPC CNI plugin for Kubernetes, CoreDNS y kube-proxy. Recomendamos actualizar los complementos a las versiones mínimas que figuran en los tokens de las cuentas de servicio.

   • Si está usando complementos de Amazon EKS, seleccione Clústeres en la consola de Amazon EKS y, a continuación, seleccione el nombre del clúster que actualizó en el panel de navegación izquierdo. Las notificaciones aparecen en la consola. Le informan que hay una versión nueva disponible para cada complemento que tenga una actualización disponible. Para actualizar un complemento, seleccione la pestaña Complementos. En uno de los cuadros de un complemento que tenga una actualización disponible, seleccione Actualizar ahora, seleccione una versión disponible y, a continuación, seleccione Actualizar.

   • Como alternativa, puede utilizar la AWS CLI o eksctl para actualizar los complementos. Para obtener más información, consulte Actualización de un complemento de Amazon EKS.

9. De ser necesario, actualice su versión de kubectl. Debe utilizar una versión de kubectl con una diferencia de versión de menos de un número que el plano del control del clúster de Amazon EKS. Por ejemplo, un cliente de kubectl 1.30 trabaja con los clústeres Kubernetes, 1.29, 1.30 y 1.31. Puede comprobar su versión instalada actualmente con el siguiente comando.

   kubectl version --client