Como criar outros clusters de usuário

Nesta página, você verá como criar mais clusters de usuário. Para criar clusters de usuário extras, 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 cluster de usuário extra que você quiser criar.

Antes de começar

  • Verifique se há um cluster de administrador em execução. Você criou um cluster de administrador quando instalou 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.

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 conforme 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.

Atualizar a especificação vcenter

Se você quiser alterar determinados aspectos do ambiente do vSphere para o novo cluster, modifique qualquer um dos seguintes campos em vcenter:

  • credentials.username
  • credentials.password
  • datastore
  • network
  • resourcepool

Não modifique os seguintes campos:

  • credentials.address
  • datacenter
  • cluster

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.

Problemas conhecidos

Versão 1.1: falha na criação de um segundo cluster de usuário ao usar um armazenamento de dados vSAN

Consulte as notas de lançamento do GKE On-Prem.

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.

Como executar comandos gkectl de maneira detalhada

-v5

Como registrar erros gkectl em stderr

--alsologtostderr

Como localizar registros gkectl na estação de trabalho do administrador

Mesmo que você não transmita as sinalizações de depuração, é possível visualizar os registros gkectl no seguinte diretório da estação de trabalho do administrador:

/home/ubuntu/.config/gke-on-prem/logs

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