Cluster von Google Cloud in Ihrer Flotte registrieren

Console

1. Rufen Sie in der Google Cloud Console die Seite zum Erstellen des entsprechenden Clusters auf.

   • Wenn Sie einen Autopilot-Cluster erstellen möchten, rufen Sie die Seite Autopilot-Cluster erstellen auf.

     Autopilot-Cluster erstellen

   • Wenn Sie einen regionalen oder zonalen Standardcluster erstellen möchten, rufen Sie die Seite Kubernetes-Cluster erstellen auf.

     Kubernetes-Cluster erstellen

2. Folgen Sie der Anleitung in der GKE-Dokumentation, um die Abschnitte zum Erstellen eines Autopilot-, regionalen Standard- oder zonalen Standard-Clusters über die Google Cloud -Konsole abzuschließen.

3. Klicken Sie im Abschnitt Flottenregistrierung das Kästchen In einer Flotte registrieren an. Standardmäßig basiert der Flottenname auf Ihrer Projekt-ID.

4. Füllen Sie die restlichen Abschnitte aus.

5. Wenn Sie einen Standardcluster erstellen möchten und der registrierte Cluster die Workload Identity-Föderation der Flotte verwenden (empfohlen) soll, klicken Sie im Navigationsbereich auf Sicherheit und prüfen Sie, ob Workload Identity-Föderation für GKE aktivieren /1} ist ausgewählt. Für Autopilot-Cluster ist die Funktion standardmäßig aktiviert.

6. Wenn Sie die Clusterdetails geprüft haben, klicken Sie auf Erstellen, um den Cluster zu erstellen und bei einer Flotte zu registrieren.

gcloud

Für diese Befehle ist die gcloud CLI-Version 450.0.0 oder höher erforderlich.

Wenn Sie einen Cluster mit der Google Cloud CLI registrieren, erhält er standardmäßig einen regionalen Mitgliedschaftsspeicherort.

• Führen Sie den folgenden Befehl aus, um einen neuen GKE Autopilot-Cluster zu erstellen und zu registrieren:

  gcloud container clusters create-auto CLUSTER_NAME --enable-fleet
  

  Ersetzen Sie CLUSTER_NAME durch einen eindeutigen Namen für den Cluster, den Sie erstellen. Dies wird auch der Mitgliedschaftsname des Clusters. Wenn in der ausgewählten Flotte bereits ein Cluster mit diesem Namen vorhanden ist, wird vom Befehl ein Fehler zurückgegeben.

• Führen Sie den folgenden Befehl aus, um einen neuen GKE-Standardcluster mit aktivierter Identitätsföderation von Arbeitslasten für GKE zu erstellen und zu registrieren:

  gcloud container clusters create CLUSTER_NAME --enable-fleet \
  --workload-pool=PROJECT_ID.svc.id.goog
  

  Ersetzen Sie Folgendes:

  • CLUSTER_NAME: Eindeutiger Name für den Cluster, den Sie erstellen. Dies wird auch der Mitgliedschaftsname des Clusters. Wenn in der ausgewählten Flotte bereits ein Cluster mit diesem Namen vorhanden ist, wird vom Befehl ein Fehler zurückgegeben.
  • PROJECT_ID: Die Google Cloud Projekt-ID für das Projekt, das Ihren neuen Cluster enthält.

  Wenn Sie einen Standardcluster erstellen, empfehlen wir, den Cluster mit aktivierter Workload Identity-Föderation für GKE zu erstellen, da dadurch die Workload Identity-Föderation der Flotte für Ihren registrierten Cluster aktiviert wird. Sie können das Flag --workload-pool jedoch weglassen, wenn Sie diese Funktion nicht verwenden möchten. Für Autopilot-Cluster ist die Identitätsförderung von Arbeitslasten für GKE standardmäßig aktiviert.

Je nach Cluster, den Sie erstellen möchten, können Sie auch eine der anderen Optionen zum Erstellen einesZonalen Standard-, Regionaler Standard- oderAutopilot Cluster angeben. Möglicherweise müssen Sie auch eine Compute Engine-Zone angeben, wenn Sie keine Standardzone für die Google Cloud CLI konfiguriert haben, und ein Google Cloud Projekt für den Cluster, wenn Sie kein Standardprojekt konfiguriert haben.

