Cluster konfigurieren, der von der Anthos On-Prem API verwaltet werden soll

Die Anthos 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 Clusterstatus 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 mit diesen Tools Clusterdetails ansehen oder den Lebenszyklus von Clustern verwalten möchten, die mit bmctl erstellt wurden, müssen Sie die Cluster in der Anthos On-Prem API registrieren.

Terminologie

Durch die Registrierung eines Clusters können Sie den Clusterlebenszyklus mithilfe der Console, der gcloud CLI oder Terraform verwalten.

Die Registrierung eines Clusters ist ein separater Prozess, um einen Cluster in einer Flotte zu registrieren. Eine Flotte ist eine logische Gruppierung von Kubernetes-Clustern, die Sie zusammen verwalten können. Alle Anthos-Cluster auf Bare Metal werden beim Erstellen des Clusters für eine Flotte registriert. Wenn Sie einen Cluster mit bmctl erstellen, wird der Cluster für das Google Cloud-Projekt registriert, das Sie im Feld gkeConnect.projectID in der Clusterkonfigurationsdatei 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 Flottencluster werden auf den Seiten Anthos-Cluster und GKE-Cluster in der Console angezeigt. Dadurch erhalten Sie einen Überblick über Ihre gesamte Flotte und für Anthos-Cluster auf Bare Metal können Sie sehen, welche Cluster von der Anthos On-Prem API verwaltet werden.

So rufen Sie Ihre Flottencluster auf:

Rufen Sie in der Console die Seite "Anthos-Cluster" auf.
Zur Seite „Anthos-Cluster“
Wählen Sie das Google Cloud-Projekt aus.
- Wenn in der Spalte Typ der Eintrag Anthos (Bare Metal) angezeigt wird, wird der Cluster von der Anthos On-Prem API verwaltet.
- Wenn in der Spalte Typ der Eintrag Extern angezeigt wird, wird der Cluster nicht von der Anthos On-Prem API verwaltet.

Voraussetzungen

Nur Nutzer- und Administratorcluster können mit der Anthos On-Prem API registriert werden. Die Registrierung von Hybrid- und eigenständigen Clustern wird nicht unterstützt.
Version 1.13 oder höher.
Wenn Ihre Organisation eine Zulassungsliste eingerichtet hat, die Traffic von Google APIs und anderen Adressen über Ihren Proxyserver weiterleiten kann, fügen Sie der Zulassungsliste Folgendes hinzu:
- gkeonprem.googleapis.com
- gkeonprem.mtls.googleapis.com
Dies sind die Dienstnamen für die Anthos On-Prem API.
Wenn Sie kein Projektinhaber sind, muss Ihnen für das Projekt mindestens die Rolle „Identity and Access Management“ roles/gkeonprem.admin zugewiesen worden sein. Weitere Informationen zu den in dieser Rolle enthaltenen Berechtigungen finden Sie in der IAM-Dokumentation unter GKE On-Prem-Rollen.

Nutzercluster registrieren

So registrieren Sie einen Cluster für die Verwaltung durch die Anthos On-Prem API:

