Knotenpools erstellen und verwalten

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

Auf Distributed Cloud Servers werden Knotenpools automatisch erstellt und gefüllt, wenn Sie einen Cluster erstellen. Sie haben auch die Möglichkeit, zusätzliche Knotenpools zu konfigurieren, nachdem Sie den Cluster erstellt haben.

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 IhremGoogle 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 vomGoogle 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. Zum Erstellen eines eigenständigen Knotenpools 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

Ersetzen Sie Folgendes:

• POOL_NAME: ein beschreibender Name, der diesen Knotenpool eindeutig identifiziert. Dieser Name muss RFC 1213-konform sein und darf nur kleingeschriebene alphanumerische Zeichen und Bindestriche (-) enthalten. Er muss mit einem alphanumerischen Zeichen beginnen und enden.
• PROJECT_ID: die ID des Zielprojekts Google Cloud .
• REGION: Die Google Cloud Region, in der der Zielcluster für diesen Knotenpool gehostet wird.
• CLUSTER_NAME: Der Name des Distributed Cloud-Zielclusters.
• ZONE_NAME: Der Name der Distributed Cloud-Zielzone. Diese Zone muss sich in der Region befinden, die in REGION angegeben ist.
• NODE_COUNT: Die Anzahl der Knoten in diesem Knotenpool.
• NODE_LABELS: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, aus denen Labels für die einzelnen Knoten im Knotenpool bestehen.
• 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 einem Computer abrufen. Nur Maschinen, die diesem Filter entsprechen, dürfen in diesen Knotenpool aufgenommen werden.

• 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 kundenverwaltete Verschlüsselungsschlüssel (CMEK) für lokalen Speicher aktivieren beschrieben.

API

Stellen 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 Zielprojekts Google Cloud .
• REGION: Die Google Cloud Region, in der der Zielcluster für diesen Knotenpool gehostet wird.
• CLUSTER_NAME: Der Name des Distributed Cloud-Zielclusters.
• NODEPOOL_ID: eine eindeutige programmatische ID, die diese Knotenpoolressource identifiziert.
• REQUEST_ID: Eine eindeutige programmatische ID zur Identifizierung dieser Anfrage.
• 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 Distributed Cloud-Zielzone. Diese Zone muss sich in der Region befinden, die in REGION angegeben ist.
• NODE_COUNT: Die Anzahl der Knoten in diesem Knotenpool.
• NODE_LABELS: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, aus denen Labels für die einzelnen Knoten im Knotenpool bestehen.
• MACHINE_FILTER (optional): Gibt die Filterkriterien für die Maschinenauswahl an. Nur Maschinen, die diesem Filter entsprechen, dürfen in diesen Knotenpool aufgenommen werden.

• 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 wie unter Unterstützung für vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) für lokalen Speicher aktivieren beschrieben in Cloud Key Management Service eingebunden haben.

Knotenpools auflisten

Wenn Sie die in einer Distributed Cloud-Zone verfügbaren Distributed Cloud-Knotenpools auflisten möchten, führen Sie die Schritte in diesem Abschnitt aus.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Container Viewer“ (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 Zielprojekts Google Cloud .
• REGION: die Google Cloud Region, in der der Ziel-Distributed Cloud-Cluster erstellt wurde.
• CLUSTER_NAME: Der Name des Distributed Cloud-Zielclusters.

API

Stellen 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 Zielprojekts Google Cloud .
• REGION: die Google Cloud Region, in der der Zielcluster für Distributed Cloud erstellt wurde.
• CLUSTER_NAME: Der Name des Distributed Cloud-Zielclusters.
• 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. Wenn Sie eine absteigende Sortierreihenfolge verwenden möchten, stellen Sie dem gewünschten Feld ~ 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 zu erhalten.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Container Viewer“ (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 Zielprojekts Google Cloud .
• REGION: die Google Cloud Region, in der der mit diesem Knotenpool verknüpfte Distributed Cloud-Cluster gehostet wird.
• CLUSTER_NAME: Der Name des Distributed Cloud-Zielclusters.

API

Stellen 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 Zielprojekts Google Cloud .
• REGION: die Google Cloud Region, in der der mit diesem Knotenpool verknüpfte Distributed Cloud-Cluster gehostet wird.
• CLUSTER_NAME: Der Name des Distributed Cloud-Zielclusters.
• 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 Admin (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 Zielprojekts Google Cloud .
• REGION: die Google Cloud Region, in der der mit diesem Knotenpool verknüpfte Distributed Cloud-Cluster gehostet wird.
• CLUSTER_NAME: der Name des Zielclusters in Distributed Cloud.
• 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 einem Computer abrufen.

API

Stellen 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 Zielprojekts Google Cloud .
• REGION: die Google Cloud Region, in der der mit diesem Knotenpool verknüpfte Distributed Cloud-Cluster gehostet wird.
• CLUSTER_NAME: Der Name des Distributed Cloud-Zielclusters.
• NODEPOOL_ID: Eine eindeutige programmatische ID, die diesen Knotenpool identifiziert.
• REQUEST_ID: Eine eindeutige programmatische ID zur Identifizierung dieser Anfrage.
• 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 Distributed Cloud-Zielzone. Diese Zone muss sich in der Region befinden, die in REGION angegeben ist.
• 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, dürfen in diesen Knotenpool aufgenommen werden.

• 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 wie unter Unterstützung für vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) für lokalen Speicher aktivieren beschrieben in Cloud Key Management Service eingebunden haben.

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 Admin (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 Zielprojekts Google Cloud .
• REGION: die Google Cloud Region, in der der mit diesem Knotenpool verknüpfte Distributed Cloud-Cluster gehostet wird.
• CLUSTER_NAME: Der Name des Distributed Cloud-Zielclusters.

API

Stellen 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 Zielprojekts Google Cloud .
• REGION: die Google Cloud Region, in der der mit diesem Knotenpool verknüpfte Distributed Cloud-Cluster gehostet wird.
• CLUSTER_NAME: Der Name des Distributed Cloud-Zielclusters.
• POOL_NAME: Der Name des Zielknotenpools.
• REQUEST_ID: Eine eindeutige programmatische ID zur Identifizierung dieser Anfrage.

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