In Google Distributed Cloud führen Nutzercluster Ihre Arbeitslasten aus und in einer Multi-Cluster-Architektur werden Nutzercluster von einem Administratorcluster erstellt und verwaltet.
Wenn Sie einen Administratorcluster erstellt haben, wird durch Aufrufen des Befehls bmctl create config
eine YAML-Datei erstellt, die Sie zum Definieren des Nutzerclusters bearbeiten können. Zum Anwenden der Konfiguration und zum Erstellen des Nutzerclusters verwenden Sie den Befehl bmctl create cluster
. Preflight-Prüfungen gelten für die Nutzercluster, die mit dem Befehl bmctl create cluster
erstellt wurden.
Durch das Fernhalten der Arbeitslasten vom Administratorcluster schützen Sie vertrauliche administrative Daten wie SSH-Schlüssel, die im Administratorcluster gespeichert sind, vor denjenigen, die keinen Zugriff auf diese Informationen benötigen. Darüber hinaus bietet die Trennung von Nutzerclustern eine gute allgemeine Sicherheit für Ihre Arbeitslasten.
Vorbereitung
- Die neueste
bmctl
wird aus Cloud Storage heruntergeladen (gs://anthos-baremetal-release/bmctl/1.29.100-gke.251/linux-amd64/bmctl
). - Laufender Administratorcluster mit Zugriff auf den Cluster-API-Server (die
controlPlaneVIP
). - Knoten des Administratorclusters haben eine Netzwerkverbindung zu allen Knoten im Zielnutzercluster.
- Die Workstation, auf der
bmctl
ausgeführt wird, hat eine Netzwerkverbindung zu allen Knoten in den Ziel-Nutzerclustern. - Die Administratorworkstation kann eine SSH-Verbindung zu jedem der Knoten des Nutzerclusters herstellen.
- Das Connect-Register-Dienstkonto ist auf dem Administratorcluster für die Verwendung mit Connect konfiguriert.
SELinux aktivieren
Wenn Sie SELinux zum Schutz Ihrer Container aktivieren möchten, müssen Sie darauf achten, dass SELinux auf allen Hostcomputern im Enforced
-Modus aktiviert ist. Ab Google Distributed Cloud-Release 1.9.0 oder höher können Sie SELinux vor oder nach der Clustererstellung oder Clusterupgrades aktivieren oder deaktivieren. SELinux ist in Red Hat Enterprise Linux (RHEL) standardmäßig aktiviert. Wenn SELinux auf Ihren Hostcomputern deaktiviert ist oder Sie sich nicht sicher sind, finden Sie unter Container mit SELinux sichern eine Anleitung zur Aktivierung.
Google Distributed Cloud unterstützt SELinux nur in RHEL-Systemen.
Nutzercluster-Konfigurationsdatei erstellen
Die Konfigurationsdatei zum Erstellen eines Nutzerclusters ist fast identisch mit der Konfigurationsdatei, die zum Erstellen eines Administratorclusters verwendet wird. Der einzige Unterschied besteht darin, dass Sie den Abschnitt mit der Konfiguration der lokalen Anmeldedaten entfernen, damit die Konfigurationsdatei eine gültige Sammlung von Kubernetes-Ressourcen ist. Der Konfigurationsabschnitt befindet sich ganz oben in der Datei unter dem Abschnitt bmctl configuration variables
. Beispiele für Nutzercluster-Konfigurationen finden Sie unter Nutzercluster in den Cluster-Konfigurationsbeispielen.
Standardmäßig übernehmen Nutzercluster ihre Anmeldedaten vom Administratorcluster, der sie verwaltet. Sie können einige oder alle diese Anmeldedaten selektiv überschreiben.
Erstellen Sie mit dem Befehl
bmctl create config
eine Konfigurationsdatei für einen Nutzercluster:bmctl create config -c USER_CLUSTER_NAME
Geben Sie beispielsweise Folgendes aus, um eine Konfigurationsdatei mit dem Namen
user1
für einen Nutzercluster zu erstellen:bmctl create config -c user1
Die Datei wird in
bmctl-workspace/user1/user1.yaml
geschrieben. Der generische Pfad zur Datei lautetbmctl-workspace/CLUSTER NAME/CLUSTER_NAME.yaml
.Bearbeiten Sie die Konfigurationsdatei und nehmen Sie folgende Änderungen vor:
Entfernen Sie die Dateipfade der lokalen Anmeldedaten aus der Konfiguration:
...
gcrKeyPath: (path to GCR service account key)sshPrivateKeyPath: (path to SSH private key, used for node access)gkeConnectAgentServiceAccountKeyPath: (path to Connect agent service account key)gkeConnectRegisterServiceAccountKeyPath: (path to Hub registration service account key)cloudOperationsServiceAccountKeyPath: (path to Cloud Operations service account key)...Ändern Sie die Konfiguration, um den Clustertyp
user
anstelle vonadmin
anzugeben:... spec: # Cluster type. This can be: # 1) admin: to create an admin cluster. This can later be used to create # user clusters. # 2) user: to create a user cluster. Requires an existing admin cluster. # 3) hybrid: to create a hybrid cluster that runs admin cluster # components and user workloads. # 4) standalone: to create a cluster that manages itself, runs user # workloads, but does not manage other clusters. type: user ...
Registrieren Sie Ihre Cluster bei einer Flotte. Geben Sie dazu Ihre Projekt-ID im Feld
gkeConnect.projectID
an. Dieses Projekt wird als Flotten-Hostprojekt bezeichnet.... gkeConnect: projectID: my-project-123 ...
- Optional können Sie der Clusterspezifikation
gkeConnect.location
hinzufügen, um die Google Cloud-Region anzugeben, in der die Flotte und die Connect-Dienste ausgeführt werden. Diese regionale Mitgliedschaft beschränkt den Flottendienst-Traffic auf Ihre Region. Wenn SiegkeConnect.location
in die Clusterspezifikation aufnehmen, muss die angegebene Region mit der inclusterOperations.location
konfigurierten Region übereinstimmen. Wenn die Regionen nicht identisch sind, schlägt die Clustererstellung fehl.
- Optional können Sie der Clusterspezifikation
Wenn die GKE On-Prem API in Ihrem Google Cloud-Projekt aktiviert ist, werden alle Cluster im Projekt automatisch in der in
clusterOperations.location
konfigurierten Region in der GKE On-Prem API registriert.Wenn Sie alle Cluster im Projekt bei der GKE On-Prem API registrieren möchten, führen Sie die Schritte unter Vorbereitung aus, um die GKE On-Prem API im Projekt zu aktivieren und zu verwenden.
Wenn Sie den Cluster nicht bei der GKE On-Prem API registrieren möchten, schließen Sie diesen Abschnitt ein und setzen Sie
gkeOnPremAPI.enabled
auffalse
. Wenn Sie keine Cluster im Projekt registrieren möchten, deaktivieren Siegkeonprem.googleapis.com
(der Dienstname für die GKE On-Prem API) im Projekt. Eine Anleitung finden Sie unter Dienste deaktivieren.
Geben Sie die IP-Adresse des Knotens der Steuerungsebene an.
... # Sample control plane config controlPlane: nodePoolSpec: nodes: - address: 10.200.0.20 ...
Achten Sie darauf, dass die Administrator- und Nutzerclusterspezifikationen für die Load-Balancer-VIPs und Adresspools komplementär sind und sich nicht mit vorhandenen Clustern überschneiden. Das folgende Beispiel zeigt ein Beispielpaar für Administrator- und Nutzerclusterkonfigurationen, in denen Load-Balancing und Adresspools angegeben werden:
... # Sample admin cluster config for load balancer and address pools loadBalancer: vips: controlPlaneVIP: 10.200.0.49 ingressVIP: 10.200.0.50 addressPools: - name: pool1 addresses: - 10.200.0.50-10.200.0.70 ... ... # Sample user cluster config for load balancer and address pools loadBalancer: vips: controlPlaneVIP: 10.200.0.71 ingressVIP: 10.200.0.72 addressPools: - name: pool1 addresses: - 10.200.0.72-10.200.0.90 ...
Der Rest der Nutzercluster-Konfigurationsdateien sind mit der Konfiguration des Administratorclusters identisch.
Geben Sie die Pod-Dichte der Clusterknoten an:
... # NodeConfig specifies the configuration that applies to all nodes in the cluster. nodeConfig: # podDensity specifies the pod density configuration. podDensity: # maxPodsPerNode specifies at most how many pods can be run on a single node. maxPodsPerNode: 110 ...
Für Nutzercluster sind die zulässigen Werte für
maxPodsPerNode
32-250
. Der Standardwert, wenn nichts angegeben ist, lautet110
. Sobald der Cluster erstellt ist, kann dieser Wert nicht mehr aktualisiert werden.Die Pod-Dichte wird auch durch die verfügbaren IP-Ressourcen des Clusters begrenzt. Weitere Informationen finden Sie unter Pod-Netzwerk.
Nutzercluster erstellen
Führen Sie den Befehl bmctl
aus, um die Nutzerclusterkonfiguration anzuwenden und den Cluster zu erstellen:
bmctl create cluster -c USER_CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG
Ersetzen Sie Folgendes:
USER_CLUSTER_NAME
: Der im vorherigen Abschnitt erstellte Clustername.ADMIN_KUBECONFIG
: Der Pfad zur kubeconfig-Datei des Administratorclusters.
Für einen Nutzercluster mit dem Namen user1
und eine kubeconfig-Datei des Administratorclusters mit dem Pfad kubeconfig bmctl-workspace/admin/admin-kubeconfig
würde der Befehl so lauten:
bmctl create cluster -c user1 --kubeconfig bmctl-workspace/admin/admin-kubeconfig
Beispiele für Nutzercluster-Konfigurationen
Beispiele für Nutzercluster-Konfigurationen finden Sie unter Nutzercluster in den Beispielen für Clusterkonfigurationen.