Nutzercluster erstellen

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.

  1. 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 lautet bmctl-workspace/CLUSTER NAME/CLUSTER_NAME.yaml.

  2. 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 von admin 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 Sie gkeConnect.location in die Clusterspezifikation aufnehmen, muss die angegebene Region mit der in clusterOperations.location konfigurierten Region übereinstimmen. Wenn die Regionen nicht identisch sind, schlägt die Clustererstellung fehl.
    • 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 auf false. Wenn Sie keine Cluster im Projekt registrieren möchten, deaktivieren Sie gkeonprem.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, lautet 110. 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.