Você está visualizando a documentação de uma versão anterior do GKE On-Prem. Veja a documentação mais recente.

Como criar outros clusters de usuário

Nesta página, você verá como criar mais clusters de usuário. Para criar outros clusters de usuário, faça uma cópia do arquivo de configuração do GKE On-Prem usado para implantar os clusters. Modifique o arquivo copiado para atender às suas expectativas para os novos clusters de usuário. Depois, use o arquivo para criar o cluster.

É necessário copiar e modificar um arquivo de configuração do GKE On-Prem para cada outro cluster de usuário que você quiser criar.

Antes de começar

  • Verifique se há um cluster de administrador em execução. Você criou um cluster de administrador quandoinstalou o GKE On-Prem.
  • Localize o arquivo config.yaml que foi gerado pelo gkectl durante a instalação. Esse arquivo define especificações para o cluster de administrador e os clusters de usuário. Você copiará e modificará esse arquivo para criar mais clusters de usuário.
  • Localize o arquivo kubeconfig do cluster de administrador. Referencie esse arquivo ao copiar e modificar config.yaml.

Limitações

Limitação Descrição
Limites máximo e mínimo para clusters e nós

Consulte Cotas e limites. O desempenho do ambiente pode afetar esses limites.

Exclusividade para nomes de cluster de usuário

Todos os clusters de usuário registrados no mesmo projeto do Google Cloud precisam ter nomes exclusivos.

Não é possível implantar em mais de um data center do vCenter e/ou do vSphere

Atualmente, é possível implantar apenas um cluster de administrador e um conjunto de clusters de usuário associados a somente um data center do vCenter e/ou do vSphere. Não é possível implantar os mesmos clusters de administrador e de usuário em mais de um data center do vCenter e/ou do vSphere.

Não é possível alterar as configurações do cluster de maneira declarativa após a criação Embora você consiga criar outros clusters e redimensionar clusters atuais, não é possível alterar um cluster atual por meio do arquivo de configuração.

Verificar se há endereços IP suficientes disponíveis

Verifique se você tem endereços IP suficientes alocados ao novo cluster de usuário. Para isso, é necessário saber se você está usando um servidor DHCP ou IPs estáticos.

DHCP

Verifique se o servidor DHCP na rede em que o cluster será criado tem endereços IP suficientes. É necessário que haja mais endereços IP do que nós em execução no cluster de usuário.

IPs estáticos

Verifique se você alocou endereços IP suficientes no seu balanceador de carga e especifique esses endereços IP durante a criação do cluster.

Criar uma partição F5 BIG-IP

Se você estiver usando F55 BIG-IP para balanceamento de carga, crie uma partição para o novo cluster de usuário.

Copiar o arquivo de configuração

Copie o arquivo de configuração do GKE On-Prem que você gerou usando gkectl create-config e modificou para ser apropriado ao seu ambiente. Renomeie a cópia para usar outro nome de arquivo:

cp [CONFIG_FILE] [NEW_USER_CLUSTER_CONFIG]

em que [NEW_USER_CLUSTER_CONFIG] é o nome escolhido para a cópia do arquivo de configuração. Para estas instruções, chamaremos esse arquivo de create-user-cluster.yaml.

Em create-user-cluster.yaml, você precisa alterar os campos a seguir:

  • admincluster, a especificação para o cluster de administrador. Você remove completamente a especificação admincluster do arquivo.
  • usercluster, a especificação de um cluster de usuário.

Nas seções a seguir, você modifica os campos admincluster e usercluster de create-user-cluster.yaml e usa o arquivo para criar mais clusters de usuário.

Excluir a especificação admincluster

Se quiser criar mais clusters de usuário a partir do cluster de administrador atual, você precisará excluir toda a especificação admincluster.

Para isso, basta excluir a especificação e todos os subcampos.

Não exclua a especificação usercluster nem qualquer um dos subcampos.

Modificar a especificação usercluster

Faça alterações nos campos usercluster, conforme descrito nas seções a seguir.

Alterar o nome do cluster de usuário

Altere o nome do cluster de usuário no campo usercluster.clustername. Os novos clusters de usuário precisam ter nomes diferentes dos atuais.

Reservar endereços IP para os nós do cluster de usuário

Se você estiver usando DHCP, verifique se tem IPs suficientes para criar os nós.

Para IP estático, modifique o arquivo fornecido para usercluster.ipblockfilepath, que contém os endereços IP predefinidos do cluster de usuário. Outra opção é fornecer um arquivo YAML de IP estático diferente com os IPs que você quiser.