Weitere Informationen zum Erstellen verschiedener Arten von GKE-Cluster-Clustern

Terraform

Sie können GKE-Cluster mit Terraform über den Anbieter google erstellen und registrieren. Eine vollständige Referenz für die Ressource google_container_cluster, die zum Verwalten eines GKE-Cluster verwendet wird, finden Sie in der Terraform-Registry.

Erstellen Sie ein Dienstkonto, das Terraform verwenden kann, wie in den Voraussetzungen beschrieben, bevor Sie diese Anleitung befolgen.

Fügen Sie Ihrer Terraform-Konfiguration die folgenden Blöcke hinzu, um einen neuen Cluster zu erstellen und zu registrieren.

1. Geben Sie den google-Anbieter als erforderlichen Anbieter an:

   terraform {
     required_providers {
       google = {
         source = "hashicorp/google"
         version = "VERSION"
       }
     }
   }
   

   Ersetzen Sie VERSION durch 5.6.0 oder höher.

2. Neuen Cluster erstellen und registrieren

   resource "google_container_cluster" "TF_CLUSTER_RESOURCE_NAME" {
     provider = google
     name               = "CLUSTER_NAME"
     location           = "ZONE"
     initial_node_count = 1
     fleet {
       project = "FLEET_HOST_PROJECT"
     }
   }
   

   Ersetzen Sie Folgendes:

   • TF_CLUSTER_RESOURCE_NAME: Ein eindeutiger Name für die neue google_container_cluster-Ressource, die Sie erstellen.
   • CLUSTER_NAME: Ein eindeutiger Name für den neuen GKE-Cluster, den Sie erstellen und registrieren möchten.
   • ZONE: Die Zone für Ihre GKE-Clusterressource. Beispiel: us-central1-a
   • FLEET_HOST_PROJECT: die Google Cloud Projekt-ID, in der Sie den Cluster erstellen und registrieren. Wenn dies nicht festgelegt ist, wird der Cluster nicht bei einer Flotte registriert. Geben Sie eine andere Projekt-ID an, wenn Sie den Cluster für eine Flotte in einem anderen Projekt registrieren möchten.

Console

Wenn Ihr Cluster die Identitätsföderation von Arbeitslasten für Flotten verwenden soll (empfohlen), muss Workload Identity Federation for GKE im Cluster aktiviert sein, bevor Sie dieser Anleitung folgen. Für Autopilot-Cluster ist die Identitätsförderung von Arbeitslasten für GKE standardmäßig aktiviert. Bei Clustern mit Workload Identity-Föderation für GKE ist die Flotten-Workload Identity-Föderation automatisch aktiviert, wenn Sie sie über die Google Cloud Console registrieren.

1. Rufen Sie in der Google Cloud Console die Seite GKE-Cluster auf.

   Zur GKE-Clusterseite.

2. Klicken Sie neben dem nicht registrierten Cluster auf Registrieren, um ihn Ihrer Flotte hinzuzufügen.

3. Klicken Sie im angezeigten Bestätigungsdialogfeld noch einmal auf Registrieren.

gcloud

Für diese Befehle ist die gcloud CLI-Version 450.0.0 oder höher erforderlich.

Wenn Sie einen Cluster mit der Google Cloud CLI registrieren, erhält er standardmäßig einen regionalen Mitgliedschaftsspeicherort.

Mit beiden Befehlen wird die Workload Identity-Föderation für Flotten für den Cluster aktiviert, wenn für den Cluster bereits die Workload Identity-Föderation für GKE aktiviert ist.

• Führen Sie den folgenden Befehl aus, um einen vorhandenen GKE-Cluster in Google Cloud bei der Flotte seines Projekts zu registrieren:

  gcloud container clusters update CLUSTER_NAME --enable-fleet
  

  Ersetzen Sie CLUSTER_NAME durch den Namen des Clusters, den Sie registrieren. Dies wird auch der Mitgliedschaftsname des Clusters.

