Zusätzliche Nutzercluster erstellen

Auf dieser Seite wird erläutert, wie Sie zusätzliche Nutzercluster erstellen. Zum Erstellen zusätzlicher Nutzercluster erstellen Sie eine Kopie der GKE On-Prem-Konfigurationsdatei, die zum Bereitstellen der Cluster verwendet wird. Sie ändern die kopierte Datei, um Ihre Erwartungen an die neuen Nutzercluster zu erfüllen, und verwenden dann die Datei zum Erstellen des Clusters.

Sie müssen für jeden zusätzlichen Nutzercluster, den Sie erstellen möchten, eine GKE On-Prem-Konfigurationsdatei kopieren und ändern.

Hinweis

  • Ein Administratorcluster muss ausgeführt werden. Sie haben einen Administratorcluster bei der Installation von GKE On-Prem erstellt.
  • Suchen Sie die Datei config.yaml, die während der Installation von gkectl generiert wurde. Diese Datei definiert Spezifikationen für den Administratorcluster und die Nutzercluster. Sie kopieren und ändern diese Datei, um zusätzliche Nutzercluster zu erstellen.
  • Suchen Sie die kubeconfig-Datei des Administratorclusters. Sie verweisen auf diese Datei, wenn Sie config.yaml kopieren und ändern.

Beschränkungen

Beschränkung Beschreibung
Höchst- und Mindestwerte für Cluster und Knoten

Siehe Kontingente und Limits. Die Leistung Ihrer Umgebung kann sich auf diese Einschränkungen auswirken.
Eindeutigkeit für Nutzerclusternamen

Alle im selben Google Cloud-Projekt registrierten Nutzercluster müssen eindeutige Namen haben.
Kann nicht in mehr als einem vCenter und/oder vSphere-Rechenzentrum bereitgestellt werden

Derzeit können Sie einen Administratorcluster und eine Reihe von verknüpften Nutzerclustern nur in einem einzelnen vCenter und/oder vSphere Rechenzentrum bereitstellen. Sie können dieselben Administrator- und Nutzercluster nicht in mehr als einem vCenter und/oder vSphere-Rechenzentrum bereitstellen.
Clusterkonfigurationen können nach der Erstellung nicht deklarativ geändert werden Sie können zusätzliche Cluster erstellen und die Größe vorhandener Cluster ändern. Sie können einen vorhandenen Cluster jedoch nicht über seine Konfigurationsdatei ändern.

Verfügbarkeit ausreichender IP-Adressen prüfen

Dem neuen Nutzercluster müssen genügend IP-Adressen zugewiesen sein. Ob Sie genügend IP-Adressen haben, hängt davon ab, ob Sie einen DHCP-Server oder statische IP-Adressen verwenden.

DHCP

Prüfen Sie, ob der DHCP-Server im Netzwerk, in dem der Cluster erstellt wird, über genügend IP-Adressen verfügt. Es sollten mehr IP-Adressen vorhanden sein als Knoten, die im Nutzercluster ausgeführt werden.

Statische IP-Adressen

Prüfen Sie, ob Sie Ihrem Load-Balancer genügend IP-Adressen zugewiesen haben, und geben Sie diese bei der Clustererstellung an.

Konfigurationsdatei kopieren

Kopieren Sie die GKE On-Prem-Konfigurationsdatei, die Sie mit gkectl create-config generiert und geändert haben, damit sie für Ihre Umgebung geeignet ist. Benennen Sie die Kopie um, um einen anderen Dateinamen zu verwenden:

cp [CONFIG_FILE] [NEW_USER_CLUSTER_CONFIG]

Dabei ist [NEW_USER_CLUSTER_CONFIG] der Name, den Sie für die Kopie der Konfigurationsdatei auswählen. In dieser Anleitung nennen wir diese Datei create-user-cluster.yaml.

In create-user-cluster.yaml müssen Sie die folgenden Felder ändern:

  • admincluster, die Spezifikation für den Administratorcluster. Sie entfernen die Spezifikation admincluster vollständig aus der Datei.
  • usercluster, die Spezifikation für einen Nutzercluster.

In den folgenden Abschnitten ändern Sie die Felder admincluster und usercluster von create-user-cluster.yaml und verwenden dann die Datei, um weitere Nutzercluster zu erstellen.

Löschen Sie die Spezifikation admincluster

Wenn Sie zusätzliche Nutzercluster aus dem vorhandenen Administratorcluster erstellen möchten, müssen Sie die gesamte Spezifikation admincluster löschen.

Löschen Sie dazu einfach die Spezifikation und alle zugehörigen Unterfelder.

Sie dürfen weder die usercluster-Spezifikation noch deren Unterfelder löschen.

Ändern Sie die Spezifikation usercluster

Nehmen Sie die in den folgenden Abschnitten beschriebenen Änderungen an den Feldern usercluster vor.

