Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Manually upgrade an ACK cluster

Última atualização: Jun 27, 2026

Para mitigar riscos de segurança e estabilidade associados a versões desatualizadas, atualize seu cluster prontamente. A atualização de um cluster envolve a atualização do plano de controle e dos node pools.

Importante

Antes de atualizar o cluster, revise Atualizar um cluster para compreender o processo, os métodos e as considerações importantes.

Ponto de entrada da operação

Primeiro, atualize o plano de controle. Em seguida, atualize os node pools. Antes de atualizar o plano de controle, garanta que as versões do kubelet e do runtime de contêiner nos nós correspondam à versão do plano de controle. Isso evita falhas na atualização ou interrupções de serviço. Por exemplo, se o plano de controle estiver na versão 1.32 e os nós na versão 1.31, atualize os nós para a versão 1.32 antes de atualizar o plano de controle para 1.33.

  1. Faça login no ACK console. No painel de navegação à esquerda, clique em Clusters.

  2. Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Operations > Upgrade Cluster.

  3. Na página Upgrade Cluster, selecione uma Destination Version disponível e siga as instruções na tela para concluir o processo.

Atualizar o plano de controle

1. Verificação prévia

A verificação prévia da atualização do plano de controle examina APIs obsoletas, compatibilidade de componentes e o status geral do cluster.

Para clusters que executam a versão 1.20 ou posterior, a verificação prévia busca APIs obsoletas . Os resultados da verificação não afetam o processo de atualização e servem apenas para notificação. Resolva quaisquer problemas antes da atualização para garantir que a nova versão do cluster opere conforme o esperado.

Na página Upgrade Cluster, clique em Precheck para identificar possíveis riscos antes da atualização. Após a conclusão da verificação, visualize os resultados na seção Pre-check Results. A figura a seguir mostra um exemplo.

image

  • Normal: A verificação de atualização foi bem-sucedida. Prossiga com a atualização.

  • Anormal: O resultado não afeta a operação ou o status atual do cluster. Corrija os problemas com base nas soluções fornecidas. Para mais informações, consulte Itens de verificação do cluster e soluções.

2. Executar a atualização

Duração: Para clusters gerenciados ACK e clusters serverless ACK, o ACK gerencia a atualização, que leva aproximadamente 5 minutos. Para clusters dedicados ACK, os nós mestres são atualizados sequencialmente, um por um. Cada nó leva cerca de 8 minutos.

Após resolver os problemas da verificação prévia, clique em Upgrade e siga as instruções na tela para atualizar o plano de controle.

Depois que o plano de controle for atualizado, a versão dos novos nós de expansão também se alinhará com a versão do plano de controle.

image

3. Validação pós-atualização

Após a atualização do plano de controle, verifique os seguintes itens:

对 O plano de controle foi atualizado com sucesso. A versão do cluster está atualizada na página Clusters.

对 O API Server e os componentes principais estão em estado Normal.

对 As aplicações de negócio operam conforme o esperado.

对 É possível criar Pods normalmente.

对 É possível adicionar nós normalmente.

Atualizar um node pool

Após atualizar o plano de controle, atualize o node pool o mais rápido possível durante horários de baixa demanda. A atualização do node pool envolve a atualização do kubelet e do runtime de contêiner nos nós.

1. Verificação prévia

A verificação prévia da atualização do node pool examina o status dos nós, recursos do sistema, status dos discos e o ambiente de rede.

Na página Node Pool Upgrade, localize o node pool de destino na lista e clique em Upgrade na coluna Actions. Em seguida, na parte inferior da página, clique em Precheck para identificar possíveis riscos durante o processo de atualização. Após a conclusão da verificação, visualize os resultados na seção Pre-check Results.

image

  • Normal: A verificação de atualização foi bem-sucedida. Prossiga com a atualização.

  • Anormal: O resultado não afeta a operação ou o status atual do cluster. Corrija os problemas com base nas instruções do console e em Itens de verificação do cluster e soluções.

