¿Cómo actualizo los complementos de Amazon EKS?

Solución

Nota: Si se muestran errores al ejecutar comandos de la Interfaz de la línea de comandos de AWS (AWS CLI), consulta Solución de problemas de AWS CLI. Además, asegúrate de utilizar la versión más reciente de la AWS CLI.

Comprobar las versiones complementarias que se pueden usar

Para identificar las versiones de los complementos que puedes usar para tu versión de clúster de Amazon EKS, ejecuta el siguiente comando describe-addon-versions de la AWS CLI:

aws eks describe-addon-versions --kubernetes-version=cluster-version --addon-name=addon-name --query='addons[].addonVersions[].addonVersion'

Nota: Sustituye cluster-version por la versión de Kubernetes de tu clúster de Amazon EKS. Además, sustituye addon-name por el nombre del complemento, como vpc-cni o coredns.

Actualización de los complementos

Si los complementos tienen configuraciones o recursos personalizados que difieren de los valores predeterminados, es posible que surjan conflictos al actualizar. Para resolver estos problemas, utiliza la AWS CLI y la opción --resolve-conflicts para actualizar los complementos. Se recomienda probar el proceso de actualización en un entorno que no sea de producción antes de aplicarlo al clúster de producción. Para obtener más información, consulta ¿Cómo evito los conflictos de configuración al crear o actualizar mis complementos administrados de Amazon EKS?

Para actualizar los complementos, utiliza eksctl, la consola de Amazon EKS o la AWS CLI.

Comprobación de la actualización

Usa el comando kubectl para comprobar el estado de los despliegues de complementos y asegúrate de que los pods ejecuten la nueva versión. Para los complementos de daemonset, como vpc-cni y kube-proxy, comprueba si el número de réplicas es igual al número de nodos. Los complementos vpc-cni and kube-proxy no se ejecutan en los nodos de AWS Fargate o Windows.

Por ejemplo, ejecuta el siguiente comando para comprobar la versión actual del despliegue de CoreDNS:

kubectl describe deployment coredns -n kube-system | grep Image | cut -d ":" -f 3

O bien, sigue estos pasos para comprobar los detalles del complemento en la consola de Amazon EKS:

1. Abre la consola de Amazon EKS.
2. En el panel de navegación, selecciona Clústeres.
3. Selecciona tu clúster.
4. Selecciona la pestaña Complementos.
5. Para ver la nueva versión, comprueba el valor de la columna Versión del complemento.

Para comprobar los errores o problemas que se han producido durante el proceso de actualización en los registros de los pods de complementos, ejecuta el siguiente comando:

kubectl logs -n kube-system -l k8s-app=kube-dns

Ejecución de pruebas adicionales

Para determinar si el complemento requiere pruebas adicionales después de una actualización, consulta la documentación de los complementos para conocer las prácticas recomendadas. También se recomienda probar los complementos que administran los servicios principales, como las redes o la resolución de DNS. Si has agregado configuraciones personalizadas a tu complemento, asegúrate de que la configuración siga funcionando según lo esperado después de la actualización.

Para probar el complemento de interfaz de red de contenedor (CNI) de Amazon Virtual Private Cloud (Amazon VPC), crea un nuevo pod para validar la asignación de direcciones IP. Para el complemento CoreDNS, utiliza el comando exec para acceder al pod y, a continuación, utiliza herramientas como nslookup para validar la resolución de DNS.

Información relacionada

Actualización del complemento autoadministrado de CoreDNS para Amazon EKS

Actualización del CNI de Amazon VPC (complemento de Amazon EKS)

Administración de CoreDNS para DNS en clústeres de Amazon EKS