Knotenpools verwalten

Wenn Sie einen Google Distributed Cloud-Kubernetes-Cluster (GDC) ohne Internetverbindung erstellen, wird die Anzahl der Knoten und der angegebene Knotentyp zum Erstellen des ersten Knotenpools verwendet. Sie können die folgenden Knotenpoolaufgaben für einen vorhandenen Cluster ausführen, wenn sich die Rechenanforderungen ändern:

  • Neuen Knotenpool hinzufügen: Fügen Sie neue Knotenpools hinzu, wenn die Anforderungen für Ihre Clusterarbeitslasten steigen.

  • Knotenpool ansehen: Hier können Sie die Merkmale und den Status Ihrer vorhandenen Knotenpools ansehen.

  • Größe eines Knotenpools anpassen: Sie können die Größe Ihrer Knotenpools manuell anpassen, um auf Schwankungen des Arbeitslastverkehrs zu reagieren.

  • Knotenpool löschen: Entfernen Sie Knotenpools, wenn die Nachfrage nach Ihren Clusterarbeitslasten sinkt oder Sie Maschinentypen löschen möchten, die für Ihre Containeroperationen nicht mehr sinnvoll sind.

Weitere Informationen zu Knotenpools in einem Cluster finden Sie unter Knoten.

Dieses Dokument richtet sich an Anwendungsentwickler in der Gruppe der Anwendungsoperatoren und IT-Administratoren in der Gruppe der Plattformadministratoren, die für die Verwaltung von Kubernetes-Clustern in ihrer Organisation verantwortlich sind. Weitere Informationen finden Sie unter Dokumentation zu Zielgruppen für GDC mit Air Gap.

Hinweis

Zum Ausführen der Aufgaben in diesem Dokument müssen Sie die erforderlichen Berechtigungen anfordern und Ihre Umgebung vorbereiten.

IAM-Rollen anfordern

Sie benötigen bestimmte Rollen, um die Berechtigungen zu erhalten, die zum Verwalten von Knotenpools in einem Kubernetes-Cluster erforderlich sind. Welche Rollen Sie benötigen, hängt davon ab, ob Sie in einem organisationsbezogenen freigegebenen Cluster oder in einem projektbezogenen Standardcluster arbeiten. Weitere Informationen finden Sie unter Kubernetes-Clusterkonfigurationen.

Freigegebene Clusterrollen

Wenn Sie die Knotenpools eines freigegebenen Clusters erstellen, löschen, bearbeiten oder aufrufen möchten, wenden Sie sich an Ihren IAM-Administrator der Organisation und bitten Sie ihn, Ihnen die Rolle User Cluster Admin (user-cluster-admin) zuzuweisen. Diese Rolle ist nicht an einen Namespace gebunden.

Standard-Clusterrollen

Wenden Sie sich an Ihren Projekt-IAM-Administrator, um die folgenden Rollen anzufordern:

  • Standard Cluster Admin (standard-cluster-admin): Knotenpools eines Standardclusters erstellen, löschen, bearbeiten oder ansehen.

  • Cluster Developer (cluster-developer): Standardcluster erstellen, löschen, bearbeiten oder ansehen. Diese Rolle ist erforderlich, um die Details des Knotenpools des Clusters in der GDC-Konsole aufzurufen.

Diese Rollen sind an Ihren Projekt-Namespace gebunden.

Umgebung vorbereiten

Wenn Sie Befehle für einen Kubernetes-Cluster über die API ausführen möchten, benötigen Sie die folgenden Ressourcen:

  • Suchen Sie den Namen des Kubernetes-Clusters oder fragen Sie ein Mitglied der Gruppe „Plattformadministrator“, wie der Clustername lautet.

  • Ersetzen Sie KUBERNETES_CLUSTER_NAME in dieser Anleitung durch den Namen des Kubernetes-Clusters.

  • Melden Sie sich an und generieren Sie die kubeconfig-Datei des Management-API-Servers für den Kubernetes-Cluster.

  • Verwenden Sie den kubeconfig-Pfad des Management-API-Servers, um MANAGEMENT_API_SERVER in dieser Anleitung zu ersetzen.

Knotenpool hinzufügen

