Migrar para o cgroup v2

O Google Distributed Cloud somente software no VMware versão 1.35 exige cgroup v2. A partir da versão 1.35, o Kubernetes não oferece mais suporte ao cgroup v1. Este documento explica como migrar seus clusters para cgroup v2.

Antes de começar

Para instalar ou fazer upgrade do Google Distributed Cloud somente software no VMware com o Kubernetes 1.35, verifique o seguinte:

  • Verifique a versão do software:você precisa usar o Google Distributed Cloud somente software no VMware versão 1.35.00 ou mais recente.
  • Compatibilidade do cgroup v2 com o SO:você precisa usar um sistema operacional que ofereça suporte ao cgroup v2.
  • Configure o cgroup v2 (se necessário): se o SO não usar o cgroup v2 por padrão (por exemplo, Ubuntu 18.04/20.04), configure-o manualmente. Para mais informações, consulte Migrar para cgroup v2 na documentação do Kubernetes.
  • Atualizar a configuração do cluster:mude o campo osImageType de ubuntu, ubuntu_containerd ou cos para ubuntu_cgv2 ou cos_cgv2 antes de fazer upgrade para a versão 1.35.
  • Preparar imagens do vSphere:execute gkectl prepare se as imagens estiverem faltando no vSphere.
  • Atualizar scripts de automação:revise e atualize todos os scripts de automação para usar os novos tipos de imagem ubuntu_cgv2 ou cos_cgv2.

Atualizar o tipo de imagem do SO

Antes de executar gkectl upgrade, mude o osImageType para uma imagem compatível com cgroup v2 no arquivo YAML do cluster.

Cluster de administrador

  1. Abra o arquivo de configuração do cluster de administrador.
  2. Localize o campo osImageType.
  3. Mude o valor para ubuntu_cgv2 (se você usa o Ubuntu) ou cos_cgv2 (se você usa o COS).

Para mais informações sobre esse campo, consulte a documentação de osImageType.

Cluster de usuário

  1. Abra o arquivo de configuração do cluster de usuário.
  2. Localize o campo osImageType na seção nodePools.
  3. Mude o valor para ubuntu_cgv2 (se você usa o Ubuntu) ou cos_cgv2 (se você usa o COS).

Para mais informações sobre esse campo, consulte a documentação de nodePools[i].osImageType.

Fazer upgrade do cluster

Depois de atualizar o osImageType no arquivo de configuração, faça upgrade do cluster.

  1. Execute o comando a seguir para fazer upgrade do cluster:

    gkectl upgrade cluster --config USER_CLUSTER_CONFIG --admin-config ADMIN_CLUSTER_CONFIG

    Substitua USER_CLUSTER_CONFIG pelo caminho para o arquivo de configuração do cluster de usuário. Substitua ADMIN_CLUSTER_CONFIG pelo caminho para o arquivo de configuração do cluster de administrador.

Verificações de simulação

O GKE no VMware 1.35 não é compatível com os tipos de imagem do SO ubuntu, ubuntu_containerd e cos. Se você tentar criar ou fazer upgrade de um cluster ou pool de nós com esses tipos de imagem, o sistema vai bloquear a solicitação durante as verificações de simulação.

Novo tipo de imagem do SO padrão

O osImageType padrão para o GKE no VMware 1.35 é ubuntu_cgv2. Se você criar uma nova configuração de cluster e deixar o campo osImageType em branco, o sistema vai implantar nós com cgroup v2 ativado por padrão.

Se você preferir o Container-Optimized OS (COS) em vez do Ubuntu, defina explicitamente o campo osImageType como cos_cgv2 no arquivo de configuração.

A seguir