...
Eroare Kubernetes · Pending și programarea podurilor

1 node(s) had untolerated taint {node-role.kubernetes.io/control-plane: }

Pe scurt

Nodul de control are taint-ul node-role.kubernetes.io/control-plane:NoSchedule, deci podurile obișnuite nu ajung pe el; e normal ca linia să apară în orice FailedScheduling. Dacă vrei un pod (de exemplu agentul unui DaemonSet) și pe nodul de control, adaugă o toleranță pentru acest taint.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un taint pe nod respinge podurile care nu îl tolerează. Clusterele pun pe nodurile de control taint-ul node-role.kubernetes.io/control-plane cu efect NoSchedule, ca aplicațiile să nu concureze cu componentele clusterului. Acoladele arată cheia și valoarea (goală aici).

Când un pod e Pending, mesajul enumeră toate nodurile, deci linia despre control-plane apare aproape mereu. De obicei nu e cauza: uită-te la ce scrie despre celelalte noduri (Insufficient cpu, node affinity, alt taint).

E cauza reală când chiar vrei podul pe fiecare nod: agenți de monitorizare, colectoare de jurnale, unelte de rețea, rulate ca DaemonSet. Fără toleranță, DaemonSet-ul are DESIRED mai mic decât numărul de noduri.

De ce apare: cauzele frecvente

1Agent de monitorizare fără toleranță

Greșit
YAML
kind: DaemonSet
...
    spec:
      containers: ...
Corect
YAML
    spec:
      tolerations:
      - key: node-role.kubernetes.io/control-plane
        operator: Exists
        effect: NoSchedule
      containers: ...

Toleranța permite podului să ignore taint-ul nodului de control.

2Cauți problema în linia greșită

Greșit
YAML
# Pending: 2 Insufficient cpu, 1 node(s) had untolerated taint {...control-plane}
kubectl taint nodes academia-control-plane node-role.kubernetes.io/control-plane-
Corect
YAML
# reduce requests.cpu; nodul de control rămâne rezervat

Scoaterea taint-ului doar mută aplicațiile pe nodul de control; problema reală e CPU-ul.

Repară tu

Repară eroarea, direct în pagină

Agentul de jurnale al unei firme de hosting (DaemonSet-ul jurnale, busybox:1.36) trebuie să ruleze pe toate cele 3 noduri, dar are doar 2 poduri: lipsește de pe nodul de control. Adaugă în ~/k8s/jurnale.yaml o toleranță pentru node-role.kubernetes.io/control-plane (operator Exists, efect NoSchedule) și aplică fișierul.

Indiciu

tolerations stă în spec.template.spec, lângă containers.

Alte forme ale mesajului

  • 0/1 nodes are available: 1 node(s) had untolerated taint {node-role.kubernetes.io/master: }

Cum o eviți pe viitor

  • Citește toată linia FailedScheduling și caută motivul pentru nodurile de lucru.
  • Pune toleranța pentru control-plane doar pe DaemonSet-urile care chiar trebuie să ruleze peste tot.
  • Nu scoate taint-ul de pe nodurile de control în clustere reale.
  • Compară DESIRED al DaemonSet-ului cu kubectl get nodes după instalare.

Întrebări frecvente

De ce apare și master, nu doar control-plane?

Clusterele vechi foloseau taint-ul node-role.kubernetes.io/master. Din Kubernetes 1.24 numele e control-plane.

Toleranța forțează podul pe nodul de control?

Nu. Doar îi permite să ajungă acolo. Pentru a-l forța ai nevoie de nodeSelector sau affinity.

Erori înrudite

0/3 nodes are available: 2 node(s) had untolerated taint {dedicat: gpu}, 1 node(s) had untolerated taint {node-role.kubernetes.io/control-plane: }. preemption: 0/3 nodes are available: 1 Preemption is not helpful for scheduling, 2 No preemption victims found for incoming pod. Nodurile au un taint (aici dedicat=gpu:NoSchedule) pe care podul nu îl tolerează, deci nu poate fi programat. Fie adaugi podului o toleranță pentru taint, dacă are voie pe acele noduri, fie scoți taint-ul de pe noduri, dacă nu mai e necesar. 0/3 nodes are available: 2 Insufficient cpu, 1 node(s) had untolerated taint {node-role.kubernetes.io/control-plane: }. preemption: 0/3 nodes are available: 1 Preemption is not helpful for scheduling, 2 No preemption victims found for incoming pod. Niciun nod nu are destul CPU nerezervat pentru requests.cpu al podului, așa că podul rămâne Pending. Coboară requests.cpu la cât folosește aplicația de fapt (de exemplu 500m), eliberează resurse sau adaugă noduri. 0/3 nodes are available: 2 node(s) didn't match Pod's node affinity/selector, 1 node(s) had untolerated taint {node-role.kubernetes.io/control-plane: }. preemption: 0/3 nodes are available: 1 Preemption is not helpful for scheduling, 2 No preemption victims found for incoming pod. Podul are un nodeSelector sau o regulă de nodeAffinity pe care niciun nod nu o îndeplinește (de exemplu disk: ssd, dar niciun nod nu are eticheta). Pune eticheta pe nodul potrivit cu kubectl label nodes sau corectează selectorul din pod.

← Toate erorile Kubernetes

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Kubernetes de la zero, cu exerciții la fiecare lecție

Curs Kubernetes: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.