Escolher uma ferramenta para gerenciar o ciclo de vida do cluster

O Google Distributed Cloud oferece várias ferramentas para criar clusters e gerenciar as operações do ciclo de vida do cluster (atualização, upgrade e exclusão):

• A ferramenta de linha de comando gkectl, que é executada na estação de trabalho do administrador no data center local. Você cria um arquivo de configuração que descreve a rede do cluster, o balanceamento de carga e outros recursos do cluster. Esse arquivo é especificado na linha de comando como gkectl.
• O console do Google Cloud , a Google Cloud CLI ou o Terraform, que pode ser executado em qualquer computador que tenha conectividade de rede com a API GKE On-Prem. Essas ferramentas padrão usam a API GKE On-Prem, que é executada na infraestrutura do Google Cloud . Coletivamente, elas são chamadas de clientes da API GKE On-Prem. Para gerenciar o ciclo de vida dos clusters, a API GKE On-Prem precisa armazenar metadados sobre o estado do cluster no Google Cloud, na região Google Cloud especificada ao criar o cluster. Esses metadados permitem que a API gerencie o ciclo de vida do cluster e não incluem dados específicos da carga de trabalho.

Independentemente da ferramenta usada para criar clusters, as informações coletadas e fornecidas para a ferramenta, como os endereços IP das máquinas de nó do cluster e os VIPs do balanceador de carga, são as mesmas.

Com essa seleção, você escolhe a ferramenta ideal para seu caso de uso e ambiente. Exemplo:

• Para suas primeiras instalações em um ambiente de desenvolvimento, é recomendável usar o console do Google Cloud porque a interface do usuário oferece maior orientação e ajuda.
• Se sua organização já usa a CLI gcloud ou o Terraform para gerenciar outros recursos do Google Cloud , talvez seja recomendável também usar essas ferramentas para o Google Distributed Cloud.
• Se sua organização tiver restrições ou requisitos regulamentares, talvez seja necessário limitar a confiança no Google Cloud e usar o gkectl na estação de trabalho do administrador para criar clusters e gerenciar o ciclo de vida deles.

Se você criar um cluster com gkectl, ele será registrado com a API GKE On-Prem por padrão. Também é possível registrar o cluster depois que ele for criado, o que permite usar os clientes da API GKE On-Prem.

Limitações com os clientes da API GKE On-Prem

A ferramenta gkectl é a mais madura em termos de recursos compatíveis. Recomendamos que você analise as funcionalidades dos clientes da API GKE On-Prem ao fazer uma escolha. Os seguintes recursos não são compatíveis com os clientes da API GKE On-Prem:

• Gerenciamento e rotação de secrets
• Rotação de certificados
• Autenticação
• Medição de uso
• Geração de registros e monitoramento no nível do aplicativo
• Rede avançada
• Pools de nós do Windows

A lista a seguir descreve outras limitações com os clientes da API GKE On-Prem:

• A CLI gcloud não é compatível com nenhuma operação de ciclo de vida do cluster de administrador. É possível usar gkectl, o console, a CLI gcloud ou o Terraform para criar clusters de administrador.

• A ferramenta de linha de comando gkectl é a única disponível para fazer upgrade, atualizar e excluir clusters de administrador.

• Somente o gkectl e o Terraform oferecem suporte ao uso de um registro particular.

• O tipo de balanceador de carga para um cluster de administrador e os clusters de usuário dele precisa ser o mesmo. A única exceção é se o cluster de administrador usa o Seesaw. Nesse caso, os clusters de usuário podem usar o MetalLB. Se você quiser que os clusters de administrador e de usuário usem diferentes tipos de balanceadores de carga, crie os clusters usando gkectl.

• Quando você cria um cluster de usuário usando o console Google Cloud , todas as configurações de vCenter são herdadas do cluster de administrador. Se você precisar que um cluster de usuário tenha configurações de vCenter diferentes do cluster de administrador, use a CLI gcloud, o Terraform ou o gkectl para criar o cluster de usuário.

Limitações do cluster avançado

Quando você cria um cluster, o Google Distributed Cloud cria um cluster avançado ou não avançado por padrão, dependendo da versão, da seguinte maneira:

• Versão 1.32 ou anterior: um cluster não avançado é criado por padrão.
• Versão 1.33 ou mais recente: um cluster avançado é criado por padrão.

Somente o Terraform e a ferramenta de linha de comando gkectl podem mudar o comportamento padrão. Para mudar o comportamento padrão, faça o seguinte:

• gkectl: inclua o campo booleano enableAdvancedCluster no arquivo de configuração do cluster. Por exemplo, para criar um cluster avançado com uma versão 1.32, especifique enableAdvancedCluster: true no arquivo de configuração do cluster.

• Terraform: inclua o campo booleano enable_advanced_cluster no arquivo de configuração (normalmente chamado de main.tf). Por exemplo, para criar um cluster avançado com a versão 1.32, adicione enable_advanced_cluster = true a main.tf.

Somente a ferramenta de linha de comando gkectl é compatível nos seguintes casos:

• Ao fazer upgrade de um cluster não avançado para um avançado.
• Ao fazer upgrade de um cluster da versão 1.32 para a 1.33.

Para mais informações, consulte Atualizar ou fazer upgrade de um cluster para um cluster avançado.