Führen Sie die folgenden Schritte aus, um einem vorhandenen Kubernetes-Cluster einen Knotenpool hinzuzufügen:

Console

  1. Wählen Sie in der Projektauswahl Ihr Projekt oder Ihre Organisation aus.

    Standardcluster sind projektbezogen und freigegebene Cluster sind organisationsbezogen. Wählen Sie den richtigen Bereich aus, um den entsprechenden Kubernetes-Clustertyp aufzurufen.

  2. Wählen Sie im Navigationsmenü Kubernetes Engine > Cluster aus.

  3. Klicken Sie in der Clusterliste auf den Cluster. Die Seite Clusterdetails wird angezeigt.

  4. Wählen Sie Knotenpools > Knotenpool hinzufügen aus.

  5. Weisen Sie dem Knotenpool einen Namen zu. Sie können den Namen nach dem Erstellen des Knotenpools nicht mehr ändern.

  6. Geben Sie die Anzahl der Worker-Knoten an, die im Knotenpool erstellt werden sollen.

  7. Wählen Sie die Maschinenklasse aus, die Ihren Arbeitslastanforderungen am besten entspricht. Die Maschinenklassen werden in den folgenden Einstellungen angezeigt:

    • Maschinentyp
    • vCPU
    • Arbeitsspeicher

  8. Klicken Sie auf Speichern.

API

  1. Öffnen Sie die benutzerdefinierte Ressourcenspezifikation Cluster mit der kubectl-CLI über den interaktiven Editor:

    kubectl edit clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE \
    --kubeconfig MANAGEMENT_API_SERVER

    Ersetzen Sie Folgendes:

    • KUBERNETES_CLUSTER_NAME: der Name des Clusters.
    • KUBERNETES_CLUSTER_NAMESPACE: der Namespace des Clusters. Verwenden Sie für freigegebene Cluster den Namespace platform. Verwenden Sie für Standardcluster den Projekt-Namespace des Clusters.
    • MANAGEMENT_API_SERVER: Der Kubeconfig-Pfad des zonalen API-Servers, auf dem der Kubernetes-Cluster gehostet wird.

  2. Fügen Sie im Abschnitt nodePools einen neuen Eintrag hinzu:

    nodePools:
# Several lines of code are omitted here.
- machineTypeName: MACHINE_TYPE
  name: NODE_POOL_NAME
  nodeCount: NUMBER_OF_WORKER_NODES
  taints: TAINTS
  labels: LABELS
  acceleratorOptions:
    gpuPartitionScheme: GPU_PARTITION_SCHEME

    Ersetzen Sie Folgendes:

    • MACHINE_TYPE: Der Maschinentyp für die Worker-Knoten des Knotenpools. Hier finden Sie die verfügbaren Maschinentypen.
    • NODE_POOL_NAME ist der Name des Knotenpools.
    • NUMBER_OF_WORKER_NODES: Die Anzahl der Worker-Knoten, die im Knotenpool bereitgestellt werden sollen.
    • TAINTS: die Markierungen, die auf die Knoten dieses Knotenpools angewendet werden sollen. Dieses Feld ist optional.
    • LABELS: Die Labels, die auf die Knoten dieses Knotenpools angewendet werden sollen. Sie enthält eine Liste von Schlüssel/Wert-Paaren. Dieses Feld ist optional.
    • GPU_PARTITION_SCHEME: Das GPU-Partitionierungsschema, wenn Sie GPU-Arbeitslasten ausführen. Beispiel: mixed-2. Die GPU wird nicht partitioniert, wenn dieses Feld nicht festgelegt ist. Informationen zu verfügbaren MIG-Profilen (Multi-Instance GPU) finden Sie unter Unterstützte MIG-Profile.

  3. Speichern Sie die Datei und beenden Sie den Editor.

Knotenpools ansehen

Führen Sie die folgenden Schritte aus, um vorhandene Knotenpools in einem Kubernetes-Cluster aufzurufen:

Console

  1. Wählen Sie in der Projektauswahl Ihr Projekt oder Ihre Organisation aus.

    Standardcluster sind projektbezogen und freigegebene Cluster sind organisationsbezogen. Wählen Sie den richtigen Bereich aus, um den entsprechenden Kubernetes-Clustertyp aufzurufen.

  2. Wählen Sie im Navigationsmenü Kubernetes Engine > Cluster aus.

  3. Klicken Sie in der Clusterliste auf den Cluster. Die Seite Clusterdetails wird angezeigt.

  4. Wählen Sie Knotenpools aus.