2. Configurar uma política de atualização e executar a atualização

Duração: A duração depende do agrupamento dos nós em lotes. Uma atualização in-place leva aproximadamente de 5 a 10 minutos por lote. Uma atualização por substituição de disco sem snapshots leva cerca de 8 minutos. O tempo específico varia conforme a drenagem do nó. Se optar por criar snapshots, a atualização começará após a criação deles. O tempo necessário para criar snapshots varia conforme o volume de dados.

Configure uma política de atualização conforme descrito na tabela a seguir. Em seguida, clique em Upgrade e siga as instruções na tela para atualizar o node pool.

Item de configuração

Descrição

Informações da versão

As versões atuais e disponíveis do kubelet e do runtime de contêiner.

Update Nodes

Atualize todos os nós de uma vez ou atualize alguns nós primeiro e, após confirmar que tudo está normal, atualize o restante.

Método de atualização

  • In-place Upgrade: Os componentes necessários são atualizados e substituídos diretamente no nó original. O disco do sistema não é substituído e o nó não é reinicializado. Os dados no nó original permanecem intactos.

  • Upgrade by Replacing System Disk: O nó é reinicializado mediante a substituição do disco do sistema. As propriedades da instância do nó, como nome do nó, ID da instância e endereço IP, permanecem inalteradas. No entanto, os dados no disco do sistema são excluídos. Os dados em discos de dados anexados separadamente ao nó não são afetados.

    Para mais informações sobre a lógica e o processo de atualização, consulte Referência: Atualização in-place e atualização por substituição de disco.

Batch Update Policy

  • Maximum Number of Nodes per Batch: O ACK atualiza apenas um node pool por vez. Os nós dentro do node pool são atualizados em lotes com base nesta configuração. Se você pausar e depois retomar a atualização, a política de lotes continuará sendo seguida. O número de nós em um lote aumenta progressivamente: 1, 2, 4, 8 e assim por diante, até atingir o número máximo de nós simultâneos. Depois disso, cada lote conterá o número máximo de nós simultâneos.

    Por exemplo, se o número máximo de nós simultâneos for 4, a quantidade de nós em cada lote será 1, 2, 4, 4, 4 e assim por diante. Para mais informações, consulte Referência: Atualização in-place e atualização por substituição de disco.
  • Automatic Pause Policy: Política para pausar o processo de atualização dos nós. Se selecionar Automatic, também poderá configurar o Interval Between Batches. Trata-se da duração do intervalo, se houver, entre os lotes de atualização (de 5 a 120 minutos).

  • Auto Snapshot: Se os discos do sistema dos seus nós contiverem dados importantes de negócios, escolha se deseja criar snapshots para os nós antes de atualizar o node pool. Isso permite fazer backup e restaurar os dados dos nós.

    Importante

3. Validação pós-atualização

Após a atualização do node pool, verifique os seguintes itens:

对 Os nós foram atualizados com sucesso. As versões do kubelet e do containerd estão atualizadas na página de detalhes do nó.

对 O agendamento de Pods está funcionando normalmente.

对 As aplicações de negócio operam conforme o esperado.

Referências

  • Para respostas a perguntas frequentes antes e durante a atualização de um cluster, consulte FAQ.

  • Para informações sobre a política de suporte a versões do Kubernetes do ACK, consulte Guia de versões.

  • A partir da versão 1.24, o Docker não é mais suportado como runtime de contêiner integrado. Se atualizar para a versão 1.24 ou posterior, você deve migrar o runtime de contêiner dos nós de Docker para containerd.

  • A partir da versão 1.30, CentOS e Alibaba Cloud Linux 2 não são mais suportados. Utilize outros sistemas operacionais suportados.

  • Também é possível ativar atualizações automáticas de cluster para reduzir a carga operacional associada ao gerenciamento de versões. Para mais informações, consulte Atualizar automaticamente um cluster.