Reservar endereços IP para o balanceador de carga

Se você estiver usando o balanceador de carga F5 BIG-IP, reserve dois endereços IP para o plano de controle do cluster e a entrada do balanceador de carga do cluster de usuário. Os campos correspondentes são usercluster.vips.controlplanevip e usercluster.vips.ingressvip.

Alterar os requisitos da máquina (opcional)

Se você precisar que o plano de controle ou os nós de trabalho desse cluster de usuário usem uma quantidade diferente de CPU ou memória, ou se precisar que o cluster execute mais ou menos nós, defina os valores nos seguintes campos:

usercluster.masternode

  • usercluster.masternode.cpus: número de núcleos de CPU a serem usados.
  • usercluster.masternode.memorymb: número de MB de memória a serem usados.
  • usercluster.masternode.replicas: número de nós desse tipo a serem executados. O valor precisa ser 1 ou 3.

usercluster.workernode

  • usercluster.workernode.cpus: número de núcleos de CPU a serem usados.
  • usercluster.workernode.memorymd: número de MB de memória a serem usados.
  • usercluster.workernode.replicas: número de nós desse tipo a serem executados.

Configurar a partição F5 BIG-IP

Se estiver usando F5 BIG-IP para balanceamento de carga, você criou uma partição para o novo cluster de usuário. Agora, configure a partição no campo usercluster.bigip.partition. Por exemplo:

usercluster:
...
bigip:
  partition: "my-new-user-f5-partition"
...

Criar o cluster de usuário

Agora que você preencheu um arquivo create-user-cluster.yaml, já pode usá-lo para criar um cluster de usuário extra.

Execute este comando:

gkectl create cluster --config create-user-cluster.yaml --kubeconfig [ADMIN_CLUSTER_KUBECONFIG]

em que:

  • create-user-cluster.yaml é o arquivo de configuração que você acabou de criar. Talvez você tenha escolhido um nome diferente para este arquivo.
  • [ADMIN_CLUSTER_KUBECONFIG] aponta para o kubeconfig do cluster de administrador atual.

Solução de problemas

Para mais informações, consulte Solução de problemas.

Como diagnosticar problemas de cluster usando gkectl

Use os comandos gkectl diagnose para identificar problemas de cluster e compartilhar informações do cluster com o Google. Consulte Como diagnosticar problemas de cluster.

Comportamento de geração de registros padrão

Para gkectl e gkeadm, basta usar as configurações de registros padrão:

  • Por padrão, as entradas de registro são salvas da seguinte maneira:

    • Para gkectl, o arquivo de registros padrão é /home/ubuntu/.config/gke-on-prem/logs/gkectl-$(date).log, e está vinculado ao arquivo logs/gkectl-$(date).log no diretório local em que você executa gkectl.
    • Para gkeadm, o arquivo de registros padrão é logs/gkeadm-$(date).log, no diretório local em que você executa gkeadm.
  • Todas as entradas de registro são salvas no arquivo de registros, mesmo que não sejam impressas no terminal (quando --alsologtostderr é false).
  • O nível de detalhamento -v5 (padrão) abrange todas as entradas de registro exigidas por sua equipe de suporte.
  • O arquivo de registros também contém o comando executado e a mensagem de erro.

Recomendamos que você envie o arquivo de registros para a equipe de suporte quando precisar de ajuda.

Como especificar um local não padrão para o arquivo de registros

Se quiser especificar um local não padrão para o arquivo de registros gkectl, use a sinalização --log_file. O arquivo de registro que você especificar não será vinculado ao diretório local.

Se quiser especificar um local não padrão para o arquivo de registros gkeadm, use a sinalização --log_file.

Como localizar registros da API Cluster no cluster de administrador

Se uma VM não for iniciada após o início do plano de controle do administrador, tente depurar isso inspecionando os registros dos controladores da API Cluster no cluster de administrador:

  1. Encontre o nome do pod de controladores da API Cluster no namespace kube-system, em que [ADMIN_CLUSTER_KUBECONFIG] é o caminho para o arquivo kubeconfig do cluster de administrador:

    kubectl --kubeconfig [ADMIN_CLUSTER_KUBECONFIG] -n kube-system get pods | grep clusterapi-controllers
  2. Abra os registros do pod, em que [POD_NAME] é o nome do pod. Opcionalmente, use grep ou uma ferramenta semelhante para pesquisar erros:

    kubectl --kubeconfig [ADMIN_CLUSTER_KUBECONFIG] -n kube-system logs [POD_NAME] vsphere-controller-manager