In diesem Dokument wird beschrieben, wie Sie ein oder mehrere Google Cloud-Projekte mit einem Cluster in Google Distributed Cloud verknüpfen.
Diese Anleitung ist vollständig. Eine kürzere Einführung in die Verwendung eines Google Cloud-Projekts finden Sie unter Minimale Infrastruktur einrichten.
Hinweise
Installieren Sie Google Cloud CLI.
Flotten-Hostprojekt
Jeder Administratorcluster muss bei einer Flotte registriert sein. Jeder von einem Administratorcluster verwaltete Nutzercluster muss bei derselben Flotte wie der Administratorcluster registriert sein.
Wenn ein Administrator- oder Nutzercluster bei einer Flotte registriert ist, ist er mit einem Flotten-Hostprojekt verknüpft. Ein Administratorcluster und alle von ihm verwalteten Nutzercluster haben dasselbe Flottenhostprojekt. In der Google Cloud Console können Sie im Flotten-Hostprojekt Ihre Administrator- und Nutzercluster ansehen und verwalten.
Wählen Sie ein Google Cloud-Projekt aus, das als Flotten-Hostprojekt dienen soll. Sie können ein vorhandenes Projekt auswählen oder ein neues erstellen. Notieren Sie sich die Projekt-ID. Sie benötigen die ID Ihres Flotten-Hostprojekts in den folgenden Schritten.
APIs im Flotten-Hostprojekt aktivieren
Aktivieren Sie im Flotten-Hostprojekt die erforderlichen APIs:
Linux und macOS
Aktivieren Sie die folgenden APIs im Flotten-Hostprojekt:
gcloud services enable --project FLEET_HOST_PROJECT_ID \
anthos.googleapis.com \
container.googleapis.com \
gkehub.googleapis.com \
gkeconnect.googleapis.com \
connectgateway.googleapis.com \
monitoring.googleapis.com \
kubernetesmetadata.googleapis.com \
logging.googleapis.com \
opsconfigmonitoring.googleapis.com \
serviceusage.googleapis.com \
iam.googleapis.com \
cloudresourcemanager.googleapis.com
Wenn Sie den Lebenszyklus von Clustern in der Google Cloud Console, der Google Cloud CLI oder Terraform verwalten möchten, aktivieren Sie diese zusätzlichen APIs im Flotten-Hostprojekt:
gcloud services enable --project FLEET_HOST_PROJECT_ID \
gkeonprem.googleapis.com \
anthosaudit.googleapis.com \
storage.googleapis.com
Windows
Aktivieren Sie die folgenden APIs im Flotten-Hostprojekt:
gcloud services enable --project FLEET_HOST_PROJECT_ID ^
anthos.googleapis.com ^
container.googleapis.com ^
gkehub.googleapis.com ^
gkeconnect.googleapis.com ^
connectgateway.googleapis.com ^
monitoring.googleapis.com ^
kubernetesmetadata.googleapis.com ^
logging.googleapis.com ^
opsconfigmonitoring.googleapis.com ^
serviceusage.googleapis.com ^
iam.googleapis.com ^
cloudresourcemanager.googleapis.com
Wenn Sie den Lebenszyklus von Nutzerclustern in der Google Cloud Console, der Google Cloud CLI oder Terraform verwalten möchten, aktivieren Sie diese zusätzlichen APIs im Flotten-Hostprojekt:
gcloud services enable --project FLEET_HOST_PROJECT_ID ^
gkeonprem.googleapis.com ^
anthosaudit.googleapis.com ^
storage.googleapis.com
Dienstkonten im Flotten-Hostprojekt Rollen gewähren
Dem Connect-Register-Dienstkonto müssen bestimmte Rollen für das Flotten-Hostprojekt zugewiesen werden. Weitere Informationen finden Sie unter Connect-Register-Dienstkonto.
Dem Logging-Monitoring-Dienstkonto müssen bestimmte Rollen im Hostprojekt der Flotte gewährt werden. Weitere Informationen finden Sie unter Logging-Monitoring-Dienstkonto.
Dem Audit-Logging-Dienstkonto müssen bestimmte Rollen für das Flotten-Hostprojekt gewährt werden. Weitere Informationen finden Sie unter Audit-Logging-Dienstkonto.
Cluster bei einer Flotte registrieren
Sie registrieren einen Cluster bei einer Flotte, wenn Sie den Cluster erstellen. Die Details der Registrierung hängen davon ab, mit welchem Tool Sie den Cluster erstellen:
| Tool | So registrieren Sie sich |
|---|---|
gkectl | Füllen Sie das Feld gkeConnect.projectID in der Clusterkonfigurationsdatei aus. |
| Google Cloud Console | Der Cluster wird automatisch registriert. Das Google Cloud-Projekt, das Sie zum Erstellen des Clusters verwenden, wird zum Flotten-Hostprojekt. |
| Terraform | Füllen Sie das Feld project_id in der .tfvars-Datei aus. |
| gcloud-CLI | Geben Sie beim Aufruf von gcloud container vmware clusters create einen Wert für --project an. |
Projekt zur Nutzungsmessung
Wenn Sie die Nutzungsmessung für einen Nutzercluster aktivieren, speichert Google Distributed Cloud Nutzungsdaten in einem BigQuery-Dataset, das mit einem Google Cloud-Projekt Ihrer Wahl verknüpft ist. Dieses Google Cloud-Projekt wird als Projekt zur Nutzungsmessung bezeichnet.
Das Projekt zur Nutzungsmessung kann dasselbe wie das Flotten-Hostprojekt oder ein anderes sein.
Wenn Sie die Nutzungsmessung aktivieren möchten, müssen Sie die folgenden APIs in Ihrem Projekt zur Nutzungsmessung aktivieren:
Linux und macOS
gcloud services enable --project USAGE_METERING_PROJECT_ID] \
bigquery.googleapis.com \
serviceusage.googleapis.com \
iam.googleapis.com \
cloudresourcemanager.googleapis.com
Windows
gcloud services enable --project USAGE_METERING_PROJECT_ID ^
bigquery.googleapis.com ^
serviceusage.googleapis.com ^
iam.googleapis.com ^
cloudresourcemanager.googleapis.com
Dienstkonten in Ihrem Projekt zur Nutzungsmessung Rollen zuweisen
Ihrem Dienstkonto zur Nutzungsmessung müssen bestimmte Rollen im Projekt zur Nutzungsmessung zugewiesen sein.
Weitere Informationen finden Sie unter Dienstkonto zur Nutzungsmessung.
Übergeordnetes Projekt des Dienstkontos für Ihr Komponenten-Zugriff-Dienstkonto
Bevor Sie einen Cluster erstellen, benötigen Sie ein Dienstkonto, mit dem Google Distributed Cloud Komponenten aus Container Registry herunterladen kann. Dieses Dienstkonto wird als Dienstkonto für den Komponentenzugriff bezeichnet.
Das Google Cloud-Projekt, in dem Sie das Dienstkonto für den Komponentenzugriff erstellt haben, ist das parent Ihres Dienstkontos für den Komponentenzugriff. Dieses Projekt kann mit dem Flotten-Hostprojekt identisch oder unterschiedlich sein. Weitere Informationen zu Dienstkonten und übergeordneten Projekten finden Sie unter Details zu Dienstkonten und Google Cloud-Projekten.
So aktivieren Sie die erforderlichen APIs für das übergeordnete Projekt des Komponenten-Zugriff-Dienstkontos:
Linux und macOS
gcloud services enable --project [PARENT_PROJECT_ID] \
serviceusage.googleapis.com \
iam.googleapis.com \
cloudresourcemanager.googleapis.com
Windows
gcloud services enable --project [PARENT_PROJECT_ID] ^
serviceusage.googleapis.com ^
iam.googleapis.com ^
cloudresourcemanager.googleapis.com
Nächste Schritte
Dienstkonten und Schlüssel erstellen