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

Compare a versão do Kubernetes do plano de controle de cluster com a versão do Kubernetes dos seus nós.

Antes de atualizar seu 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 Fargate no seu cluster sejam iguais à versão do seu 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 os nós autogerenciados e híbridos para a mesma versão do ambiente de gerenciamento antes de atualizá-lo. Para ter mais informações, consulte Atualizar um grupo de nós gerenciados para seu cluster, Atualizar nós autogerenciados para seu cluster e Atualizar os nós híbridos do cluster. Se você tiver nós do Fargate com uma versão secundária inferior à versão do ambiente de gerenciamento, primeiro exclua o pod que é representado pelo nó. Em seguida, atualize seu ambiente de gerenciamento. Todos os pods restantes serão atualizados para a nova versão depois de reimplantados.

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

Por padrão, o controlador de admissão da política de segurança do pod é habilitado por padrão nos clusters do Amazon EKS. Antes de atualizar o cluster, certifique-se de que as políticas de segurança de pods 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 pods 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 seu cluster era o Kubernetes 1.18 ou posterior, ignore essa etapa.

Talvez seja necessário remover um termo descontinuado do manifesto do 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).

Para Kubernetes version (Versão do Kubernetes), selecione a versão para a qual atualizar seu cluster e escolha Update (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 do Kubernetes do cluster atualizado. Para ter mais informações, consulte Atualizar nós autogerenciados para seu cluster, Atualizar um grupo de nós gerenciados para seu cluster e Atualizar os nós híbridos do cluster. Quaisquer novos pods 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 corresponde à 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 compatíveis com GPU (por exemplo, p3.2xlarge), você deverá atualizar o plug-in de dispositivo NVIDIA para KubernetesDaemonSet 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 o plug-in CNI da Amazon VPC para Kubernetes, o CoreDNS e os complementos 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.