Migrar nós para o cgroupv2 do Linux

Autopilot Standard

A partir da versão 1.33, o Google Kubernetes Engine (GKE) migra clusters que executam cgroupv1 para cgroupv2. Nesta página, você vai aprender a:

• Verifique em qual modo de cgroup os nós do cluster estão sendo executados e se as cargas de trabalho podem ser afetadas pela transição entre os modos de cgroup.
• Migre nós de cluster do Autopilot do GKE ou pools de nós de cluster padrão para cgroupv2.
• Desative temporariamente a migração automática de nós do GKE usando cgroupv1 para cgroupv2. Siga estas instruções se o cluster executar cargas de trabalho que possam ser afetadas pela transição entre os modos cgroup.

Você pode pular a leitura desta página se souber que suas cargas de trabalho são executadas conforme o esperado em cgroupv2 ou não são afetadas pela configuração do modo cgroup. O GKE migra automaticamente clusters que executam cgroupv1 para cgroupv2 com a versão 1.33 e mais recente.

Sobre os grupos de controle do Linux

O kubelet e o ambiente de execução do contêiner usam os grupos de controle (cgroups) de kernel do Linux para gerenciar recursos, como limitar a quantidade de CPU ou memória que cada contêiner em um pod pode acessar. Há dois modos do subsistema cgroup no kernel: cgroupv1 e cgroupv2. O suporte do Kubernetes para cgroupv2 foi introduzido como Alfa na versão 1.18 do Kubernetes, Beta na versão 1.22 e disponível para todos os usuários na versão 1.25. Para saber mais, consulte a documentação do Kubernetes cgroups v2.

Para saber como configurar um modo cgroup para clusters Standard, consulte Opções de configuração do modo cgroup do Linux.

Como o GKE está fazendo a transição para o cgroupv2

Confira a linha do tempo a seguir para entender como o GKE está fazendo a transição dos clusters atuais para usar cgroupv2:

• Em versões anteriores à 1.26, cgroupv1 era o padrão para nós. Para versões 1.26 ou mais recentes, cgroupv2 é o padrão para novos nós. Não há mudanças nos nós atuais. Para saber mais sobre qual modo de cgroup seus clusters do GKE executam por padrão, consulte Verificar o modo de cgroup dos nós do cluster.
• Com a versão secundária 1.31, o GKE descontinua o cgroupv1.
• A partir da versão 1.33, o GKE migra clusters que executam cgroupv1 para cgroupv2. É possível impedir temporariamente essa migração automática especificando explicitamente que um pool de nós use cgroupv1.
• Com a versão secundária 1.35, o GKE remove o suporte para cgroupv1.

Para saber o tempo aproximado dos upgrades automáticos para versões secundárias mais recentes, como 1.31 e 1.33, consulte a Programação estimada para canais de lançamento.

Antes de começar

Antes de começar, verifique se você realizou as tarefas a seguir:

• Ative a API Google Kubernetes Engine.
Ativar a API Google Kubernetes Engine
• Para usar a Google Cloud CLI nesta tarefa, instale e inicialize a CLI gcloud. Se você instalou a CLI gcloud anteriormente, instale a versão mais recente executando o comando gcloud components update. Talvez as versões anteriores da CLI gcloud não sejam compatíveis com a execução dos comandos neste documento.
  Observação:em instalações prévias da CLI gcloud, defina a propriedade compute/region. Se você usa principalmente clusters zonais, defina compute/zone. Ao definir um local padrão, é possível evitar erros na CLI gcloud como: One of [--zone, --region] must be supplied: Please specify location. Talvez seja necessário especificar o local em determinados comandos se o local do cluster for diferente do padrão definido.

Verificar o modo cgroup dos nós do cluster

O modo cgroup padrão depende do tipo de cluster ou pool de nós e da versão. Na versão 1.26 ou mais recente, o padrão é cgroupv2. Na versão 1.25 ou anterior, o padrão é cgroupv1:

• Para clusters do Autopilot e novos pools de nós de cluster padrão criados com provisionamento automático de nós, o modo cgroup é baseado na versão inicial do cluster. Não é possível definir o modo cgroup durante a criação do cluster do Autopilot. Para novos nós provisionados automaticamente, não é possível definir o modo de maneira diferente do modo cgroup padrão com base na versão secundária.
• Para pools de nós de cluster padrão criados manualmente sem provisionamento automático de nós, o modo cgroup se baseia na versão inicial do pool de nós ou na configuração personalizada do sistema de nós.

Para verificar o modo cgroup, siga as instruções com base no modo do cluster.

Piloto automático

Execute este comando:

gcloud container clusters describe CLUSTER_NAME \
    --format='value(nodePools[0].config.effectiveCgroupMode)'

Substitua CLUSTER_NAME pelo nome do cluster.

Se a saída for EFFECTIVE_CGROUP_MODE_V2, o cluster estará em execução em cgroupv2. Se a saída for EFFECTIVE_CGROUP_MODE_V1, o cluster estará em execução em cgroupv1.

