Creazione di cluster utente aggiuntivi

In questa pagina viene spiegato come creare cluster utente aggiuntivi. Per creare cluster utente aggiuntivi, crea una copia del file di configurazione GKE on-premise utilizzato per il deployment dei cluster. Puoi modificare il file copiato per soddisfare le aspettative dei nuovi cluster utente, quindi utilizzare il file per creare il cluster.

Devi copiare e modificare un file di configurazione GKE On-Prem per ogni cluster utente aggiuntivo che vuoi creare.

Prima di iniziare

  • Assicurati che un cluster di amministrazione sia in esecuzione. Hai creato un cluster di amministrazione quando hai installato GKE On-Prem.
  • Individua il file config.yaml generato da gkectl durante l'installazione. Questo file definisce le specifiche del cluster di amministrazione e dei cluster utente. Dovrai copiare e modificare questo file per creare altri cluster utente.
  • Individua il file kubeconfig del cluster di amministrazione. Fai riferimento a questo file quando copi e modifichi config.yaml.

Limitazioni

Limitazione Descrizione
Limiti massimi e minimi per i cluster e i nodi

Vedi Quote e limiti. Le prestazioni del tuo ambiente potrebbero influire su questi limiti.
Univocità dei nomi dei cluster utente

Tutti i cluster utente registrati allo stesso progetto Google Cloud devono avere nomi univoci.
Impossibile eseguire il deployment su più di un data center vCenter e/o vSphere

Attualmente, puoi eseguire il deployment di un cluster di amministrazione e di un insieme di cluster utente associati in un unico data center vCenter e/o vSphere. Non puoi eseguire il deployment dello stesso cluster di amministratori e utenti in più di un vCenter e/o di un data center vSphere.
Impossibile modificare in modo dichiarativo le configurazioni del cluster dopo la creazione Puoi creare cluster aggiuntivi e ridimensionare i cluster esistenti, ma non puoi modificare un cluster esistente tramite il relativo file di configurazione.

Verifica che siano disponibili indirizzi IP sufficienti

Assicurati di disporre di un numero di indirizzi IP sufficiente per il nuovo cluster utente. La verifica di disporre di un numero sufficiente di indirizzi IP dipende dalla presenza o meno di un server DHCP o di indirizzi IP statici.

Inoltre, assicurati di avere un numero sufficiente di indirizzi IP allocati al tuo cluster di amministrazione. Il cluster di amministrazione ha uno o tre nodi del piano di controllo per ogni cluster utente e quest'ultimo necessita di uno o tre nodi aggiuntivi del piano di controllo per il cluster utente da creare. Devono essere disponibili indirizzi IP sufficienti per tutti questi nodi del piano di controllo. Per eseguire l'upgrade del cluster di amministrazione affinché abbia più indirizzi IP, consulta Upgrade: verifica che siano disponibili indirizzi IP sufficienti.

DHCP

Verifica che il server DHCP nella rete in cui verrà creato il cluster abbia indirizzi IP sufficienti. Dovrebbero essere presenti più indirizzi IP di quanti siano in esecuzione dei nodi nel cluster utente.

IP statici

Verifica di aver allocato indirizzi IP sufficienti sul tuo bilanciatore del carico e assicurati di specificarli durante la creazione del cluster.

Copia file di configurazione

Copia il file di configurazione GKE On-Prem che hai [generato] utilizzando gkectl create-config e [modificato] per essere appropriato per il tuo ambiente. Rinomina la copia per utilizzare un altro nome file:

cp [CONFIG_FILE] [NEW_USER_CLUSTER_CONFIG]

dove [NEW_USER_CLUSTER_CONFIG] è il nome che scegli per la copia del file di configurazione. Ai fini di queste istruzioni, chiameremo questo file create-user-cluster.yaml.

In create-user-cluster.yaml, devi modificare i seguenti campi:

  • admincluster, la specifica per il cluster di amministrazione. Rimuovi completamente la specifica admincluster dal file.
  • usercluster, la specifica per un cluster utente.

Nelle sezioni seguenti puoi modificare i campi admincluster e usercluster di create-user-cluster.yaml, quindi utilizzare il file per creare altri cluster utente.

Elimina la specifica admincluster

Se vuoi creare cluster utente aggiuntivi dal cluster di amministrazione esistente, devi eliminare l'intera specifica admincluster.

Per farlo, elimina la specifica e tutti i relativi sottocampi.

Assicurati di non eliminare la specifica usercluster e i relativi campi secondari.

Modifica la specifica usercluster

Apporta le modifiche ai campi usercluster come descritto nelle seguenti sezioni.

Modifica il nome del cluster utente

Modifica il nome del cluster utente nel campo usercluster.clustername. I cluster utente nuovi dovrebbero avere nomi diversi da quelli esistenti.

Prenota gli indirizzi IP per i nodi del cluster utente

