Knotenpools erstellen und verwalten

Auf dieser Seite wird beschrieben, wie Sie Google Distributed Cloud-Knotenpoolressourcen in einer Distributed Cloud Connected-Zone erstellen und verwalten.

Auf Distributed Cloud Connected-Servern werden Knotenpools automatisch erstellt und gefüllt, wenn Sie einen Cluster erstellen. Sie haben auch die Möglichkeit, nach dem Erstellen des Clusters zusätzliche Knotenpools zu konfigurieren.

Weitere Informationen zu Distributed Cloud-Knotenpools finden Sie unter Funktionsweise von Distributed Cloud Connected.

Hinweis: Bei der Anleitung für die Google Cloud CLI auf dieser Seite wird davon ausgegangen, dass Sie Cloud Shell oder eine andere Umgebung verwenden, in der bash installiert ist.

Knotenpool erstellen

Führen Sie die Schritte in diesem Abschnitt aus, um einen Distributed Cloud-Knotenpool zu erstellen.

Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Rollen in Ihrem Google Cloud Projekt:

• Rolle „Edge-Container-Administrator“ (roles/edgecontainer.admin)

• Rolle „Nutzer von Edge-Container-Maschinen“ (roles/edgecontainer.machineUser)

  Sie benötigen diese Rolle auch für das Google Cloud Projekt, das die Distributed Cloud Connected-Maschinen enthält, die diesem Knotenpool zugewiesen werden, wenn sich dieses Projekt von dem Google Cloud Projekt unterscheidet, in dem Sie den Knotenpool erstellen.

Console

Wenn Sie die Google Cloud Console verwenden, können Sie einen Knotenpool nur erstellen, wenn Sie einen Cluster erstellen. Wenn Sie einen eigenständigen Knotenpool erstellen möchten, müssen Sie die Google Cloud CLI oder die Distributed Cloud Edge Container API verwenden.

gcloud

Führen Sie den Befehl gcloud edge-cloud container clusters node-pools create aus:

gcloud edge-cloud container clusters node-pools create POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME \
    --node-location=ZONE_NAME \
    --node-count=NODE_COUNT \
    --node-labels=NODE_LABELS \
    --machine-filter=MACHINE_FILTER \
    --local-disk-kms-key=POOL_KMS_KEY \
    --node-storage-schema=WORKER_NODE_STORAGE_SCHEMA

Ersetzen Sie Folgendes:

• POOL_NAME: ein beschreibender Name, der diesen Knotenpool eindeutig identifiziert. Dieser Name muss RFC 1213-konform sein und darf nur aus kleingeschriebenen alphanumerischen Zeichen und Bindestrichen (-) bestehen. Er muss mit einem alphanumerischen Zeichen beginnen und enden.
• PROJECT_ID: die ID des Ziel Google Cloud projekts.
• REGION: die Google Cloud Region, in der der Zielcluster von Distributed Cloud Connected für diesen Knotenpool gehostet wird.
• CLUSTER_NAME: der Name des Zielclusters von Distributed Cloud Connected.
• ZONE_NAME: der Name der Zielzone von Distributed Cloud. Diese Zone muss sich in der in REGION angegebenen Region befinden.
• NODE_COUNT: die Anzahl der Knoten, die dieser Knotenpool enthält.
• NODE_LABELS: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Labels für die einzelnen Knoten im Knotenpool enthalten.
• MACHINE_FILTER (optional): gibt die Filterkriterien für die Maschinenauswahl an. Unter Informationen zu einer Maschine abrufen finden Sie die Felder, nach denen Sie filtern können. Nur Maschinen, die diesem Filter entsprechen, können diesem Knotenpool beitreten. Bei Clustern mit mehreren Racks geben Sie mit diesem Flag die Distributed Cloud Connected-Racks an, deren Knoten diesen Knotenpool bilden. Wenn Sie dieses Flag weglassen, werden alle verfügbaren Knoten in der Zone diesem Knotenpool hinzugefügt.