• Wenn Sie den Cluster in einer Flotte in einem anderen Projekt registrieren möchten, verwenden Sie das Flag --fleet-project, wie unten gezeigt. Achten Sie darauf, dass Sie die erforderlichen Berechtigungen für die projektübergreifende Registrierung eingerichtet haben, bevor Sie diesen Befehl ausführen.

  gcloud container clusters update CLUSTER_NAME --fleet-project=PROJECT_ID_OR_NUMBER
  

  • Ersetzen Sie CLUSTER_NAME durch den Namen des Clusters, den Sie registrieren. Dies wird auch der Mitgliedschaftsname des Clusters.
  • Ersetzen Sie PROJECT_ID_OR_NUMBER durch die Projekt-ID oder Projektnummer des ausgewählten Flotten-Hostprojekts.

Terraform

Sie können GKE-Cluster über den Anbieter google bei Terraform registrieren. Eine vollständige Referenz für die Ressource google_container_cluster, die zum Verwalten eines GKE-Cluster verwendet wird, finden Sie in der Terraform-Registry.

Erstellen Sie ein Dienstkonto, das Terraform verwenden kann, wie in den Voraussetzungen beschrieben, bevor Sie diese Anleitung befolgen.

Vorhandenen Cluster registrieren

Fügen Sie den folgenden Block der google_container_cluster-Ressourcenkonfiguration Ihres Clusters hinzu, um einen vorhandenen Cluster zu registrieren:

fleet {
        project = "FLEET_HOST_PROJECT"
      }

Ersetzen Sie FLEET_HOST_PROJECT durch die Google Cloud Projekt-ID, zu der Ihr Cluster gehört, oder durch eine andere Projekt-ID, wenn Sie den Cluster in einem anderen Projekt für eine Flotte registrieren möchten.

Workload Identity-Föderation für GKE in einem registrierten Cluster aktivieren

Sie können Terraform verwenden, um die Identitätsföderation von Arbeitslasten für GKE für einen Cluster zu aktivieren.