Os clientes da API GKE On-Prem têm limitações nas operações de criação, upgrade, atualização e exclusão, conforme capturado na tabela a seguir. Apenas a ferramenta de linha de comando gkectl é compatível com todas as operações, exceto a exclusão do cluster de administrador. A exclusão de um cluster de administrador é um caso especial, que envolve a exclusão de recursos do Google Cloud , recursos do balanceador de carga, a VM e o disco de dados do vSphere. Para mais informações, consulte Excluir um cluster de administrador.

Use os menus suspensos a seguir para filtrar a tabela por cliente e tipo de cluster:

Selecione um cliente Console CLI da gcloud Terraform Selecionar um tipo de cluster Cluster de usuário não avançado Cluster de administrador não avançado Cluster de usuário avançado Cluster de administrador avançado

A tabela a seguir mostra quais operações de cluster são compatíveis com o cliente selecionado:

Cliente	Tipo de cluster	Operação	Compatível / Versão
Terraform	Cluster de usuário não avançado	Criar	1.32 ou mais recente
Terraform	Cluster de usuário não avançado	Fazer upgrade e continuar sem o Advanced	1.32 ou anterior
Terraform	Cluster de usuário não avançado	Fazer upgrade para o Advanced	Não
Terraform	Cluster de usuário não avançado	Atualizar a configuração	Sim
Terraform	Cluster de usuário não avançado	Excluir	Sim
Terraform	Cluster de usuário avançado	Criar	1.33.200 ou mais recente
Terraform	Cluster de usuário avançado	Fazer upgrade	1.33.200 ou mais recente
Terraform	Cluster de usuário avançado	Atualizar a configuração	Sim
Terraform	Cluster de usuário avançado	Excluir	Sim
Terraform	Cluster de administrador não avançado	Criar	1.32 ou mais recente
Terraform	Cluster de administrador não avançado	Fazer upgrade e continuar sem o Advanced	Não
Terraform	Cluster de administrador não avançado	Fazer upgrade para o Advanced	Não
Terraform	Cluster de administrador não avançado	Atualizar a configuração	Sim
Terraform	Cluster de administrador não avançado	Excluir	Não
Terraform	Cluster de administrador avançado	Criar	1.33.200 ou mais recente
Terraform	Cluster de administrador avançado	Fazer upgrade	Não
Terraform	Cluster de administrador avançado	Atualizar a configuração	Sim
Terraform	Cluster de administrador avançado	Excluir	Não
Console	Cluster de usuário não avançado	Criar	1.32 ou anterior
Console	Cluster de usuário não avançado	Fazer upgrade e continuar sem o Advanced	1.32 ou anterior
Console	Cluster de usuário não avançado	Fazer upgrade para o Advanced	Não
Console	Cluster de usuário não avançado	Atualizar a configuração	Sim
Console	Cluster de usuário não avançado	Excluir	Sim
Console	Cluster de usuário avançado	Criar	1.33.200 ou mais recente
Console	Cluster de usuário avançado	Fazer upgrade	1.33.200 ou mais recente
Console	Cluster de usuário avançado	Atualizar a configuração	Sim
Console	Cluster de usuário avançado	Excluir	Sim
Console	Cluster de administrador não avançado	Criar	1.32 ou anterior
Console	Cluster de administrador não avançado	Fazer upgrade e continuar sem o Advanced	Não
Console	Cluster de administrador não avançado	Fazer upgrade para o Advanced	Não
Console	Cluster de administrador não avançado	Atualizar a configuração	Não
Console	Cluster de administrador não avançado	Excluir	Não
Console	Cluster de administrador avançado	Criar	1.33.200 ou mais recente
Console	Cluster de administrador avançado	Fazer upgrade	Não
Console	Cluster de administrador avançado	Atualizar a configuração	Não
Console	Cluster de administrador avançado	Excluir	Não
CLI da gcloud	Cluster de usuário não avançado	Criar	1.32 ou mais recente
CLI da gcloud	Cluster de usuário não avançado	Fazer upgrade e continuar sem o Advanced	1.32 ou anterior
CLI da gcloud	Cluster de usuário não avançado	Fazer upgrade para o Advanced	Não
CLI da gcloud	Cluster de usuário não avançado	Atualizar a configuração	Sim
CLI da gcloud	Cluster de usuário não avançado	Excluir	Sim
CLI da gcloud	Cluster de usuário avançado	Criar	1.33.200 ou mais recente
CLI da gcloud	Cluster de usuário avançado	Fazer upgrade	1.33.200 ou mais recente
CLI da gcloud	Cluster de usuário avançado	Atualizar a configuração	Sim
CLI da gcloud	Cluster de usuário avançado	Excluir	Sim
CLI da gcloud	Cluster de administrador não avançado	Criar	Não
CLI da gcloud	Cluster de administrador não avançado	Fazer upgrade e continuar sem o Advanced	1.32 e versões anteriores
CLI da gcloud	Cluster de administrador não avançado	Fazer upgrade para o Advanced	Não
CLI da gcloud	Cluster de administrador não avançado	Atualizar a configuração	Não
CLI da gcloud	Cluster de administrador não avançado	Excluir	Não
CLI da gcloud	Cluster de administrador avançado	Criar	Não
CLI da gcloud	Cluster de administrador avançado	Fazer upgrade	1.33.200 e versões mais recentes
CLI da gcloud	Cluster de administrador avançado	Atualizar a configuração	Não
CLI da gcloud	Cluster de administrador avançado	Excluir	Não

Verifique essas limitações periodicamente à medida que os clientes da API GKE On-Prem evoluem.