Die GKE On-Prem API ist eine von Google Cloud gehostete API, mit der Sie den Lebenszyklus Ihrer lokalen Cluster mithilfe von Standardtools verwalten können: der Google Cloud Console, der Google Cloud CLI oder Terraform. Wenn Sie einen Cluster mit einem dieser Tools erstellen, speichert die API Metadaten zum Status des Clusters in der Google Cloud-Region, die Sie beim Erstellen des Clusters angegeben haben.
Mit diesen Metadaten können Sie den Lebenszyklus des Clusters mithilfe der Standardtools verwalten. Wenn Sie diese Tools verwenden möchten, um Clusterdetails anzusehen oder den Lebenszyklus von Clustern zu verwalten, die mit gkectl
erstellt wurden, müssen Sie die Cluster bei der GKE On-Prem API registrieren.
Terminologie
Durch die Registrierung eines Clusters können Sie den Clusterlebenszyklus mithilfe der Console, der gcloud CLI oder Terraform verwalten.
Das Registrieren eines Clusters ist ein separater Vorgang zum Registrieren eines Clusters bei einer Flotte.
Eine Flotte ist eine logische Gruppierung von Kubernetes-Clustern, die Sie zusammen verwalten können. Alle GKE on VMware-Cluster werden beim Erstellen des Clusters bei einer Flotte registriert. Wenn Sie einen Cluster mit gkectl erstellen, wird der Cluster bei dem Google Cloud-Projekt registriert, das Sie in der Clusterkonfigurationsdatei im Feld gkeConnect.projectID
angeben. Dieses Projekt wird als Flotten-Hostprojekt bezeichnet.
Weitere Informationen zu Flotten, einschließlich Anwendungsfällen, Best Practices und Beispielen, finden Sie in der Dokumentation zur Flottenverwaltung.
Registrierte Cluster ansehen
Alle Ihre Flottencluster werden auf den Seiten GKE Enterprise-Cluster und GKE-Cluster in der Console angezeigt. So erhalten Sie einen Überblick über Ihre gesamte Flotte und können bei GKE on VMware sehen, welche Cluster von der GKE On-Prem API verwaltet werden.
So rufen Sie Ihre Flottencluster auf:
-
Rufen Sie in der Console die Seite „GKE Enterprise-Cluster“ auf.
Zur Seite „GKE Enterprise-Cluster“ -
Wählen Sie das Google Cloud-Projekt aus.
- Wenn in der Spalte Typ VMware angezeigt wird, wird der Cluster von der GKE On-Prem API verwaltet.
- Wenn in der Spalte Typ Extern angezeigt wird, wird der Cluster nicht von der GKE On-Prem API verwaltet.
![Liste der GKE Enterprise-Cluster](https://cloud.google.com/static/anthos/clusters/docs/on-prem/latest/images/mixed-clusters-list.png?authuser=3&hl=de)
Voraussetzungen
- Nutzercluster müssen mindestens Version 1.11 sein.
Administratorcluster müssen mindestens Version 1.13 sein.
Wenn Sie kein Projektinhaber sind, benötigen Sie mindestens die Rolle
roles/gkeonprem.admin
der Identity and Access Management für das Projekt. Weitere Informationen zu den in dieser Rolle enthaltenen Berechtigungen finden Sie in der IAM-Dokumentation unter GKE On-Prem-Rollen.
Hinweise
Richten Sie bei Bedarf die gcloud CLI ein.
Informationen zum Installieren der gcloud CLI finden Sie in der Dokumentation zur gcloud CLI.
Aktualisieren Sie bei Bedarf die Komponenten der gcloud CLI:
gcloud components update
Führen Sie die folgenden Schritte aus, um die GKE On-Prem API zu aktivieren und zu verwenden:
Aktivieren Sie die API in Ihrem Projekt:
gcloud services enable \ --project PROJECT_ID \ gkeonprem.googleapis.com
Ersetzen Sie
PROJECT_ID
durch die Projekt-ID Ihres Flotten-Hostprojekts. Das ist die Projekt-ID, die im Abschnittgkeconnect
Ihrer Konfigurationsdatei für den Administratorcluster oder in der Konfigurationsdatei des Nutzerclusters konfiguriert wurde.Wenn Sie den Fehler
PERMISSION_DENIED
erhalten, prüfen Sie die eingegebene Projekt-ID. Wenn die Projekt-ID korrekt ist, führen Siegcloud auth login
aus, um sich mit dem Konto, das Zugriff auf das Projekt hat, in der Google Cloud CLI anzumelden.Wenn Sie die GKE On-Prem API zum ersten Mal in Ihrem Projekt aktiviert haben, müssen Sie die API initialisieren. Rufen Sie dazu einen gcloud CLI-Befehl auf, der verfügbare Versionen anzeigt, mit denen Sie einen Cluster erstellen können:
gcloud container vmware clusters query-version-config \ --project=PROJECT_ID \ --location=REGION
Ersetzen Sie
REGION
durchus-west1
oder eine andere unterstützte Region.
Wenn Ihre Organisation eine Zulassungsliste eingerichtet hat, mit der Traffic von Google APIs und anderen Adressen über Ihren Proxyserver geleitet werden kann, fügen Sie der Zulassungs-Liste Folgendes hinzu:
- gkeonprem.googleapis.com
- gkeonprem.mtls.googleapis.com
Dies sind die Dienstnamen für die GKE On-Prem API.
Nutzercluster registrieren
gcloud-CLI
Scrollen Sie bei Bedarf nach unten, um den Platzhalter ADMIN_CLUSTER_NAME
für das Flag --admin-cluster-membership
auszufüllen.
gcloud container vmware clusters enroll USER_CLUSTER_NAME \ --project=PROJECT_ID \ --admin-cluster-membership=projects/PROJECT_ID/locations/global/memberships/ADMIN_CLUSTER_NAME \ --location=REGION
Ersetzen Sie Folgendes:
USER_CLUSTER_NAME
: Der Name des Nutzerclusters, den Sie registrieren möchten.PROJECT_ID
Die Projekt-ID Ihres Flotten-Hostprojekts.ADMIN_CLUSTER_NAME
: Der Administratorcluster, der den Nutzercluster verwaltet. Der Name des Administratorclusters ist das letzte Segment des vollständig angegebenen Clusternamens, der den Cluster in Google Cloud eindeutig identifiziert.REGION
: Die Google Cloud-Region, in der die GKE On-Prem API ausgeführt wird und Clustermetadaten speichert. Geben Sieus-west1
oder eine andere unterstützte Region an. Die Region kann nach der Registrierung des Clusters nicht mehr geändert werden.
gkectl
Führen Sie auf Ihrer Administratorworkstation die folgenden Schritte aus.
Fügen Sie der Konfigurationsdatei des Nutzerclusters den folgenden Abschnitt hinzu:
gkeOnPremAPI: enabled:true location:REGION
Ersetzen Sie
REGION
durch die Google Cloud-Region, in der die GKE On-Prem API ausgeführt wird und Clustermetadaten speichert. Geben Sieus-west1
oder eine andere unterstützte Region an. Die Region kann nach der Registrierung des Clusters nicht mehr geändert werden.Aktualisieren Sie den Cluster:
gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG_FILE
Ersetzen Sie Folgendes:
ADMIN_CLUSTER_KUBECONFIG
: der Pfad der kubeconfig-Datei des Administratorclusters.USER_CLUSTER_CONFIG_FILE
: der Pfad zur Konfigurationsdatei des Nutzerclusters.
Administratorcluster registrieren
gcloud-CLI
gcloud container vmware admin-clusters enroll ADMIN_CLUSTER_NAME \ --project=PROJECT_ID \ --admin-cluster-membership=projects/PROJECT_ID/locations/global/memberships/ADMIN_CLUSTER_NAME \ --location=REGION
Ersetzen Sie Folgendes:
ADMIN_CLUSTER_NAME
: Der Name des Administratorclusters, den Sie registrieren möchten.PROJECT_ID
Die Projekt-ID Ihres Flotten-Hostprojekts.ADMIN_CLUSTER_NAME
undPROJECT_ID
bilden den vollständig angegebenen Clusternamen für das Flag--admin-cluster-membership
.REGION
: Die Google Cloud-Region, in der die GKE On-Prem API ausgeführt wird und Clustermetadaten speichert. Geben Sieus-west1
oder eine andere unterstützte Region an. Wir empfehlen, die instackdriver.clusterLocation
konfigurierte Region zu verwenden. Die Region kann nach der Registrierung des Clusters nicht mehr geändert werden.
gkectl
Führen Sie auf Ihrer Administratorworkstation die folgenden Schritte aus.
Fügen Sie der Konfigurationsdatei des Administratorclusters den folgenden Abschnitt hinzu:
gkeOnPremAPI: enabled:true location:REGION
Ersetzen Sie
REGION
durch die Google Cloud-Region, in der die GKE On-Prem API ausgeführt wird und Clustermetadaten speichert. Geben Sieus-west1
oder eine andere unterstützte Region an. Wir empfehlen, die instackdriver.clusterLocation
konfigurierte Region zu verwenden. Die Region kann nach der Registrierung des Clusters nicht mehr geändert werden.Aktualisieren Sie den Cluster:
gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE
Ersetzen Sie Folgendes:
ADMIN_CLUSTER_KUBECONFIG
: der Pfad der kubeconfig-Datei des Administratorclusters.ADMIN_CLUSTER_CONFIG_FILE
: der Pfad zur Konfigurationsdatei des Administratorclusters.
Informationen zu Ihrem Cluster abrufen
Nachdem der Cluster registriert wurde, können Sie mit den folgenden Befehlen Informationen zu Ihren Clustern abrufen:
Nutzercluster
- So beschreiben Sie einen Nutzercluster:
gcloud container vmware clusters describe USER_CLUSTER_NAME \ --project=PROJECT_ID \ --location=REGION
- So listen Sie Ihre Nutzercluster auf:
gcloud container vmware clusters list \ --project=PROJECT_ID \ --location=-
Wenn Sie --location=-
festlegen, werden alle Cluster in allen Regionen aufgelistet. Wenn Sie die Liste eingrenzen müssen, legen Sie für --location
die Region fest, die Sie bei der Registrierung des Clusters angegeben haben.
Administratorcluster
- So beschreiben Sie einen Administratorcluster:
gcloud container vmware admin-clusters describe ADMIN_CLUSTER_NAME \ --project=PROJECT_ID \ --location=REGION
- So listen Sie Ihre Administratorcluster auf:
gcloud container vmware admin-clusters list \ --project=PROJECT_ID \ --location=-
Wenn Sie --location=-
festlegen, werden alle Cluster in allen Regionen aufgelistet. Wenn Sie die Liste eingrenzen müssen, legen Sie für --location
die Region fest, die Sie bei der Registrierung des Clusters angegeben haben.
Mit dem Cluster verbinden
Nachdem der Cluster mit der GKE On-Prem API registriert wurde, müssen Sie eine Authentifizierungsmethode auswählen und konfigurieren, damit Sie den Cluster über die Google Cloud Console verwalten können. Mit der ausgewählten Authentifizierungsmethode wird auch der Zugriff auf den Cluster über die Befehlszeile gesteuert. Hier finden Sie weitere Informationen: