Knotenpools verwalten

Wenn Sie einen Google Distributed Cloud (GDC) mit Air Gap Kubernetes-Cluster 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 Compute-Anforderungen ändern:

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

Dieses Dokument richtet sich an Anwendungsentwickler in der Gruppe der Anwendungsoperatoren und an 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

Um die Aufgaben in diesem Dokument auszuführen, 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 Sie zum Verwalten von Knotenpools in einem Kubernetes-Cluster benötigen. Die erforderlichen Rollen hängen davon ab, ob Sie in einem organisationsweiten gemeinsam genutzten Cluster oder in einem projektweiten Standard-Cluster arbeiten. Weitere Informationen finden Sie unter Kubernetes-Clusterkonfigurationen.

Rollen für gemeinsam genutzte Cluster

Wenn Sie die Knotenpools eines gemeinsam genutzten Clusters erstellen, löschen, bearbeiten oder ansehen möchten, bitten Sie Ihren IAM-Administrator der Organisation, Ihnen die Rolle Nutzercluster-Administrator (user-cluster-admin) zuzuweisen. Diese Rolle ist nicht an einen Namespace gebunden.

Rollen für Standard-Cluster

Wenn Sie die Knotenpools eines Standard-Clusters erstellen, löschen, bearbeiten oder ansehen möchten, bitten Sie Ihren IAM-Administrator des Projekts, Ihnen die Rolle Standard-Clusteradministrator (standard-cluster-admin) zuzuweisen. Diese Rolle ist an Ihren Projekt-Namespace gebunden.

Umgebung vorbereiten

Wenn Sie Befehle für einen Kubernetes-Cluster mit der 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 der Plattformadministratoren nach dem Clusternamen.

  • Ersetzen Sie in dieser Anleitung KUBERNETES_CLUSTER_NAME 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.

  • Ersetzen Sie in dieser Anleitung MANAGEMENT_API_SERVER durch den kubeconfig-Pfad des Management-API-Servers.

Knotenpool hinzufügen

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

Console

  1. Wählen Sie im Navigationsmenü Kubernetes Engine > Cluster aus.
  2. Klicken Sie in der Clusterliste auf den Cluster. Die Seite Clusterdetails wird angezeigt.
  3. Wählen Sie Knotenpools > Knotenpool hinzufügen aus.
  4. Weisen Sie dem Knotenpool einen Namen zu. Sie können den Namen nach dem Erstellen des Knotenpools nicht mehr ändern.
  5. Geben Sie die Anzahl der Worker-Knoten an, die im Knotenpool erstellt werden sollen.
  6. Wählen Sie die Maschinenklasse aus, die Ihren Arbeitslastanforderungen am besten entspricht. Die Maschinenklassen werden in den folgenden Einstellungen angezeigt:
    • Maschinentyp
    • vCPU
    • Arbeitsspeicher
  7. Klicken Sie auf Speichern.

API

  1. Öffnen Sie die Spezifikation der benutzerdefinierten Ressource Cluster mit der kubectl-CLI und dem 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 gemeinsam genutzte Cluster den Namespace platform. Verwenden Sie für Standard-Cluster 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. Sehen Sie sich die verfügbaren Maschinentypen an, um zu erfahren, was konfiguriert werden kann.
    • NODE_POOL_NAME: 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. Es 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 Multi-Instanz-GPU-Profilen (MIG) 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 anzusehen:

Console

  1. Wählen Sie im Navigationsmenü Kubernetes Engine > Cluster aus.
  2. Klicken Sie in der Clusterliste auf den Cluster. Die Seite Clusterdetails wird angezeigt.
  3. 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 gemeinsam genutzte Cluster den Namespace platform. Verwenden Sie für Standard-Cluster 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 ändern, indem Sie den Pool nach oben oder unten skalieren. Sie können keinen bestimmten Knoten auswählen, der beim Herunterskalieren eines Knotenpools entfernt werden soll.

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

Console

  1. Wählen Sie im Dashboard das Projekt aus, in dem sich der Cluster befindet, den Sie bearbeiten möchten.
  2. Wählen Sie im Navigationsmenü Kubernetes Engine > Cluster aus.
  3. Wählen Sie den Clusternamen aus, dem der Knotenpool zugeordnet ist. Die Seite Clusterdetails wird angezeigt.
  4. Klicken Sie auf den Tab Knotenpools.
  5. Wählen Sie das Symbol Bearbeiten für den Knoten pool aus, dessen Größe Sie ändern möchten. Die Eingabeaufforderung Knotenpool bearbeiten wird angezeigt.

  6. Aktualisieren Sie das Feld Anzahl der Knoten mit der neuen Anzahl der Knoten, die im Knotenpool erforderlich sind. Sie können die Anzahl der Knoten erhöhen oder verringern, um sie an Ihre Arbeitslastanforderungen anzupassen.

  7. Klicken Sie auf Speichern.

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

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

API

  1. Öffnen Sie die Spezifikation der benutzerdefinierten Ressource Cluster mit der kubectl-CLI und dem 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 gemeinsam genutzte Cluster den Namespace platform. Verwenden Sie für Standard-Cluster 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 Sie ändern möchten:

    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 Anzahl von readyNodes der Anzahl der Knoten entspricht, die Sie für den Knotenpool festgelegt haben. Es kann einige Minuten dauern, bis der Knotenpool auf Ihre Spezifikation skaliert ist.

Knotenpool löschen

Durch das Löschen eines Knotenpools werden dessen Knoten und Routen gelöscht. Auf diesen Knoten werden alle 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 Rechenkapazität hat, um effektiv zu funktionieren.

Führen Sie die folgenden Schritte aus, um einen Knotenpool zu löschen:

Console

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

  2. Klicken Sie auf den Cluster, der den Knotenpool hostet, den Sie löschen möchten.

  3. Wählen Sie Knotenpools aus.

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

API

  1. Öffnen Sie die Spezifikation der benutzerdefinierten Ressource Cluster mit der kubectl-CLI und dem 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 gemeinsam genutzte Cluster den Namespace platform. Verwenden Sie für Standard-Cluster 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