Planung mit Knotenmarkierungen steuern

Standard

Diese Seite bietet eine Übersicht über Knotenmarkierungen in Google Kubernetes Engine (GKE). Wenn Sie Arbeitslasten planen, die in einem Cluster bereitgestellt werden sollen, können Sie mithilfe von Knotenmarkierungen steuern, auf welchen Knoten sie ausgeführt werden dürfen.

Übersicht

Wenn Sie eine Arbeitslast zur Ausführung in einem Cluster einreichen, bestimmt der Planer, wo die der Arbeitslast zugeordneten Pods platziert werden. Der Planer kann einen Pod auf einem beliebigen Knoten platzieren, der die CPU-, Arbeitsspeicher- und angepassten Ressourcenanforderungen des Pods erfüllt.

Wenn der Cluster verschiedene Arbeitslasten ausführt, möchten Sie möglicherweise steuern, welche Arbeitslasten in einem bestimmten Knotenpool ausgeführt werden können.

Mit einer Knotenmarkierung können Sie einen Knoten markieren. Dies bewirkt, dass der Planer den Knoten für bestimmte Pods nicht verwendet. Ein ergänzendes Feature, Toleranzen, ermöglicht die Festlegung von Pods, die mit "markierten" Knoten verwendet werden können.

Markierungen und Toleranzen arbeiten zusammen, um sicherzustellen, dass Pods nicht auf geeigneten Knoten geplant werden.

Knotenmarkierungen sind Schlüssel/Wert-Paare, die einem Effekt zugeordnet sind. In der folgenden Tabelle sind die verfügbaren Effekte aufgeführt:

Effekt	Beschreibung
`NoSchedule`	Pods, die diese Markierung nicht tolerieren, werden nicht auf dem Knoten geplant. Vorhandene Pods werden nicht vom Knoten entfernt.
`PreferNoSchedule`	Kubernetes plant keine Pods, die diese Markierung auf Knoten nicht tolerieren.
`NoExecute`	Der Pod wird aus dem Knoten entfernt, wenn er bereits auf dem Knoten ausgeführt wird, und er wird nicht für den Knoten geplant, wenn er noch nicht auf dem Knoten ausgeführt wird.

Vorteile von Knotenmarkierungen in GKE

Sie können Knotenmarkierungen in GKE oder mit dem Befehl kubectl taint hinzufügen. Das Festlegen von Knotenmarkierungen in GKE bietet mehrere Vorteile gegenüber kubectl:

Markierungen bleiben erhalten, wenn ein Knoten neu gestartet oder ersetzt wird.
Markierungen werden automatisch erstellt, wenn ein Knoten zu einem Pool oder Cluster hinzugefügt wird.
Markierungen werden während dem Cluster-Autoscaling automatisch erstellt.

Hinweis

Führen Sie die folgenden Aufgaben aus, bevor Sie beginnen:

Achten Sie darauf, dass die Google Kubernetes Engine API aktiviert ist.

Google Kubernetes Engine API aktivieren

Prüfen Sie, ob die Google Cloud CLI installiert ist.
Mit den folgenden Methoden können Sie die Standardeinstellungen der Google Cloud CLI für Ihr Projekt einrichten:

Verwenden Sie gcloud init, wenn Sie die Standardeinstellungen für Projekte ansehen möchten.
Verwenden Sie gcloud config, um Ihre Projekt-ID, Zone und Region individuell festzulegen.

gcloud init

Führen Sie gcloud init aus und folgen Sie der Anleitung:
```
gcloud init
```
Wenn Sie SSH auf einem Remote-Server verwenden, können Sie mit dem Flag --console-only verhindern, dass mit dem Befehl ein Browserfenster geöffnet wird:
```
gcloud init --console-only
```
Folgen Sie der Anleitung, um die gcloud CLI für die Nutzung Ihres Google Cloud-Kontos zu autorisieren.
Erstellen Sie eine neue Konfiguration oder wählen Sie eine vorhandene aus.
Wählen Sie ein Google Cloud-Projekt aus.
Wählen Sie eine Compute Engine-Standardzone aus.
Wählen Sie eine Compute Engine-Standardregion aus.

Hinweis: Sie können diese Standardeinstellungen in der gcloud CLI mit den Flags --project, --zone und --region überschreiben.

gcloud config

Legen Sie Ihre standardmäßige Projekt-ID fest:
```
gcloud config set project PROJECT_ID
```
Legen Sie Ihre standardmäßige Compute Engine-Region fest (z. B. us-central1):
```
gcloud config set compute/region COMPUTE_REGION
```
Legen Sie Ihre standardmäßige Compute Engine-Zone fest (z. B. us-central1-c):
```
gcloud config set compute/zone COMPUTE_ZONE
```
Aktualisieren Sie gcloud auf die neueste Version:
```
gcloud components update
```

Hinweis: Sie können diese Standardeinstellungen in der gcloud CLI mit den Flags --project, --zone und --region überschreiben.