Os clusters do GKE Autopilot criados inicialmente com a versão 1.25 ou anterior do GKE executam o cgroupv1 até que sejam migrados.

Padrão

Com os clusters do GKE Standard, o modo cgroup é definido no nível do pool de nós. Para verificar o modo de pools de nós individuais, siga as instruções para Verificar a configuração do cgroup. Se os nós do cluster já estiverem usando cgroupv2, não será necessário fazer mais nada.

Migrar nós para cgroupv2

Recomendamos que você migre os nós atuais antes que o GKE faça isso automaticamente na versão 1.33 ou mais recente.

Siga as etapas abaixo para migrar nós que executam cgroupv1:

1. Verifique o modo cgroup dos nós. Se os nós do cluster já estiverem usando cgroupv2, nenhuma outra ação será necessária.
2. Leia as considerações sobre a migração, Migrar para cgroup v2, para garantir que suas cargas de trabalho estejam preparadas para usar a nova versão da API.

3. Migre os nós do cluster.

   Observação :quando você executa esses comandos para atualizar o modo cgroup, o GKE atualiza os nós usando a estratégia de upgrade súbito. O GKE inicia essas operações para atualizar pools de nós ou grupos de nós do Autopilot imediatamente em uma ordem sequencial, sem respeitar as políticas de manutenção configuradas para o cluster.

   Piloto automático

   Defina explicitamente os nós do cluster para usar cgroupv2:

   gcloud container clusters update CLUSTER_NAME \
       --autoprovisioning-cgroup-mode=v2
   

   Substitua CLUSTER_NAME pelo nome do cluster.

   Padrão

   1. Se você usar o provisionamento automático de nós para o cluster, execute o comando a seguir para garantir que os pools de nós atuais e futuros criados com o provisionamento automático de nós usem cgroupv2:

      gcloud container clusters update CLUSTER_NAME \
          --autoprovisioning-cgroup-mode=v2
      

      Substitua CLUSTER_NAME pelo nome do cluster.

   2. Para pools de nós criados sem provisionamento automático de nós, atualize o pool de nós para adicionar o seguinte à configuração do sistema de nós:

      linuxConfig:
        cgroupMode: 'CGROUP_MODE_V2'
      

      Para saber mais, consulte Como personalizar a configuração do sistema de nós.

      Quando você cria manualmente novos pools de nós sem o provisionamento automático de nós, o GKE usa cgroupv2 por padrão.

Desativar temporariamente a migração automática para cgroupv2

Para evitar temporariamente a migração automática de nós que executam cgroupv1 para cgroupv2 com versões secundárias 1.33 e mais recentes, defina explicitamente cgroupv1. Você também pode usar estas instruções para reverter temporariamente para cgroupv1 se a migração de nós para cgroupv2 causar um problema nas cargas de trabalho do cluster.

Observação: quando você executa esses comandos para atualizar o modo cgroup, o GKE atualiza os nós usando a estratégia de upgrade súbito. O GKE inicia essas operações para atualizar pools de nós ou grupos de nós do Autopilot imediatamente em uma ordem sequencial, sem respeitar as políticas de manutenção configuradas para o cluster.

Piloto automático

Execute o comando a seguir para clusters criados originalmente com a versão 1.25 ou anterior. Se o cluster foi criado com a versão 1.26 ou mais recente, não é possível definir o modo cgroup como cgroupv1.

Defina explicitamente os nós do cluster para usar cgroupv1:

gcloud container clusters update CLUSTER_NAME \
    --autoprovisioning-cgroup-mode=v1

Substitua CLUSTER_NAME pelo nome do cluster.

Padrão

Para continuar executando o cgroupv1 com um pool de nós de cluster do GKE Standard que executa a versão 1.33 ou mais recente, siga estas etapas:

1. Se você usa o provisionamento automático de nós e o cluster foi criado com a versão 1.25 ou anterior, use o comando a seguir para garantir que os pools de nós atuais e futuros criados com o provisionamento automático de nós usem cgroupv1. Se o cluster foi criado com a versão 1.26 ou mais recente, não é possível definir o modo cgroup como cgroupv1:

   gcloud container clusters update CLUSTER_NAME \
       --autoprovisioning-cgroup-mode=v1
   

   Substitua CLUSTER_NAME pelo nome do cluster.

2. Para pools de nós Standard atuais, atualize o pool de nós para adicionar o seguinte à configuração do sistema de nós:

   linuxConfig:
     cgroupMode: 'CGROUP_MODE_V1'
   

   Você também precisa definir essa configuração de nó para novos pools de nós que criar manualmente sem o provisionamento automático de nós.

   Para saber mais, consulte Personalizar a configuração do sistema de nós.

A seguir

• Saiba como personalizar a configuração do sistema de nós.
• Saiba mais sobre a criação automática de pools de nós.
• Saiba como configurar o bursting de pods no GKE.
• Saiba como fazer a rotação das credenciais do cluster.
• Saiba mais sobre as estratégias de upgrade do pool de nós.