Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Change operating system

Última atualização: Oct 15, 2026

Atualize a imagem do sistema operacional do seu node pool para a versão mais recente ou mude para um tipo de sistema operacional diferente.

Consulte Release notes for OS images para ver os tipos de sistema operacional suportados, 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 sistema operacional. Faça o 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.

  • Durante uma atualização com substituição de disco, o ACK drena os nós e remove os pods para outros nós disponíveis, respeitando o Pod Disruption Budget (PDB). Para garantir alta disponibilidade, implante workloads com múltiplas réplicas em vários nós e configure um PDB para services críticos, a fim de limitar as interrupções simultâneas de pods.

    O tempo limite padrão para drenar um nó é de 30 minutos. Se a migração do pod não for concluída dentro desse período, o ACK encerra a atualização para manter a estabilidade do service.
  • Durante uma atualização com substituição de disco, o ACK reinicializa os nós com base na configuração atual do node pool, incluindo o método de logon, rótulos, taints, imagem do sistema operacional e versão do runtime. Atualize a configuração do node pool conforme descrito em Edite um node pool. As alterações feitas por outros métodos são sobrescritas durante a atualização.

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

  • Se você alterou as configurações do cluster, por exemplo, caso você ative o swap ou use métodos não padronizados, como fazer logon em um nó (Customize node pool kubelet configurations), para que você modifique as configurações do kubelet ou do runtime, a atualização do cluster pode falhar ou sobrescrever suas configurações personalizadas.

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

  • Se você tiver nós órfãos (nós de trabalho 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 requer um disco de dados anexado para a inicialização. Siga o procedimento abaixo ao atualizar para o ContainerOS 3.4.0 ou posterior. Outras versões não são afetadas.

    Clique e visualize o procedimento detalhado

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

    • Único disco de dados anexado: Siga o Procedure abaixo para atualizar.

    • Múltiplos discos de dados anexados: Execute uma migração por rotação. Crie um node pool com o ContainerOS 3.4 ou posterior e um disco de dados e, em seguida, aumente a escala de 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 aumente a escala de novos nós. Depois que os novos nós estiverem em execução, drene e remova os nós antigos.

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

    Crie ou edite um node pool consultando Crie e gerencie um node pool . Defina um nó como não agendável consultando Drene um nó e gerencie seu status de agendamento . Remova um nó consultando Remove a node .
  • Se você customize the GPU driver version by specifying a version number ou by using an OSS URL, o sistema operacional e o driver podem se tornar incompatíveis após a atualização. Consulte Supported NVIDIA driver versions in ACK e escolha um driver compatível.

Procedimento

Para evitar riscos de compatibilidade, execute uma pré-verificação antes da atualização da imagem do sistema operacional ou da alteração do tipo de sistema operacional.

  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 de destino.

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

    • Normal: Pré-verificação 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 pré-verificação, configure os seguintes parâmetros e clique em Start Replacement.

    Parâmetro

    Descrição

    Versão de destino

    Imagem e versão do sistema operacional de destino.

    Versão atual

    A versão atual do sistema operacional.

    Update Node

    Nós para atualização. Selecione todos ou nós específicos.

    Ignore Warnings

    Se deve prosseguir caso a pré-verificação reporte avisos. Por exemplo, 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 sistema operacional.

    Interval Between Batches

    Intervalo entre lotes quando a Política de Pausa Automática é Não Pausar. Valores válidos: 5 a 120 minutos.

    Auto Snapshot

    Crie um snapshot para nós com dados importantes para ativar o backup e a restauração. Os snapshots geram snapshot fees. Delete unneeded snapshots após a atualização.

    Importante

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

Referências