Durch das Festlegen von Standardspeicherorten können Sie in der gcloud CLI Fehler wie One of [--zone, --region] must be supplied: Please specify location vermeiden.

Cluster mit Knotenmarkierungen erstellen

Wenn Sie einen Cluster in GKE erstellen, können Sie dem Cluster Knotenmarkierungen zuweisen. Dadurch werden die Markierungen allen Knoten zugewiesen, die mit dem Cluster erstellt wurden.

gcloud

Führen Sie den folgenden Befehl aus, um einen Cluster mit Knotenmarkierungen zu erstellen:

gcloud container clusters create CLUSTER_NAME \
    --node-taints KEY=VALUE:EFFECT

Dabei gilt:

CLUSTER_NAME ist der Name des neuen Clusters.
EFFECT: Einer der folgenden Effektwerte: PreferNoSchedule, NoSchedule oder NoExecute.
KEY=VALUE ist ein Schlüssel/Wert-Paar, das EFFECT zugeordnet ist.

Mit dem folgenden Befehl wird beispielsweise eine Markierung mit dem Schlüsselwert dedicated=experimental mit dem Effekt PreferNoSchedule angewendet:

gcloud container clusters create example-cluster \
    --node-taints dedicated=experimental:PreferNoSchedule

Console

So erstellen Sie einen Cluster mit Knotenmarkierungen:

Rufen Sie in der Cloud Console die Seite Google Kubernetes Engine auf:

Zur Seite "Google Kubernetes Engine"
Klicken Sie auf Erstellen.
Konfigurieren Sie den Cluster wie gewünscht.
Maximieren Sie im Navigationsbereich unter Knotenpools den Knotenpool, den Sie ändern möchten, und klicken Sie dann auf Metadaten.
Klicken Sie im Abschnitt Knotenmarkierungen auf Markierung hinzufügen.
Wählen Sie in der Drop-down-Liste Effekt den gewünschten Effekt aus.
Geben Sie das gewünschte Schlüssel/Wert-Paar in die Felder Schlüssel und Wert ein.
Klicken Sie auf Erstellen.

API

Wenn Sie die API verwenden, um einen Cluster zu erstellen, schließen Sie das Feld nodeTaints unter nodeConfig ein. Beispiel:

POST https://container.googleapis.com/v1/projects/PROJECT_ID/zones/COMPUTE_ZONE/clusters

{
  'cluster': {
    'name': 'example-cluster',
    'nodeConfig': {
      'nodeTaints': [
        {
          'key': 'special',
          'Value': 'gpu',
          'effect': 'PreferNoSchedule'
        }
      ]
      ...
    }
    ...
  }
}

Knotenpool mit Knotenmarkierungen erstellen

Wenn Sie eine Markierung auf einen Knoten anwenden, dürfen nur Pods, die die Markierung tolerieren, auf dem Knoten ausgeführt werden. In einem GKE-Cluster können Sie eine Markierung auf einen Knotenpool anwenden. Dadurch wird die Markierung auf alle Knoten im Pool angewendet.

Zum Erstellen eines Knotenpools mit Knotenmarkierungen können Sie das Google Cloud CLI, die Cloud Console oder die GKE API verwenden.

gcloud

Führen Sie den folgenden Befehl aus, um einen Knotenpool mit Knotenmarkierungen zu erstellen:

gcloud container node-pools create POOL_NAME \
    --cluster CLUSTER_NAME \
    --node-taints KEY=VALUE:EFFECT

Dabei gilt:

POOL_NAME: Der Name des Knotenpools, der erstellt werden soll.
CLUSTER_NAME: Der Name des Clusters, in dem der Knotenpool erstellt wird.
EFFECT: Einer der folgenden Effektwerte: PreferNoSchedule, NoSchedule oder NoExecute.
KEY=VALUE ist ein Schlüssel/Wert-Paar, das EFFECT zugeordnet ist.

Mit dem folgenden Befehl wird beispielsweise ein Knotenpool auf einem vorhandenen Cluster erstellt und eine Markierung mit dem Schlüsselwert dedicated=experimental mit dem Effekt NoSchedule angewendet:

gcloud container node-pools create example-pool --cluster example-cluster \
    --node-taints dedicated=experimental:NoSchedule

Dieser Befehl erstellt einen Knotenpool und wendet eine Markierung an, die das Schlüssel/Wert-Paar special=gpu mit dem Effekt NoExecute hat:

gcloud container node-pools create example-pool-2 --cluster example-cluster \
    --node-taints special=gpu:NoExecute

Console

Führen Sie die folgenden Schritte aus, um einen Knotenpool mit Knotenmarkierungen zu erstellen:

Rufen Sie in der Cloud Console die Seite Google Kubernetes Engine auf:

Zur Seite "Google Kubernetes Engine"
Klicken Sie in der Clusterliste auf den Namen des Clusters, den Sie ändern möchten.
Klicken Sie auf der Seite Cluster-Details auf Knotenpool hinzufügen.
Klicken Sie im Navigationsbereich auf Metadaten.
Klicken Sie unter Knotenmarkierungen auf Markierung hinzufügen.
Wählen Sie in der Drop-down-Liste Effekt den gewünschten Effekt aus.
Geben Sie das gewünschte Schlüssel/Wert-Paar in die Felder Schlüssel und Wert ein.
Klicken Sie auf Erstellen.

API

Wenn Sie die API verwenden, um einen Knotenpool zu erstellen, schließen Sie das Feld nodeTaints unter nodeConfig ein. Beispiel:

POST https://container.googleapis.com/v1/projects/PROJECT_ID/zones/COMPUTE_ZONE/clusters/CLUSTER_ID/nodePools

{
  'nodePool': {
    'name': 'example-pool',
    'nodeConfig': {
      'nodeTaints': [
        {
          'key': 'dedicated',
          'Value': 'experimental',
          'effect': 'NoSchedule'
        }
      ]
      ...
    }
    ...
  }
}

Pods für Tolerieren einer Markierung konfigurieren

Sie können festlegen, dass Pods Markierungen tolerieren, indem Sie das Feld tolerations in die Pod-Spezifikation aufnehmen. Dies ist ein Teil einer Pod-Spezifikation.

Dieser Pod kann auf einem Knoten geplant werden, der die Markierung dedicated=experimental:NoSchedule hat:

tolerations:
- key: dedicated
  operator: Equal
  value: experimental
  effect: NoSchedule

Markierung zu einem vorhandenen Knoten hinzufügen

Mit dem Befehl kubectl taint können Sie einem vorhandenen Knoten Markierungen hinzufügen:

kubectl taint nodes NODE_NAME KEY=VALUE:EFFECT

Mit dem folgenden Befehl wird beispielsweise eine Markierung mit dem Schlüsselwert dedicated=experimental und dem Effekt NoSchedule auf den Knoten mynode angewendet:

kubectl taint nodes mynode dedicated=experimental:NoSchedule

Sie können Markierungen auch Knoten hinzufügen, die ein bestimmtes Label haben. Dazu verwenden Sie den Selektor -l zusammen mit dem angegebenen Label und Wert:

kubectl taint nodes -l LABEL=LABEL_VALUE KEY=VALUE:EFFECT

Hinweis: In GKE haben alle Knotenpools ein Label im folgenden Format (wobei POOL_NAME der Name des Knotenpools ist):

cloud.google.com/gke-nodepool:POOL_NAME

Mit dem folgenden Befehl wird beispielsweise eine Markierung mit dem Schlüssel dedicated-pool zu GKE-Knoten im Knotenpool my_pool hinzugefügt:

kubectl taint nodes -l cloud.google.com/gke-nodepool=my_pool dedicated-pool=my_pool:NoSchedule

Markierungen für einen Knoten prüfen

Verwenden Sie das kubectl-Befehlszeilentool, um die Markierungen für einen Knoten abzurufen.

Rufen Sie mit dem folgenden Befehl eine Liste aller Knoten in Ihrem Cluster ab:
```
kubectl get nodes
```
Zum Prüfen eines Knotens können Sie den folgenden Befehl verwenden:
```
kubectl describe node NODE_NAME
```
Suchen Sie in der Ausgabe nach dem Feld Taints. Die Ausgabe sieht etwa so aus:
```
Taints:  dedicated-pool=mypool:NoSchedule
```

Markierung von einem Knoten entfernen

Sie können kubectl taint verwenden, um Markierungen zu entfernen. Sie können Markierungen nach Schlüssel, Schlüssel/Wert-Paar oder Schlüssel/Effekt entfernen.

Mit dem folgenden Befehl werden beispielsweise alle Markierungen mit dem Schlüssel dedicated aus dem Knoten mynode entfernt:

kubectl taint nodes mynode dedicated-

Alle Markierungen aus einem Knotenpool entfernen

Führen Sie den folgenden Befehl aus, um alle Markierungen aus einem Knotenpool zu entfernen:

gcloud beta container node-pools update POOL_NAME \
--node-taints="" \
--cluster=CLUSTER_NAME

Dabei gilt:

POOL_NAME: der Name des zu ändernden Knotenpools.
CLUSTER_NAME: der Name des Clusters, in dem der Knotenpool erstellt wurde.

Planung mit Knotenmarkierungen steuern

Übersicht

Vorteile von Knotenmarkierungen in GKE

Hinweis

gcloud init

gcloud config

Cluster mit Knotenmarkierungen erstellen

gcloud

Console

API

Knotenpool mit Knotenmarkierungen erstellen

gcloud

Console

API

Pods für Tolerieren einer Markierung konfigurieren

Markierung zu einem vorhandenen Knoten hinzufügen

Markierungen für einen Knoten prüfen

Markierung von einem Knoten entfernen

Alle Markierungen aus einem Knotenpool entfernen

Nächste Schritte