Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Manually upgrade a cluster

Última atualização: Sep 25, 2026

Para minimizar riscos de segurança e estabilidade associados a versões desatualizadas, atualize seu cluster prontamente. Atualize o plano de controle e os pools de nós para que todo o cluster execute a nova versão.

Importante

Antes de atualizar o cluster, consulte Upgrade a cluster para entender o processo de atualização, os métodos e as considerações importantes.

Acesso à operação

Primeiro, atualize o plano de controle. Em seguida, atualize os pools de nós. Para clusters que executam a versão 1.30 ou posterior, a versão mais alta compatível com o plano de controle pode ser até duas versões secundárias superior à versão mais baixa do kubelet entre todos os nós. Por exemplo, se a versão mais baixa do kubelet entre todos os nós for 1.30, o plano de controle pode ser atualizado, no máximo, para a versão 1.32.

  1. Acesse o ACK console. No painel de navegação à esquerda, clique em Clusters.

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

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

Atualize o plano de controle

1. Verificação prévia

A verificação prévia da atualização do plano de controle analisa itens como APIs obsoletas, além de validar a compatibilidade dos componentes e o status geral do cluster.

Para clusters que executam a versão 1.20 ou posterior, a verificação prévia verifica se há quaisquer deprecated APIs . Os resultados não afetam o processo de atualização e são apenas informativos. Resolva eventuais problemas antes da atualização para garantir que a nova versão do cluster opere conforme o esperado.

Na aba Control Plane Update, clique em Precheck para verificar 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 do cluster atual. Resolva os problemas com base nas soluções fornecidas. Para mais informações, consulte Cluster check items and solutions.

2. Execute a atualização

Duração: Nos ACK managed clusters e ACK serverless clusters, o ACK gerencia a atualização, que leva aproximadamente 5 minutos. Nos ACK dedicated clusters, os nós mestres são atualizados em sequência, um a 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. Durante a atualização, não faça deploy nem modifique aplicações de negócio e não execute operações de O&M, como dimensionamento do cluster ou gerenciamento de pools de nós. Essas operações podem interromper a atualização ou causar interrupções no service.

Após a atualização do plano de controle, os nós adicionados por expansão também executarão 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. A versão do cluster é atualizada na página Clusters.

对 O API Server e os componentes principais estão com o status Normal.

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

对 É possível criar pods normalmente.

对 É possível adicionar nós normalmente.

4. (Opcional) Continue a atualização do plano de controle

Para atualizar o plano de controle para uma versão mais recente, repita as etapas 1 a 3 para fazer a verificação prévia do plano de controle, atualizá-lo e validar o resultado. Repita esse ciclo até que o plano de controle atinja a versão mais recente disponível para o cluster.

Atualize um pool de nós

Após a atualização do plano de controle, atualize o pool de nós o mais rápido possível, preferencialmente em horários de menor movimento. A atualização do pool de nós inclui o upgrade do kubelet e do runtime de contêineres nos nós.

1. Verificação prévia

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

Na página Node Pool Upgrade, localize o pool de nós de destino na lista e clique em Upgrade na coluna Actions. Em seguida, na parte inferior da página, clique em Precheck para verificar 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 do cluster atual. Resolva os problemas com base nas soluções fornecidas. Para mais informações, consulte Cluster check items and solutions.

2. Configure uma política de atualização e execute a atualização

Duração: A duração depende da divisão dos nós em lotes. Uma atualização in-place leva de 5 a 10 minutos por lote. Uma atualização com substituição de disco sem snapshots leva cerca de 8 minutos. O tempo exato varia conforme o tempo de drenagem do nó. Se houver criação de snapshots, a atualização só começa após a conclusão dessa etapa. O tempo para criar os snapshots depende do volume de dados.
  • Na aba Update a node pool, localize o pool de nós de destino na lista de pools de nós e clique em Update Now.

  • No painel Upgrade Policy Configuration, confirme as informações da atualização, configure a política de atualização conforme descrito na tabela a seguir e, em seguida, clique em Start Update para concluir a atualização do pool de nós conforme as instruções.

Item de configuração

Descrição

Informações da versão

A versão atual e as versões disponíveis do kubelet e do runtime de contêineres.

Update Nodes

Atualize All Nodes ou selecione Specific Node para atualizar apenas nós específicos.

Update Method

  • In-place Upgrade: O sistema atualiza e substitui os componentes necessários diretamente no nó original. O disco do sistema não é substituído e o nó não passa por reinicialização. Os dados no nó original não são afetados.

  • Upgrade by Replacing System Disk: O sistema reinicializa o nó ao substituir o disco do sistema. As propriedades da instância do nó, como nome, ID e endereço IP, permanecem inalteradas. No entanto, os dados do 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 Reference: In-place upgrade and disk replacement upgrade.

Ignore Warnings

Define se a atualização do pool de nós continua caso a verificação prévia automática retorne avisos.

Batch Update Policy

  • Maximum Number of Nodes per Batch: O ACK atualiza apenas um pool de nós por vez. Os nós do pool são atualizados em lotes com base nessa configuração. Se você pausar e retomar a atualização, o sistema mantém a política de lotes. A quantidade de nós por lote aumenta progressivamente (1, 2, 4, 8 e assim por diante) até atingir o limite máximo de nós simultâneos. Após isso, cada lote processa 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 Reference: In-place upgrade and disk replacement upgrade.
  • Automatic Pause Policy: A política de pausa para o processo de atualização do nó. Selecione Automatic para configurar também o Interval Between Batches, que define a duração do intervalo entre os lotes de atualização (de 5 a 120 minutos).

  • Interval Between Batches: O intervalo entre dois lotes de atualização. Selecione Do not set para iniciar o próximo lote imediatamente após a conclusão do lote atual.

  • Auto Snapshot: Se os discos do sistema dos nós contiverem dados corporativos importantes, crie snapshots dos nós antes de atualizar o pool, permitindo o backup e a restauração dos dados.

    Importante
    • Recomenda-se usar snapshots automáticos para atualizações com substituição de disco.

    • O uso de snapshots gera snapshot fees. O time required to create a snapshot varia. Por padrão, os snapshots são retidos por 7 dias. Após a atualização, se os snapshots não forem mais necessários, delete them prontamente.

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

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

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

对 O agendamento de pods funciona normalmente.

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

Referências

  • Para obter respostas às perguntas comuns antes e durante a atualização de um cluster, consulte FAQ.

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

  • A partir da versão 1.24, o Docker não é mais suportado como runtime de contêineres integrado. Se você atualizar para a versão 1.24 ou posterior, é necessário migrate the container runtime of nodes from Docker to containerd.

  • A partir da versão 1.30, o CentOS e o Alibaba Cloud Linux 2 não são mais suportados. Use outros operating systems compatíveis.

  • Como alternativa, ative as atualizações automáticas do cluster para reduzir a carga de trabalho de O&M associada ao gerenciamento de versões. Para mais informações, consulte Automatically upgrade a cluster.

  • Antes de atualizar, adicione quaisquer nós órfãos do cluster aos pools de nós para gerenciar todos os nós de forma unificada, conforme descrito em Migrate unmanaged nodes to a node pool.