Die Liste der Knotenpools, die im Cluster ausgeführt werden, wird angezeigt. Auf dieser Seite können Sie die Knotenpools des Clusters verwalten.

API

  • So rufen Sie die Knotenpools eines bestimmten Kubernetes-Clusters auf:

    kubectl get clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE \
    -o json --kubeconfig MANAGEMENT_API_SERVER | \
    jq .status.workerNodePoolStatuses

    Ersetzen Sie Folgendes:

    • KUBERNETES_CLUSTER_NAME: der Name des Clusters.
    • KUBERNETES_CLUSTER_NAMESPACE: der Namespace des Clusters. Verwenden Sie für freigegebene Cluster den Namespace platform. Verwenden Sie für Standardcluster den Projekt-Namespace des Clusters.

    Die Ausgabe sieht etwa so aus:

    [
  {
    "conditions": [
      {
        "lastTransitionTime": "2023-08-31T22:16:17Z",
        "message": "",
        "observedGeneration": 2,
        "reason": "NodepoolReady",
        "status": "True",
        "type": "Ready"
      },
      {
        "lastTransitionTime": "2023-08-31T22:16:17Z",
        "message": "",
        "observedGeneration": 2,
        "reason": "ReconciliationCompleted",
        "status": "False",
        "type": "Reconciling"
      }
    ],
    "name": "worker-node-pool",
    "readyNodes": 3,
    "readyTimestamp": "2023-08-31T18:59:46Z",
    "reconcilingNodes": 0,
    "stalledNodes": 0,
    "unknownNodes": 0
  }
]

Größe von Knotenpools ändern

Sie können die Größe von Knotenpools in einem Kubernetes-Cluster manuell anpassen, indem Sie den Pool hoch- oder herunterskalieren. Sie können beim Herunterskalieren eines Knotenpools keinen bestimmten Knoten zum Entfernen auswählen.

Führen Sie die folgenden Schritte aus, um einen Knotenpool in einem vorhandenen Cluster zu skalieren:

Console

  1. Wählen Sie in der Projektauswahl Ihr Projekt oder Ihre Organisation aus.

    Standardcluster sind projektbezogen und freigegebene Cluster sind organisationsbezogen. Wählen Sie den richtigen Bereich aus, um den entsprechenden Kubernetes-Clustertyp aufzurufen.

  2. Wählen Sie im Dashboard das Projekt aus, in dem sich der Cluster befindet, den Sie bearbeiten möchten.

  3. Wählen Sie im Navigationsmenü Kubernetes Engine > Cluster aus.

  4. Wählen Sie den Clusternamen aus, dem der Knotenpool zugeordnet ist. Die Seite Clusterdetails wird angezeigt.

  5. Klicken Sie auf den Tab Knotenpools.

  6. Wählen Sie das Symbol  Bearbeiten für den Knotenpool aus, dessen Größe Sie ändern möchten. Die Eingabeaufforderung Knotenpool bearbeiten wird angezeigt.

  7. Aktualisieren Sie das Feld Anzahl der Knoten, damit es der neuen Anzahl der im Knotenpool erforderlichen Knoten entspricht. Sie können die Anzahl der Knoten an die Anforderungen Ihrer Arbeitslast anpassen.

  8. Klicken Sie auf Speichern.

  9. Kehren Sie zum Tab Knotenpools für Ihren Cluster zurück und prüfen Sie, ob der Knotenpool mit der neuen Größe den Status Ready und die richtige Anzahl von Knoten hat. Es kann einige Minuten dauern, bis der Knotenpool auf Ihre Spezifikation skaliert wird.

    Prüfen Sie in der Console, ob Ihr Knotenpool bereit ist.

