For version information, see the Distributed Cloud connected release notes.

Knotenpools erstellen und verwalten

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

Knotenpools werden automatisch erstellt und mit Knoten 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 Connected.

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 verbundenen Distributed Cloud-Maschinen enthält, die diesem Knotenpool zugewiesen werden, wenn sich dieses Projekt von demGoogle 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 \
    --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 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 Distributed Cloud Connected für diesen Knotenpool gehostet wird.
CLUSTER_NAME: der Name des verbundenen Zielclusters von Distributed Cloud.
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. Verwenden Sie dieses Flag für Cluster mit mehreren Racks, um die verbundenen Racks von Distributed Cloud anzugeben, deren Knoten diesen Knotenpool bilden. Wenn dieses Feld ausgelassen wird, 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 mit Cloud Key Management Service integriert haben, wie unter Unterstützung für kundenverwaltete Verschlüsselungsschlüssel (CMEK) für lokalen Speicher aktivieren beschrieben.
WORKER_NODE_STORAGE_SCHEMA (optional): Gibt das Schema für den lokalen Speicher für die in diesem Knotenpool enthaltenen Worker-Knoten an. Weitere Informationen finden Sie unter Schemas für den lokalen Speicher konfigurieren.

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 Distributed Cloud Connected für diesen Knotenpool gehostet wird.
CLUSTER_NAME: der Name des verbundenen Zielclusters von Distributed Cloud.
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 Zielzone, die mit Distributed Cloud verbunden ist. 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. Verwenden Sie dieses Flag für Cluster mit mehreren Racks, um die verbundenen Racks von Distributed Cloud anzugeben, deren Knoten diesen Knotenpool bilden. Wenn dieses Feld nicht angegeben wird, 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 mit Cloud Key Management Service integriert haben, wie unter Unterstützung für vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) für lokalen Speicher aktivieren beschrieben.

Knotenpools auflisten

Wenn Sie die in einer mit Distributed Cloud verbundenen 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 Zielcluster für Distributed Cloud Connected erstellt wurde.
CLUSTER_NAME: der Name des verbundenen Zielclusters von Distributed Cloud.

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 Connected 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 Connected-Cluster gehostet wird.
CLUSTER_NAME: der Name des verbundenen Zielclusters von Distributed Cloud.

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 Connected-Cluster gehostet wird.
CLUSTER_NAME: der Name des verbundenen Zielclusters von Distributed Cloud.
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 \
    --local-disk-kms-key=POOL_KMS_KEY

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 Connected-Cluster gehostet wird.
CLUSTER_NAME: der Name des Zielclusters vom Typ „Distributed Cloud Connected“.
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. Verwenden Sie dieses Flag für Cluster mit mehreren Racks, um die mit Distributed Cloud verbundenen Racks anzugeben, 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 mit Cloud Key Management Service integriert haben, wie unter Unterstützung für kundenverwaltete Verschlüsselungsschlüssel (CMEK) für lokalen Speicher aktivieren beschrieben.

Wenn Sie einen Knotenpool wieder auf die Verwendung von Google-owned and Google-managed encryption keyzurücksetzen möchten, verwenden Sie das Flag --use-google-managed-key.

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 Connected-Cluster gehostet wird.
CLUSTER_NAME: der Name des verbundenen Zielclusters von Distributed Cloud.
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 Zielzone, die mit Distributed Cloud verbunden ist. 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. Verwenden Sie dieses Flag für Cluster mit mehreren Racks, um die verbundenen Racks von Distributed Cloud anzugeben, 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 mit Cloud Key Management Service integriert 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 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 Connected-Cluster gehostet wird.
CLUSTER_NAME: der Name des verbundenen Zielclusters von Distributed Cloud.

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 Connected-Cluster gehostet wird.
CLUSTER_NAME: der Name des verbundenen Zielclusters von Distributed Cloud.
POOL_NAME: Der Name des Zielknotenpools.
REQUEST_ID: Eine eindeutige programmatische ID zur Identifizierung dieser Anfrage.

Knotenpools erstellen und verwalten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Knotenpool erstellen

Console

gcloud

API

Knotenpools auflisten

gcloud

API

Informationen zu einem Knotenpool abrufen

gcloud

API

Knotenpool ändern

gcloud

API

Knotenpool löschen

gcloud

API

Nächste Schritte

Knotenpools erstellen und verwalten