• POOL_KMS_KEY (optional): der vollständige Pfad zum Cloud KMS-Schlüssel, den Sie mit diesem Knotenpool verwenden möchten. Beispiel:

  /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
  

  Dieses Flag gilt nur, wenn Sie Distributed Cloud Connected in Cloud Key Management Service eingebunden haben, wie unter Unterstützung für vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) für lokalen Speicher aktivieren beschrieben.

• WORKER_NODE_STORAGE_SCHEMA (optional): gibt das lokale Speicherschema für die Worker-Knoten an, die in diesem Knotenpool enthalten sind. Weitere Informationen finden Sie unter Lokale Speicherschemas konfigurieren.

API

Senden Sie eine POST-Anfrage an die Methode projects.locations.clusters.nodePools.create:

POST /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME?nodePoolId=NODEPOOL_ID&requestId=REQUEST_ID
{
 "name": POOL_NAME,
 "labels": { LABELS,
  },
 "nodeLocation": ZONE_NAME,
 "nodeCount": NODE_COUNT,
 "nodeLabels": NODE_LABELS,
 "machineFilter": MACHINE_FILTER,
 "localDiskEncryption": {
   "kmsKey": POOL_KMS_KEY,
  }
}

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des Ziel Google Cloud projekts.
• REGION: die Google Cloud Region, in der der Zielcluster von Distributed Cloud Connected für diesen Knotenpool gehostet wird.
• CLUSTER_NAME: der Name des Zielclusters von Distributed Cloud Connected.
• NODEPOOL_ID: eine eindeutige programmatische ID, die diese Knotenpoolressource identifiziert.
• REQUEST_ID: eine eindeutige programmatische ID, die diese Anfrage identifiziert.
• POOL_NAME: ein beschreibender Name, der diesen Knotenpool eindeutig identifiziert.
• LABELS: eine Liste von Labels, die auf diese Knotenpoolressource angewendet werden sollen.
• ZONE_NAME: der Name der Zielzone von Distributed Cloud Connected. Diese Zone muss sich in der in REGION angegebenen Region befinden.
• NODE_COUNT: die Anzahl der Knoten, die dieser Knotenpool enthält.
• NODE_LABELS: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Labels für die einzelnen Knoten im Knotenpool enthalten.
• MACHINE_FILTER (optional): gibt die Filterkriterien für die Maschinenauswahl an. Nur Maschinen, die diesem Filter entsprechen, können diesem Knotenpool beitreten. Bei Clustern mit mehreren Racks geben Sie mit diesem Flag die Distributed Cloud Connected-Racks an, deren Knoten diesen Knotenpool bilden. Wenn Sie dieses Flag weglassen, werden alle verfügbaren Knoten in der Zone diesem Knotenpool hinzugefügt.

• POOL_KMS_KEY (optional): der vollständige Pfad zum Cloud KMS-Schlüssel, den Sie mit diesem Knotenpool verwenden möchten. Beispiel:

  /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
  

  Dieser Parameter gilt nur, wenn Sie Distributed Cloud Connected in Cloud Key Management Service eingebunden haben, wie unter Unterstützung für vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) für lokalen Speicher aktivieren beschrieben.

Knotenpools auflisten

Führen Sie die Schritte in diesem Abschnitt aus, um die in einer Distributed Cloud Connected-Zone verfügbaren Distributed Cloud-Knotenpools aufzulisten.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Container-Betrachter“ (roles/edgecontainer.viewer) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud container clusters node-pools list aus:

gcloud edge-cloud container clusters node-pools list \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des Ziel Google Cloud projekts.
• REGION: die Google Cloud Region, in der der Zielcluster von Distributed Cloud Connected erstellt wurde.
• CLUSTER_NAME: der Name des Zielclusters von Distributed Cloud Connected.

API

Senden Sie eine GET-Anfrage an die Methode projects.locations.clusters.nodePools.list:

GET /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des Ziel Google Cloud projekts.
• REGION: die Google Cloud Region, in der der Zielcluster von Distributed Cloud Connected erstellt wurde.
• CLUSTER_NAME: der Name des Zielclusters von Distributed Cloud.
• FILTER: ein Ausdruck, der die zurückgegebenen Ergebnisse auf bestimmte Werte beschränkt.
• PAGE_SIZE: die Anzahl der Ergebnisse, die pro Seite zurückgegeben werden sollen.
• SORT_BY: eine durch Kommas getrennte Liste von Feldnamen, nach denen die zurückgegebenen Ergebnisse sortiert werden. Die Standardsortierreihenfolge ist aufsteigend. Für eine absteigende Sortierreihenfolge stellen Sie dem gewünschten Feld ~ voran.
• PAGE_TOKEN: ein Token, das in der Antwort auf die letzte Listenanfrage im Feld nextPageToken enthalten ist. Senden Sie dieses Token, um eine Seite mit Ergebnissen zu erhalten.

Informationen zu einem Knotenpool abrufen

Führen Sie die Schritte in diesem Abschnitt aus, um Informationen zu einem Distributed Cloud-Knotenpool abzurufen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Container-Betrachter“ (roles/edgecontainer.viewer) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud container clusters node-pools describe aus:

gcloud edge-cloud container clusters node-pools describe POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

Ersetzen Sie Folgendes:

• POOL_NAME: der Name des Zielknotenpools.
• PROJECT_ID: die ID des Ziel Google Cloud projekts.
• REGION: die Google Cloud Region, in der der mit diesem Knoten pool verknüpfte Cluster von Distributed Cloud Connected gehostet wird.
• CLUSTER_NAME: der Name des Zielclusters von Distributed Cloud Connected.

API

Senden Sie eine GET-Anfrage an die Methode projects.locations.clusters.nodePools.get:

GET /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools/POOL_NAME

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des Ziel Google Cloud projekts.
• REGION: die Google Cloud Region, in der der mit diesem Knoten pool verknüpfte Cluster von Distributed Cloud Connected gehostet wird.
• CLUSTER_NAME: der Name des Zielclusters von Distributed Cloud Connected.
• POOL_NAME: der Name des Zielknotenpools.

Knotenpool ändern

Führen Sie die Schritte in diesem Abschnitt aus, um einen Distributed Cloud-Knotenpool zu ändern.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Container-Administrator“ (roles/edgecontainer.admin) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud container clusters node-pools update aus:

gcloud edge-cloud container clusters node-pools update POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME \
    --node-count=NODE_COUNT \
    --machine-filter=MACHINE_FILTER \
    --local-disk-kms-key=POOL_KMS_KEY

Ersetzen Sie Folgendes:

• POOL_NAME: der Name des Zielknotenpools.
• PROJECT_ID: die ID des Ziel Google Cloud projekts.
• REGION: die Google Cloud Region, in der der mit diesem Knoten pool verknüpfte Cluster von Distributed Cloud Connected gehostet wird.
• CLUSTER_NAME: der Name des Zielclusters von Distributed Cloud Connected.
• NODE_COUNT: die Anzahl der Knoten, die dieser Knotenpool enthält.
• MACHINE_FILTER (optional): gibt die Filterkriterien für die Maschinenauswahl an. Unter Informationen zu einer Maschine abrufen finden Sie die Felder, nach denen Sie filtern können. Bei Clustern mit mehreren Racks geben Sie mit diesem Flag die Distributed Cloud Connected-Racks an, deren Knoten diesen Knotenpool bilden.

• POOL_KMS_KEY (optional): der vollständige Pfad zum Cloud KMS-Schlüssel, den Sie mit diesem Knotenpool verwenden möchten. Beispiel:

  /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
  

  Dieses Flag gilt nur, wenn Sie Distributed Cloud Connected in Cloud Key Management Service eingebunden haben, wie unter Unterstützung für vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) für lokalen Speicher aktivieren beschrieben.

  Wenn Sie für einen Knotenpool wieder einen Google-owned and Google-managed encryption keyverwenden möchten, verwenden Sie das --use-google-managed-key Flag.