Fügen Sie den folgenden Block in der google_container_cluster Ressourcenkonfiguration des entsprechenden Clusters hinzu, um Workload Identity-Föderation für GKE für Ihren neuen oder vorhandenen Cluster zu aktivieren:

  workload_identity_config {
    workload_pool = "PROJECT_ID.svc.id.goog"
  }
  ```

 Replace <code><var>PROJECT_ID</var></code> with the Google Cloud project ID for your Terraform resources.

Config Connector

Wenn Sie das Config Connector-Add-on installiert haben, können Sie zum Registrieren von GKE-Clustern Config Connector verwenden. Prüfen Sie, ob Sie eine Version von Config Connector höher als 1.47.0 haben und ein Dienstkonto erstellt haben, wie in den Voraussetzungen beschrieben.

Eine vollständige Referenz für die Ressource GKEHubMembership finden Sie in der Config Connector-Referenz.

GKE-Cluster registrieren

Um den Cluster zu registrieren, geben Sie zuerst an, wo Sie Ihre Ressourcen erstellen möchten. Folgen Sie dazu der Anleitung im Config Connector-Leitfaden. Erstellen Sie dann eine YAML-Datei, um einen Cluster zu registrieren und optional einen zu erstellen:

GKE-Cluster erstellen und registrieren

1. Erstellen Sie einen GKE-Cluster, wie im folgenden einfachen Beispiel gezeigt:

   apiVersion: container.cnrm.cloud.google.com/v1beta1
   kind: ContainerCluster
   metadata:
     name: CLUSTER_NAME
   spec:
     location: LOCATION
     initialNodeCount: 1
   

   Dabei gilt:

   • CLUSTER_NAME: Der Name, den Sie ausgewählt haben, um den mit Config Connector erstellten Cluster eindeutig darzustellen.
   • LOCATION: Die Zone oder Region, die Sie zur Bereitstellung der GKE-Clusterressource ausgewählt haben. Beispiel: us-central1-a.

   Eine vollständige Liste der Optionen beim Erstellen eines GKE-Clusters mit Config Connector finden Sie in der Config Connector-Dokumentation.

2. Registrieren Sie eine Mitgliedschaft für den GKE-Cluster.

   apiVersion: gkehub.cnrm.cloud.google.com/v1beta1
   kind: GKEHubMembership
   metadata:
     name: MEMBERSHIP_NAME
   spec:
     location: MEMBERSHIP_LOCATION
     endpoint:
       gkeCluster:
         resourceRef:
           name: CLUSTER_NAME
   

   Dabei gilt:

   • MEMBERSHIP_NAME: Der Name der Mitgliedschaft, den Sie für den Cluster ausgewählt haben, der für die Flotte registriert wird.
   • MEMBERSHIP_LOCATION: der Standort des Flottendienstes, den Sie die Mitgliedschaft Ihres Clusters verwalten lassen möchten. Das kann der Standort des Clusters selbst (empfohlen) oder global sein. Weitere Informationen Sie können keinen anderen Standort als den des Clusters angeben. Andernfalls schlägt die Registrierung fehl.
   • CLUSTER_NAME: Der Name, den Sie ausgewählt haben, um den mit Config Connector erstellten Cluster eindeutig darzustellen.

Cluster in einem anderen Projekt registrieren

Fügen Sie Folgendes zum Feld metadata der Ressource GKEHubMembership hinzu, um einen Cluster in einer Flotte in einem anderen Projekt zu registrieren.

   metadata:
     annotations:
       cnrm.cloud.google.com/project-id: FLEET_PROJECT_ID

Dabei gilt:

• FLEET_PROJECT_ID: Flotten-Hostprojekt, das Sie zum Registrieren des GKE-Clusters ausgewählt haben.

Vorhandenen Cluster registrieren

Verwenden Sie die folgende Konfiguration, wenn Sie einen vorhandenen Cluster registrieren möchten, unabhängig davon, wie er erstellt wurde. In diesem Fall müssen Sie den vollständigen Ressourcennamen des Clusters angeben, damit Config Connector ihn finden kann. Ersetzen Sie das Feld resourceRef der Ressource GKEHubMembership durch:

   resourceRef:
     external: //container.googleapis.com/CLUSTER_RESOURCE_NAME

Ersetzen Sie Folgendes:

• CLUSTER_RESOURCE_NAME: Der Google Cloud Ressourcennamen für den GKE-Cluster. Beispiel: projects/my-project/zones/us-west1-a/clusters/my-cluster.

Wenn der Cluster mit Config Connector erstellt wurde, müssen Sie nicht den voll qualifizierten Clusternamen angeben.

Workload Identity-Föderation für GKE in einem registrierten Cluster aktivieren

Das Aktivieren der Identitätsföderation von Arbeitslasten für GKE verwendet dieselbe Konfiguration wie die Registrierung eines Clusters, mit folgenden zusätzlichen Schritten.

1. Aktivieren Sie die Identitätsföderation von Arbeitslasten für GKE. Fügen Sie dazu im Feld spec der Ressource ContainerCluster Folgendes hinzu: Dies gilt sowohl für neue als auch für bestehende Cluster.

   spec:
     workloadIdentityConfig:
       workloadPool: PROJECT_ID.svc.id.goog
   

   Dabei gilt:

   • PROJECT_ID: Das Standardprojekt, das Sie über die Namespace-Annotation ausgewählt haben, um Ihre GKE-Clusterressource zu erstellen.

2. Aktivieren Sie Workload Identity Föderation der Flotte und fügen Sie dazu im Feld spec des Ressourcenblocks GKEHubMembership Folgendes hinzu:

   spec:
     authority:
       issuer: https://container.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_NAME
   }
   

   Ersetzen Sie Folgendes:

   • PROJECT_ID: Das Standardprojekt, das Sie über die Namespace-Annotation ausgewählt haben, um Ihre GKE-Clusterressource zu erstellen.
   • LOCATION: Die Zone oder Region, die Sie zur Bereitstellung der GKE-Clusterressource ausgewählt haben. Beispiel: us-central1-a.
   • CLUSTER_NAME: Der Name, den Sie ausgewählt haben, um den von Ihnen erstellten Cluster eindeutig darzustellen.