Atualizar um cluster existente para a nova versão do Kubernetes

Compare a versão do Kubernetes do ambiente de gerenciamento do cluster com a versão do Kubernetes dos nós.

Antes de atualizar o ambiente de gerenciamento para uma nova versão do Kubernetes, certifique-se de que a versão secundária do Kubernetes dos nós gerenciados e dos nós do Fargate no cluster sejam iguais à versão do ambiente de gerenciamento. Por exemplo, se o ambiente de gerenciamento estiver executando a versão 1.29 e um dos nós estiver executando a versão 1.28, será necessário atualizar os nós para a versão 1.29 antes de atualizar o ambiente de gerenciamento para 1.30. Também recomendamos que você atualize seus nós autogerenciados para a mesma versão do ambiente de gerenciamento antes de atualizar o ambiente de gerenciamento. Para ter mais informações, consulte Atualizar um grupo de nós gerenciados para seu cluster e Atualizar nós autogerenciados para seu cluster. Se você tiver nós do Fargate com uma versão secundária inferior à versão do ambiente de gerenciamento, primeiramente exclua o Pod que é representado pelo nó. Em seguida, atualize seu ambiente de gerenciamento. Todos os demais Pods serão atualizados para a nova versão depois de reimplantados.

Se a versão do Kubernetes com a qual você implantou originalmente o cluster foi a versão 1.25 ou posterior do Kubernetes, pule essa etapa.

Por padrão, o controlador de admissão de política de segurança de Pod é habilitado nos clusters do Amazon EKS. Antes de atualizar o cluster, certifique-se de que as políticas de segurança de Pod adequadas estejam em vigor. Isso acontece para evitar possíveis problemas de segurança. Você pode verificar a política padrão com o comando kubectl get psp eks.privileged.

kubectl get psp eks.privileged

Se receber o seguinte erro, consulte Política de segurança de Pod padrão do Amazon EKS antes de prosseguir.

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

Se a versão do Kubernetes com a qual você implantou originalmente o cluster foi a versão 1.18 ou posterior do Kubernetes, pule essa etapa.

Talvez seja necessário remover um termo descontinuado do seu manifesto CoreDNS.

Abra o console do Amazon EKS.

Escolha o nome do cluster do Amazon EKS a ser atualizado e selecione Update cluster version (Atualizar versão do cluster).

Em Versão do Kubernetes, selecione a versão para a qual o cluster será atualizado e escolha Atualizar.

Em Cluster name (Nome do cluster), insira o nome do seu cluster e escolha Confirm (Confirmar).

O processo pode demorar alguns minutos para ser concluído.

Avance para Etapa 4: atualizar componentes do cluster

Atualize seu cluster do Amazon EKS com o seguinte comando da AWS CLI. Substitua os valores de exemplo pelos seus próprios. Substitua 1.30 pelo número da versão compatível com o Amazon EKS para a qual você deseja atualizar o cluster. Para obter a lista completa dos números das versões compatíveis, consulte Compreender o ciclo de vida da versão do Kubernetes no EKS.

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

Veja um exemplo de saída abaixo.

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

Monitore o status do cluster com o comando a seguir. Use o nome do cluster e o ID da atualização que o comando anterior retornou. Quando um status de Successful for exibido, significa que a atualização está concluída. O processo pode demorar alguns minutos para ser concluído.

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

Veja um exemplo de saída abaixo.

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

Avance para Etapa 4: atualizar componentes do cluster

Depois que a atualização do cluster for concluída, atualize os nós para a mesma versão secundária que a do Kubernetes do cluster atualizado. Para ter mais informações, consulte Atualizar nós autogerenciados para seu cluster e Atualizar um grupo de nós gerenciados para seu cluster. Todos os Pods novos iniciados no Fargate têm uma versão do kubelet que corresponde à versão do cluster. Os Pods existentes do Fargate não são alterados.

(Opcional) Se você implantou o Kubernetes Cluster Autoscaler no cluster antes de atualizá-lo, atualize o Cluster Autoscaler para a versão mais recente que corresponda à versão principal e secundária do Kubernetes para a qual você atualizou.

(Somente clusters com nós de GPU) Se o cluster tiver grupos de nós com suporte para GPU (por exemplo, p3.2xlarge), você deverá atualizar o plug-in de dispositivo NVIDIA para Kubernetes DaemonSet no seu cluster. Substitua vX.X.X pela versão desejada do NVIDIA/k8s-device-plugin antes de executar o seguinte comando.

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

Atualize os complementos Amazon VPC CNI plugin for Kubernetes, CoreDNS e kube-proxy. Recomendamos atualizar os complementos para as versões mínimas listadas nos tokens da conta de serviço.

Se necessário, atualize a versão do kubectl. Você deve usar uma versão do kubectl que esteja em uma versão secundária de diferença do plano de controle do cluster do Amazon EKS. Por exemplo, um cliente do kubectl 1.29 funciona com clusters do Kubernetes 1.28, 1.29 e 1.30. É possível verificar a versão instalada atualmente com o comando a seguir.

kubectl version --client