Namen des Nutzerclusters ändern

Ändern Sie den Namen des Nutzerclusters im Feld usercluster.clustername. Neue Nutzercluster sollten sich von den bestehenden Nutzerclustern unterscheiden.

IP-Adressen für die Knoten des Nutzercluster reservieren

Wenn Sie DHCP verwenden, achten Sie darauf, dass Sie genügend IP-Adressen haben, damit die Knoten erstellt werden können.

Für statische IP-Adressen sollten Sie die Datei usercluster.ipblockfilepath ändern, die die vordefinierten IP-Adressen für den Nutzercluster enthält. Sie können auch eine andere statische IP-YAML-Datei mit den gewünschten IP-Adressen angeben.

IP-Adressen für den Load-Balancer reservieren

Wenn Sie den F5 BIG-IP-Load-Balancer verwenden, müssen Sie zwei IP-Adressen für die Steuerungsebene und den eingehenden Traffic des Load-Balancers des Nutzerclusters reservieren. Die entsprechenden Felder sind usercluster.vips.controlplanevip und usercluster.vips.ingressvip.

Maschinenanforderungen ändern (optional)

Wenn Sie möchten, dass die Steuerungsebene oder Worker-Knoten dieses Nutzerclusters eine andere CPU- oder Arbeitsspeichermenge verwendet, oder wenn der Cluster zusätzliche oder weniger Knoten ausführen soll, legen Sie Werte für die folgenden Felder fest.

usercluster.masternode

  • usercluster.masternode.cpus: Anzahl der zu verwendenden CPU-Kerne.
  • usercluster.masternode.memorymb: Anzahl der MB des zu verwendenden Speichers.
  • usercluster.masternode.replicas: Anzahl der Knoten dieses Typs, die ausgeführt werden sollen. Der Wert muss 1 oder 3 sein.

usercluster.workernode

  • usercluster.workernode.cpus: Anzahl der zu verwendenden CPU-Kerne.
  • usercluster.workernode.memorymd: Anzahl der MB des zu verwendenden Speichers.
  • usercluster.workernode.replicas: Anzahl der Knoten dieses Typs, die ausgeführt werden sollen.

vcenter-Spezifikation aktualisieren

Wenn Sie bestimmte Aspekte Ihrer vsphere Umgebung für den neuen Cluster anpassen möchten, können Sie eines der folgenden Felder unter vcenter ändern:

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

Ändern Sie die folgenden Felder nicht:

  • credentials.address
  • datacenter
  • cluster

Nutzercluster erstellen

Nachdem Sie nun eine create-user-cluster.yaml-Datei ausgefüllt haben, können Sie mit dieser Datei einen zusätzlichen Nutzercluster erstellen.

Führen Sie dazu diesen Befehl aus:

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

Dabei gilt:

  • create-user-cluster.yaml ist die von Ihnen erstellte Konfigurationsdatei. Möglicherweise haben Sie einen anderen Namen für diese Datei ausgewählt.
  • [ADMIN_CLUSTER_KUBECONFIG] verweist auf die kubeconfig des vorhandenen Administratorclusters.

Bekannte Probleme

Version 1.1: Beim Erstellen eines zweiten Nutzerclusters tritt ein Fehler auf, wenn ein vSAN-Datastore verwendet wird

Weitere Informationen finden Sie in den Versionshinweisen zu GKE On-Prem.

Problembehebung

Weitere Informationen finden Sie unter Fehlerbehebung.

Clusterprobleme mit gkectl diagnostizieren

Verwenden Sie gkectl diagnose-Befehle, um Clusterprobleme zu identifizieren und Clusterinformationen an Google zu senden. Siehe Clusterprobleme diagnostizieren.

gkectl-Befehle umfassend ausführen

-v5

gkectl-Fehler in stderr protokollieren

--alsologtostderr

gkectl-Logs auf der Administratorworkstation suchen

Auch wenn Sie nicht die Debugging-Flags übergeben, können Sie gkectl-Logs im folgenden Verzeichnis der Administrator-Workstation aufrufen:

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

Cluster-API-Logs im Administratorcluster suchen

Wenn eine VM nach dem Start der Administrator-Steuerungsebene nicht gestartet wird, versuchen Sie, dies durch Untersuchen der Logs der Cluster-API-Controller im Administratorcluster zu beheben:

  1. Suchen Sie im Namespace kube-system den Namen des Cluster-API-Controller-Pods, wobei [ADMIN_CLUSTER_KUBECONFIG] der Pfad zur kubeconfig-Datei des Administratorclusters ist:

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

  2. Öffnen Sie die Logs des Pods, wobei [POD_NAME] der Name des Pods ist. Verwenden Sie optional für die Fehlersuche grep oder ein ähnliches Tool:

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