Actualización del complemento CoreDNS de Amazon EKS - Amazon EKS

Ayude a mejorar esta página

¿Quiere contribuir a esta guía del usuario? Desplácese hasta el final de esta página y seleccione Editar esta página en GitHub. Sus contribuciones ayudarán a que nuestra guía del usuario sea mejor para todos.

Actualización del complemento CoreDNS de Amazon EKS

Actualice el tipo de Amazon EKS del complemento. Si no ha agregado el complemento de Amazon EKS a su clúster, agréguelo o consulte Actualización del complemento autoadministrado CoreDNS de Amazon EKS.

Antes de comenzar, revise las consideraciones para la actualización. Para obtener más información, consulte Consideraciones importantes sobre la actualización de CoreDNS.

  1. Consulte qué versión del complemento está instalada en el clúster. Reemplace my-cluster por el nombre del clúster.

    aws eks describe-addon --cluster-name my-cluster --addon-name coredns --query "addon.addonVersion" --output text

    Un ejemplo de salida sería el siguiente.

    v1.10.1-eksbuild.13

    Si la versión devuelta es la misma que la versión Kubernetes del clúster en la tabla de versiones más recientes, significa que ya tiene la última versión instalada en el clúster y no necesita completar el resto de este procedimiento. Si recibe un error, en lugar de un número de versión en la salida, significa que no tiene el tipo de versión de Amazon EKS en el clúster. Debe crear el complemento antes de poder actualizarlo mediante este procedimiento.

  2. Guarde la configuración del complemento instalado actualmente.

    kubectl get deployment coredns -n kube-system -o yaml > aws-k8s-coredns-old.yaml

  3. Actualice el complemento con la AWS CLI. Si desea utilizar AWS Management Console o eksctl para actualizar el complemento, consulte Actualización de un complemento de Amazon EKS. Copie el comando que sigue en su dispositivo. Realice las siguientes modificaciones en el comando según sea necesario y, a continuación, ejecute el comando modificado.

    • Reemplace my-cluster por el nombre del clúster.

    • Sustituya v1.11.3-eksbuild.1 por la versión más reciente que aparece en la tabla de versiones más recientes correspondiente a la versión del clúster.

    • La opción CONSERVAR de --resolve-conflicts conserva los valores de configuración existentes del complemento. Si ha establecido valores personalizados para la configuración del complemento y no utiliza esta opción, Amazon EKS sobrescribe los valores con los valores predeterminados. Si utiliza esta opción, le recomendamos que pruebe cualquier cambio de campo y valor en un clúster que no sea de producción antes de actualizar el complemento del clúster de producción. Si cambia este valor a OVERWRITE, todas las configuraciones cambiarán a los valores predeterminados de Amazon EKS. Si ha establecido valores personalizados para cualquier configuración, es posible que se sobrescriban con los valores predeterminados de Amazon EKS. Si cambia este valor a none, Amazon EKS no cambia el valor de ninguna configuración, pero la actualización podría fallar. Si se produce un error en la actualización, recibe un mensaje de error que lo ayuda a resolver el conflicto.

    • Si no va a actualizar un ajuste de configuración, elimine --configuration-values '{"replicaCount":3}' del comando. Si está actualizando una configuración, reemplace "replicaCount":3 por la configuración que desee establecer. En este ejemplo, el número de réplicas de CoreDNS se establece en 3. El valor que especifique debe ser válido para el esquema de configuración. Si no conoce el esquema de configuración, ejecute ‭aws eks describe-addon-configuration --addon-name coredns --addon-version v1.11.3-eksbuild.1‬ y sustituya v1.11.3-eksbuild.1 por el número de versión del complemento cuya configuración desea ver. El esquema se devuelve en la salida. Si ya tiene alguna configuración personalizada, quiere eliminarla por completo y volver a establecer los valores de todos los ajustes a los valores predeterminados de Amazon EKS, elimine "replicaCount":3 del comando para que quede vacío {}. Para obtener más información sobre la configuración de CoreDNS, consulte Personalización del servicio DNS en la documentación de Kubernetes.

      aws eks update-addon --cluster-name my-cluster --addon-name coredns --addon-version v1.11.3-eksbuild.1 \
    --resolve-conflicts PRESERVE --configuration-values '{"replicaCount":3}'

      La actualización puede tardar varios segundos en completarse.

  4. Confirme que la versión del complemento se ha actualizado. Reemplace my-cluster por el nombre del clúster.

    aws eks describe-addon --cluster-name my-cluster --addon-name coredns

    La actualización puede tardar varios segundos en completarse.

    Un ejemplo de salida sería el siguiente.

    {
    "addon": {
        "addonName": "coredns",
        "clusterName": "my-cluster",
        "status": "ACTIVE",
        "addonVersion": "v1.11.3-eksbuild.1",
        "health": {
            "issues": []
        },
        "addonArn": "arn:aws:eks:region:111122223333:addon/my-cluster/coredns/d2c34f06-1111-2222-1eb0-24f64ce37fa4",
        "createdAt": "2023-03-01T16:41:32.442000+00:00",
        "modifiedAt": "2023-03-01T18:16:54.332000+00:00",
        "tags": {},
        "configurationValues": "{\"replicaCount\":3}"
    }
}