Knotenpools verwalten

Wenn Sie einen Google Distributed Cloud-Kubernetes-Cluster (GDC) ohne Internetverbindung erstellen, werden die Anzahl der Knoten und der angegebene Knotentyp zum Erstellen des ersten Knotenpools des Clusters 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 an 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.

Hinweise

Zum Ausführen der Aufgaben in diesem Dokument benötigen Sie die folgenden Ressourcen und Rollen:

  • Wenn Sie Knotenpools in einem gemeinsamen Kubernetes-Cluster ansehen und verwalten möchten, bitten Sie Ihren IAM-Administrator der Organisation, Ihnen die folgenden Rollen zuzuweisen:

    • Nutzerclusteradministrator (user-cluster-admin)
    • Betrachter für Nutzerclusterknoten (user-cluster-node-viewer)

    Diese Rollen sind nicht an einen Namespace gebunden.

  • Wenn Sie Knotenpools in einem Standard-Kubernetes-Cluster ansehen und verwalten möchten, bitten Sie den IAM-Administrator Ihrer Organisation, Ihnen die Rolle „Standard Cluster Admin“ (standard-cluster-admin) zuzuweisen. Diese Rolle ist an Ihren Projekt-Namespace gebunden.

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

    • Suchen Sie den Namen des Kubernetes-Clusters oder fragen Sie ein Mitglied der Plattformadministratorgruppe nach dem Clusternamen.

    • Melden Sie sich an und generieren Sie die kubeconfig-Datei für den Kubernetes-Cluster, falls Sie noch keine haben.

    • Verwenden Sie den kubeconfig-Pfad des Kubernetes-Clusters, um KUBERNETES_CLUSTER_KUBECONFIG 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 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 benutzerdefinierte Ressourcenspezifikation Cluster mit der kubectl-Befehlszeile ü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. Wenn Sie noch keine kubeconfig-Datei für den API-Server in Ihrer Zielzone generiert haben, lesen Sie den Abschnitt Anmelden.
  2. Fügen Sie im Abschnitt nodePools einen neuen Eintrag hinzu:

    nodePools:
    ...
    - 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 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 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 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 für den Knotenpool, dessen Größe Sie ändern möchten, das Symbol  Bearbeiten aus. Die Aufforderung Knotenpool bearbeiten wird angezeigt.
  6. 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 entsprechend den Anforderungen Ihrer Arbeitslast erhöhen oder verringern.

  7. Klicken Sie auf Speichern.

  8. Rufen Sie den Tab Knotenpools für Ihren Cluster auf 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 Spezifikation der benutzerdefinierten Ressource 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. Wenn Sie noch keine kubeconfig-Datei für den API-Server in Ihrer Zielzone generiert haben, lesen Sie den Abschnitt Zonale Management API-Serverressourcen.
  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 Knotenselektoren 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 im Navigationsmenü Kubernetes Engine > Cluster aus.

  2. Klicken Sie auf den Cluster, in dem sich der Knotenpool befindet, 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 ü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. Wenn Sie noch keine kubeconfig-Datei für den API-Server in Ihrer Zielzone generiert haben, lesen Sie den Abschnitt Zonale Management API-Serverressourcen.
  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.