Knotenpools erstellen und verwalten

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

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

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-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 \
    --machine-filter=MACHINE_FILTER \
    --local-disk-kms-key=POOL_KMS_KEY

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 Ziel-Distributed Cloud-Cluster für diesen Knotenpool gehostet wird.
• CLUSTER_NAME: der Name des Ziel-Distributed Cloud-Clusters.
• ZONE_NAME: der Name der Ziel-Distributed Cloud-Zone. Diese Zone muss sich in der in REGION angegebenen Region befinden.
• NODE_COUNT: die Anzahl der Knoten in diesem Knotenpool.
• MACHINE_FILTER (optional): gibt die Filterkriterien für die Maschinenauswahl an. Informationen zu den Feldern, nach denen Sie filtern können, finden Sie unter Informationen zu einer Maschine abrufen. Nur Maschinen, die diesem Filter entsprechen, können diesem Knotenpool beitreten.

• 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 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.

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,   
 "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 Ziel-Distributed Cloud-Cluster für diesen Knotenpool gehostet wird.
• CLUSTER_NAME: der Name des Ziel-Distributed Cloud-Clusters.
• 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 Ziel-Distributed Cloud-Zone. Diese Zone muss sich in der in REGION angegebenen Region befinden.
• NODE_COUNT: die Anzahl der Knoten in diesem Knotenpool.
• MACHINE_FILTER (optional): gibt die Filterkriterien für die Maschinenauswahl an. Nur Maschinen, die diesem Filter entsprechen, können diesem Knotenpool beitreten.

• 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 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-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 Ziel-Distributed Cloud-Cluster erstellt wurde.
• CLUSTER_NAME: der Name des Ziel-Distributed Cloud-Clusters.

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 Ziel Distributed Cloud-Cluster erstellt wurde.
• CLUSTER_NAME: der Name des Ziel-Distributed Cloud-Clusters.
• 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 ein ~ voran.
• PAGE_TOKEN: ein Token, das in der Antwort auf die letzte Listenanfrage im Feld nextPageToken in der Antwort empfangen wurde. 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 Distributed Cloud-Cluster gehostet wird, der mit diesem Knoten pool verknüpft ist.
• CLUSTER_NAME: der Name des Ziel-Distributed Cloud-Clusters.

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 Distributed Cloud-Cluster gehostet wird, der mit diesem Knoten pool verknüpft ist.
• CLUSTER_NAME: der Name des Ziel-Distributed Cloud-Clusters.
• 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

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 Distributed Cloud-Cluster gehostet wird, der mit diesem Knoten pool verknüpft ist.
• CLUSTER_NAME: der Name des Ziel- Distributed Cloud-Clusters.
• NODE_COUNT: die Anzahl der Knoten in diesem Knotenpool.
• MACHINE_FILTER (optional): gibt die Filterkriterien für die Maschinenauswahl an. Informationen zu den Feldern, nach denen Sie filtern können, finden Sie unter Informationen zu einer Maschine abrufen.

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 Distributed Cloud-Cluster gehostet wird, der mit diesem Knoten pool verknüpft ist.
• CLUSTER_NAME: der Name des Ziel-Distributed Cloud-Clusters.
• 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 Ziel-Distributed Cloud-Zone. Diese Zone muss sich in der in REGION angegebenen Region befinden.
• NODE_COUNT: die Anzahl der Knoten in diesem Knotenpool.
• MACHINE_FILTER (optional): gibt die Filterkriterien für die Maschinenauswahl an. Nur Maschinen, die diesem Filter entsprechen, können diesem Knotenpool beitreten.

• 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 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 Distributed Cloud-Cluster gehostet wird, der mit diesem Knoten pool verknüpft ist.
• CLUSTER_NAME: der Name des Ziel-Distributed Cloud-Clusters.

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 Distributed Cloud-Cluster gehostet wird, der mit diesem Knoten pool verknüpft ist.
• CLUSTER_NAME: der Name des Ziel-Distributed Cloud-Clusters.
• POOL_NAME: der Name des Zielknotenpools.
• REQUEST_ID: eine eindeutige programmatische ID, die diese Anfrage identifiziert.

Nächste Schritte

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