As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Atualizações de cluster
<a name="cluster-upgrade"></a>

Um cluster *gerenciado por `eksctl`* pode ser atualizado em 3 etapas fáceis:

1. atualize a versão do plano de controle com `eksctl upgrade cluster` 

1. atualizar grupos de nós

1. atualize os complementos de rede padrão (para obter mais informações, consulte[Atualizações de complementos padrão](addon-upgrade.md)):

Analise cuidadosamente os recursos relacionados ao upgrade do cluster:
+  [Atualize o cluster existente para a nova versão do Kubernetes no Guia do](https://docs.aws.amazon.com/eks/latest/userguide/update-cluster.html) usuário do Amazon EKS
+  [Práticas recomendadas para atualizações de clusters](https://docs.aws.amazon.com/eks/latest/best-practices/cluster-upgrades.html) no Guia de melhores práticas do EKS

**nota**  
O antigo `eksctl update cluster` será descontinuado. Use `eksctl upgrade cluster` em vez disso.

## Atualizando a versão do plano de controle
<a name="_updating_control_plane_version"></a>

As atualizações da versão do plano de controle devem ser feitas para uma versão secundária por vez.

Para atualizar o plano de controle para a próxima versão disponível, execute:

```
eksctl upgrade cluster --name=<clusterName>
```

Esse comando não aplicará nenhuma alteração imediatamente. Você precisará executá-lo novamente `--approve` para aplicar as alterações.

A versão de destino para o upgrade do cluster pode ser especificada com o sinalizador CLI:

```
eksctl upgrade cluster --name=<clusterName> --version=1.16
```

ou com o arquivo de configuração

```
cat cluster1.yaml
---
apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig

metadata:
  name: cluster-1
  region: eu-north-1
  version: "1.16"

eksctl upgrade cluster --config-file cluster1.yaml
```

**Atenção**  
Os únicos valores permitidos para os `metadata.version` argumentos `--version` e são a versão atual do cluster ou uma versão superior. Não há suporte para atualizações de mais de uma versão do Kubernetes.