Se utilizzi il protocollo DHCP, assicurati di avere un numero sufficiente di IP da creare.

Per gli IP statici, devi modificare il file fornito in usercluster.ipblockfilepath che contiene gli indirizzi IP predefiniti per il cluster utente oppure fornire un file YAML IP diverso con gli IP che preferisci.

Prenota indirizzi IP per il bilanciatore del carico

Se utilizzi il bilanciatore del carico BIG-IP di F5, assicurati di riservare due indirizzi IP per il piano di controllo del bilanciatore del carico e del traffico in entrata del cluster utente. I campi corrispondenti sono usercluster.vips.controlplanevip e usercluster.vips.ingressvip.

(Facoltativo) Modifica i requisiti della macchina

Se hai bisogno che il piano di controllo o i nodi worker di questo cluster utente utilizzino una quantità diversa di CPU o memoria, o se vuoi che il cluster esegua più nodi o meno, imposta i valori per i seguenti campi:

usercluster.masternode

  • usercluster.masternode.cpus: numero di core CPU da utilizzare.
  • usercluster.masternode.memorymb: numero di MB di memoria da utilizzare
  • usercluster.masternode.replicas: numero di nodi di questo tipo da eseguire. Il valore deve essere 1 o 3.

usercluster.workernode

  • usercluster.workernode.cpus: numero di core CPU da utilizzare.
  • usercluster.workernode.memorymd: numero di MB di memoria da utilizzare.
  • usercluster.workernode.replicas: numero di nodi di questo tipo da eseguire.

Aggiorna la specifica vcenter

Se vuoi modificare alcuni aspetti dell'ambiente vSphere per il nuovo cluster, puoi modificare uno qualsiasi dei seguenti campi in vcenter:

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

Non modificare i seguenti campi:

  • credentials.address
  • datacenter
  • cluster

Crea il cluster utente

Ora che hai compilato un file create-user-cluster.yaml, puoi utilizzarlo per creare un cluster utente aggiuntivo.

Esegui questo comando:

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

dove:

  • create-user-cluster.yaml è il file di configurazione appena creato. Potresti aver scelto un nome diverso per questo file.
  • [ADMIN_CLUSTER_KUBECONFIG] rimanda al cluster di amministrazione esistente kubeconfig.

Problemi noti

Versione 1.1: creazione di un secondo cluster utente non riuscita quando si utilizza un datastore vSAN

Consulta le note di rilascio di GKE On-Prem.

Risolvere i problemi

Per ulteriori informazioni, consulta la sezione Risoluzione dei problemi.

Diagnostica dei problemi del cluster con gkectl

Utilizza i comandi gkectl diagnoseper identificare i problemi del cluster e condividerli con Google. Consulta Diagnosi dei problemi del cluster.

Comportamento di logging predefinito

Per gkectl e gkeadm è sufficiente utilizzare le impostazioni di logging predefinite:

  • Per impostazione predefinita, le voci di log vengono salvate come segue:

    • Per gkectl, il file di log predefinito è /home/ubuntu/.config/gke-on-prem/logs/gkectl-$(date).log e il file è collegato direttamente al file logs/gkectl-$(date).log nella directory locale in cui viene eseguito gkectl.
    • Per gkeadm, il file di log predefinito è logs/gkeadm-$(date).log nella directory locale in cui esegui gkeadm.
  • Tutte le voci di log vengono salvate nel file di log, anche se non sono stampate nel terminale (quando --alsologtostderr è false).
  • Il livello di dettaglio -v5 (predefinito) copre tutte le voci di log necessarie al team di assistenza.
  • Il file di log contiene anche il comando eseguito e il messaggio di errore.

Se hai bisogno di aiuto, ti consigliamo di inviare il file di log al team di assistenza.

Specificare una posizione non predefinita per il file di log

Per specificare una posizione non predefinita per il file di log gkectl, utilizza il flag --log_file. Il file di log specificato non verrà collegato direttamente alla directory locale.

Per specificare una posizione non predefinita per il file di log gkeadm, utilizza il flag --log_file.

Localizzazione dei log dell'API Cluster nel cluster di amministrazione

Se l'avvio di una VM non riesce dopo l'avvio del piano di controllo dell'amministratore, puoi provare a eseguire il debug controllando i controller dell'API cluster nel log:

  1. Trova il nome del pod dei controller API del cluster nello spazio dei nomi kube-system, dove [ADMIN_CLUSTER_KUBECONFIG] è il percorso del file kubeconfig del cluster di amministrazione:

    kubectl --kubeconfig [ADMIN_CLUSTER_KUBECONFIG] -n kube-system get pods | grep clusterapi-controllers

  2. Apri i log del pod, dove [POD_NAME] è il nome del pod. Se preferisci, utilizza grep o uno strumento simile per cercare errori:

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