API

Senden Sie eine PATCH-Anfrage an die Methode projects.locations.clusters.nodePools.patch:

PATCH /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME?nodePoolId=NODEPOOL_ID&requestId=REQUEST_ID
{
 "name": POOL_NAME,
 "labels": { LABELS,
  },
 "nodeLocation": ZONE_NAME,
 "nodeCount": NODE_COUNT,
 "machineFilter": MACHINE_FILTER,
 "localDiskEncryption": {
   "kmsKey": KMS_KEY,
  }
}

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des Ziel Google Cloud projekts.
• REGION: die Google Cloud Region, in der der mit diesem Knoten pool verknüpfte Cluster von Distributed Cloud Connected gehostet wird.
• CLUSTER_NAME: der Name des Zielclusters von Distributed Cloud Connected.
• NODEPOOL_ID: eine eindeutige programmatische ID, die diesen Knotenpool identifiziert.
• REQUEST_ID: eine eindeutige programmatische ID, die diese Anfrage identifiziert.
• POOL_NAME: ein beschreibender Name, der diesen Knotenpool eindeutig identifiziert.
• LABELS: eine Liste von Labels, die auf diese Knotenpoolressource angewendet werden sollen.
• ZONE_NAME: der Name der Zielzone von Distributed Cloud Connected. Diese Zone muss sich in der in REGION angegebenen Region befinden.
• NODE_COUNT: die Anzahl der Knoten, die dieser Knotenpool enthält.
• MACHINE_FILTER (optional): gibt die Filterkriterien für die Maschinenauswahl an. Nur Maschinen, die diesem Filter entsprechen, können diesem Knotenpool beitreten. Bei Clustern mit mehreren Racks geben Sie mit diesem Flag die Distributed Cloud Connected-Racks an, deren Knoten diesen Knotenpool bilden.

• KMS_KEY (optional): der vollständige Pfad zum Cloud KMS-Schlüssel, den Sie mit diesem Knotenpool verwenden möchten. Beispiel:

  /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
  

  Dieser Parameter gilt nur, wenn Sie Distributed Cloud Connected in Cloud Key Management Service eingebunden haben, wie unter Unterstützung für vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) für lokalen Speicher aktivieren beschrieben.

Knotenpool löschen

Führen Sie die Schritte in diesem Abschnitt aus, um einen Distributed Cloud-Knotenpool zu löschen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Container-Administrator“ (roles/edgecontainer.admin) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud container clusters node-pools delete aus:

gcloud edge-cloud container clusters node-pools delete POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

Ersetzen Sie Folgendes:

• POOL_NAME: der Name des Zielknotenpools.
• PROJECT_ID: die ID des Ziel Google Cloud projekts.
• REGION: die Google Cloud Region, in der der mit diesem Knoten pool verknüpfte Cluster von Distributed Cloud Connected gehostet wird.
• CLUSTER_NAME: der Name des Zielclusters von Distributed Cloud Connected.

API

Senden Sie eine DELETE-Anfrage an die Methode projects.locations.clusters.nodePools.delete:

DELETE /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools/POOL_NAME?requestId=REQUEST_ID

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des Ziel Google Cloud projekts.
• REGION: die Google Cloud Region, in der der mit diesem Knoten pool verknüpfte Cluster von Distributed Cloud Connected gehostet wird.
• CLUSTER_NAME: der Name des Zielclusters von Distributed Cloud Connected.
• POOL_NAME: der Name des Zielknotenpools.
• REQUEST_ID: eine eindeutige programmatische ID, die diese Anfrage identifiziert.

Nächste Schritte

• Arbeitslasten in Distributed Cloud Connected bereitstellen
• Zonen verwalten
• Maschinen verwalten
• Cluster erstellen und verwalten
• VPN-Verbindungen erstellen und verwalten
• Virtuelle Maschinen verwalten
• GPU-Arbeitslasten verwalten