Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Change operating system

Última atualização: Sep 08, 2026

Atualize a imagem do SO do seu node pool para a versão mais recente ou altere para um tipo diferente de SO.

Consulte Release notes for OS images para verificar os tipos de SO compatíveis, as versões de imagem e as limitações de uso.

Notas de uso

  • Esta operação substitui os discos do sistema em lotes para atualizar o SO. Faça backup dos dados importantes dos discos do sistema com antecedência. Os discos de dados não são afetados. Execute esta operação fora dos horários de pico.

  • Ao atualizar nós mediante substituição de discos, o ACK drena os nós. Esse processo evacua os pods para outros nós ativos, respeitando o Pod Disruption Budget (PDB). Para garantir alta disponibilidade, implante workloads com múltiplas réplicas em nós diferentes. Configure também um PDB para services críticos e controle o número de pods que podem ser interrompidos simultaneamente.

    O tempo limite padrão para drenagem de um nó é de 30 minutos. Se a migração dos pods não for concluída dentro desse período, o ACK encerra a atualização para garantir a estabilidade do service.
  • Durante a atualização de nós via substituição de disco, o ACK os reinicializa com base na configuração atual do node pool. Isso inclui método de logon, rótulos, taints, imagem do SO e versão do runtime. Para atualizar as configurações do node pool, consulte Edit a node pool. Caso tenha modificado os nós de outra forma, a atualização sobrescreverá suas alterações.

  • Se um pod em um nó referenciar um HostPath apontando para o disco do sistema, os dados no diretório HostPath serão perdidos após a atualização por substituição de disco.

  • Alterações de configuração no cluster, como ativar a partição SWAP ou modificar configurações do kubelet ou do runtime via linha de comando, podem causar falha na atualização do cluster ou resultar na sobrescrita das suas configurações personalizadas.

  • Alguns sistemas operacionais do ACK usam cgroup v2 por padrão. Revise a cgroup v2 overview para considerações relacionadas.

  • Caso possua nós órfãos (nós worker não gerenciados por um node pool), migrate them to a node pool.

  • No ContainerOS 3.4.0 e versões posteriores, o disco do sistema é somente leitura e exige um disco de dados anexado para inicialização. Siga o procedimento abaixo ao atualizar para o ContainerOS 3.4.0 ou superior. Outras versões não são afetadas.

    Clique para visualizar o procedimento detalhado

    Escolha um plano com base no status do disco de dados do seu node pool:

    • Disco de dados único anexado: Siga o Procedure abaixo para atualizar.

    • Múltiplos discos de dados anexados: Realize uma migração rotativa. Crie um node pool com ContainerOS 3.4 ou posterior e um disco de dados e escale horizontalmente os nós. Migre gradualmente as aplicações para o novo pool (por exemplo, desativando o agendamento no pool antigo ou usando rótulos). Desative o pool antigo após a migração.

    • Nenhum disco de dados anexado:

      • Manter o node pool atual: Adicione um disco de dados à configuração do node pool e escale horizontalmente novos nós. Após a entrada em execução dos novos nós, drene e remova os antigos.

      • Migrar para um novo node pool: Siga o mesmo procedimento descrito em 'Múltiplos discos de dados anexados'.

    Para criar ou editar um node pool, consulte Create and manage a node pool . Para definir um nó como não agendável, consulte Drain a node and manage its scheduling status . Para remover um nó, consulte Remove a node .
  • Se você customize the GPU driver version by specifying a version number ou by using an OSS URL, o SO e o driver podem tornar-se incompatíveis após a atualização. Consulte Supported NVIDIA driver versions in ACK para selecionar um driver compatível.

Procedimento

Para evitar riscos de compatibilidade, execute uma verificação prévia antes de atualizar a imagem do SO ou alterar o tipo de SO.

  1. Faça logon 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 Nodes > Node Pools.

  3. Na coluna Actions da lista Node Pools, selecione image > Change Operating System para o node pool desejado.

  4. Clique em Precheck para verificar possíveis riscos.

    • Normal: Verificação prévia aprovada. Prossiga com a atualização.

    • Anormal: Não afeta a operação atual do cluster. Corrija os problemas relatados antes de prosseguir.

  5. Após a aprovação da verificação prévia, configure os parâmetros a seguir e clique em Start Replacement.

    Parâmetro

    Descrição

    Destination version

    Imagem e versão do SO de destino.

    Current version

    Versão atual do SO.

    Update Node

    Nós a serem atualizados. Selecione todos ou nós específicos.

    Ignore Warnings

    Define se deve prosseguir caso a verificação prévia reporte avisos. Por exemplo, quando um pod usa um hostPath apontando para o disco do sistema.

    Batch Replace

    Maximum Number of Nodes per Batch

    Número máximo de nós atualizados simultaneamente por lote.

    Automatic Pause Policy

    Política de pausa para o processo de substituição do SO.

    Interval Between Batches

    Intervalo entre lotes quando a Automatic Pause Policy estiver definida como Do Not Pause. Valores válidos: 5 a 120 minutos.

    Auto Snapshot

    Cria um snapshot para nós com dados importantes, permitindo backup e restauração. Snapshots geram taxas de snapshot. Exclua snapshots desnecessários após a atualização.

    Importante

    Antes de alterar o SO, revise as OS image release notes para evitar riscos de compatibilidade relacionados ao sistema operacional.

Referências