API

  1. Öffnen Sie die benutzerdefinierte Ressourcenspezifikation Cluster mit der kubectl-CLI über den interaktiven Editor:

    kubectl edit clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE \
    --kubeconfig MANAGEMENT_API_SERVER

    Ersetzen Sie Folgendes:

    • KUBERNETES_CLUSTER_NAME: Der Name des Clusters, der den Knotenpool hostet.
    • KUBERNETES_CLUSTER_NAMESPACE: der Namespace des Clusters. Verwenden Sie für freigegebene Cluster den Namespace platform. Verwenden Sie für Standardcluster den Projekt-Namespace des Clusters.
    • MANAGEMENT_API_SERVER: Der Kubeconfig-Pfad des zonalen API-Servers, auf dem der Kubernetes-Cluster gehostet wird.

  2. Aktualisieren Sie das Feld nodeCount für den Knotenpool, dessen Größe geändert werden soll:

    nodePools:
# Several lines of code are omitted here.
- machineTypeName: n2-standard-2-gdc
  name: nodepool-1
  nodeCount: NUMBER_OF_WORKER_NODES

    Ersetzen Sie NUMBER_OF_WORKER_NODES durch die aktualisierte Anzahl der Worker-Knoten, die im Knotenpool bereitgestellt werden sollen.

  3. Speichern Sie die Datei und beenden Sie den Editor.

  4. Prüfen Sie, ob die Knotenskalierung abgeschlossen ist, indem Sie die Konfiguration des Knotenpools prüfen:

    kubectl get clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE -o json \
    --kubeconfig MANAGEMENT_API_SERVER | jq .status.workerNodePoolStatuses

    Prüfen Sie, ob die Zahl readyNodes der Anzahl der Knoten entspricht, die Sie für den Knotenpool festgelegt haben. Es kann einige Minuten dauern, bis der Knotenpool auf die von Ihnen angegebene Größe skaliert wird.

Knotenpool löschen

Durch das Löschen eines Knotenpools werden dessen Knoten und Routen gelöscht. Auf diesen Knoten werden alle darauf ausgeführten Pods entfernt und neu geplant. Wenn die Pods spezifische Knotenauswahlen haben, bleiben die Pods womöglich in einem nicht planbaren Zustand, wenn kein anderer Knoten im Cluster die Kriterien erfüllt.

Achten Sie darauf, dass Sie mindestens drei Worker-Knoten haben, bevor Sie einen Knotenpool löschen, damit Ihr Cluster genügend Rechenleistung für einen effektiven Betrieb hat.

So löschen Sie einen Knotenpool:

Console

  1. Wählen Sie in der Projektauswahl Ihr Projekt oder Ihre Organisation aus.

    Standardcluster sind projektbezogen und freigegebene Cluster sind organisationsbezogen. Wählen Sie den richtigen Bereich aus, um den entsprechenden Kubernetes-Clustertyp aufzurufen.

  2. Wählen Sie im Navigationsmenü Kubernetes Engine > Cluster aus.

  3. Klicken Sie auf den Cluster, in dem sich der Knotenpool befindet, den Sie löschen möchten.

  4. Wählen Sie Knotenpools aus.

  5. Klicken Sie neben dem zu löschenden Knotenpool auf  Löschen.

API

  1. Öffnen Sie die benutzerdefinierte Ressourcenspezifikation Cluster mit der kubectl-CLI über den interaktiven Editor:

    kubectl edit clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE \
    --kubeconfig MANAGEMENT_API_SERVER

    Ersetzen Sie Folgendes:

    • KUBERNETES_CLUSTER_NAME: der Name des Clusters.
    • KUBERNETES_CLUSTER_NAMESPACE: der Namespace des Clusters. Verwenden Sie für freigegebene Cluster den Namespace platform. Verwenden Sie für Standardcluster den Projekt-Namespace des Clusters.
    • MANAGEMENT_API_SERVER: Der Kubeconfig-Pfad des zonalen API-Servers, auf dem der Kubernetes-Cluster gehostet wird.

  2. Entfernen Sie den Knotenpooleintrag aus dem Abschnitt nodePools. Im folgenden Snippet müssen Sie beispielsweise die Felder machineTypeName, name und nodeCount entfernen:

    nodePools:
# Several lines of code are omitted here.
- machineTypeName: n2-standard-2-gdc
  name: nodepool-1
  nodeCount: 3

    Entfernen Sie alle Felder für den Knotenpool, den Sie löschen.

  3. Speichern Sie die Datei und beenden Sie den Editor.

Nächste Schritte