Sie benötigen die neueste Version der gcloud CLI, einschließlich der Beta-Komponenten der gcloud CLI.
1. Wenn Sie die Betakomponenten noch nicht haben, installieren Sie sie mit dem folgenden Befehl:
```
gcloud components install beta
```
2. Aktualisieren Sie bei Bedarf die gcloud CLI-Komponenten:
```
  gcloud components update
```
Aktivieren Sie die Anthos On-Prem API im Flottenhostprojekt:
```
gcloud services enable \
    --project FLEET_HOST_PROJECT_ID \
    gkeonprem.googleapis.com
```
Ersetzen Sie FLEET_HOST_PROJECT_ID durch die Projekt-ID Ihres Flotten-Hostprojekts. Dies ist die Projekt-ID, die im Abschnitt gkeconnect Ihrer Clusterkonfigurationsdatei konfiguriert wurde.
Registrieren Sie den Cluster mit der Anthos On-Prem API:
Nutzercluster
Scrollen Sie bei Bedarf, um den Platzhalter ADMIN_CLUSTER_NAME für das Flag --admin-cluster-membership auszufüllen.
```
gcloud beta container bare-metal clusters enroll USER_CLUSTER_NAME  \
  --project=FLEET_HOST_PROJECT_ID \
  --admin-cluster-membership=projects/FLEET_HOST_PROJECT_ID/locations/global/memberships/ADMIN_CLUSTER_NAME \
  --location=LOCATION
```
Ersetzen Sie Folgendes:
- USER_CLUSTER_NAME: Der Name des Nutzerclusters, den Sie registrieren möchten.
- FLEET_HOST_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.
- LOCATION: Die Google Cloud-Region, in der die Anthos On-Prem API ausgeführt wird. Geben Sie us-west1 oder eine andere unterstützte Region an. Die Region kann nach der Registrierung des Clusters nicht mehr geändert werden. Zusätzlich zum Festlegen der Region, in der die Anthos On-Prem API ausgeführt wird, ist dies die Region, in der Folgendes gespeichert wird:
  - Die Nutzercluster-Metadaten, die die Anthos On-Prem API zum Verwalten des Clusterlebenszyklus benötigt
  - Cloud Logging- und Cloud Monitoring-Daten von Systemkomponenten
  - Das von Cloud-Audit-Logs erstellte Administrator-Audit-Log
Administratorcluster
```
gcloud beta container bare-metal admin-clusters enroll ADMIN_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --admin-cluster-membership=projects/FLEET_HOST_PROJECT_ID/locations/global/memberships/ADMIN_CLUSTER_NAME \
  --location=LOCATION
```
Ersetzen Sie Folgendes:
- ADMIN_CLUSTER_NAME: Der Name des Administratorclusters, den Sie registrieren möchten.
- FLEET_HOST_PROJECT_ID Die Projekt-ID Ihres Flotten-Hostprojekts.
  
  Die ADMIN_CLUSTER_NAME und FLEET_HOST_PROJECT_ID werden verwendet, um den vollständig angegebenen Clusternamen für das Flag --admin-cluster-membership zu bilden.
- LOCATION: Die Google Cloud-Region, in der die Anthos On-Prem API ausgeführt wird. Geben Sie us-west1 oder eine andere unterstützte Region an. Die Region kann nach der Registrierung des Clusters nicht mehr geändert werden. Zusätzlich zum Festlegen der Region, in der die Anthos On-Prem API ausgeführt wird, ist dies die Region, in der Folgendes gespeichert wird:
  - Die Clustermetadaten, die die Anthos On-Prem API zum Verwalten des Clusterlebenszyklus benötigt
  - Cloud Logging- und Cloud Monitoring-Daten von Systemkomponenten
  - Das von Cloud-Audit-Logs erstellte Administrator-Audit-Log

Nachdem der Cluster registriert wurde, können Sie mit den folgenden Befehlen Informationen zu Ihren Clustern abrufen:

Nutzercluster

So beschreiben Sie einen Nutzercluster:

gcloud beta container bare-metal clusters describe USER_CLUSTER_NAME \
   --project=FLEET_HOST_PROJECT_ID \
   --location=LOCATION

So listen Sie Nutzercluster auf:

gcloud beta container bare-metal clusters list \
   --project=FLEET_HOST_PROJECT_ID \
   --location=LOCATION

Administratorcluster

So beschreiben Sie einen Administratorcluster:

gcloud beta container bare-metal admin-clusters describe ADMIN_CLUSTER_NAME \
   --project=FLEET_HOST_PROJECT_ID \
   --location=LOCATION

So rufen Sie Ihre Administratorcluster auf:

gcloud beta container bare-metal admin-clusters list \
   --project=FLEET_HOST_PROJECT_ID \
   --location=LOCATION

Mit dem Cluster verbinden

Nachdem der Cluster bei der Anthos 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. Die ausgewählte Authentifizierungsmethode steuert außerdem den Zugriff auf den Cluster über die Befehlszeile. Hier finden Sie weitere Informationen: