Versão 1.5. Esta versão não é mais compatível, conforme descrito na Política de suporte da versão do Anthos. Para ver os patches e as atualizações mais recentes sobre vulnerabilidades de segurança, exposições e problemas que afetam os clusters do Anthos no VMware (GKE On-Prem), faça o upgrade para uma versão compatível. Você pode encontrar a versão mais recente neste link.

Versões disponíveis

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.

Além disso, verifique se você tem endereços IP suficientes alocados para o cluster de administrador. O cluster de administrador tem um ou três nós de plano de controle para cada cluster de usuário e precisará de um ou três nós adicionais de plano de controle para o cluster de usuário que você quer criar. É preciso haver endereços IP suficientes disponíveis para todos os nós do plano de controle. Para fazer upgrade do cluster de administrador para ter mais endereços IP, consulte Como fazer upgrade e verificar se há endereços IP suficientes disponíveis.

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] para adequar 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.

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.

Comportamento de geração de registros padrão

Para gkectl e gkeadm, basta usar as configurações de geração 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 pela 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:

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
```
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
```