...
Eroare Kubernetes · Manifeste YAML, apply și câmpuri invalide

The Pod "api" is invalid: spec.containers[0].resources.requests: Invalid value: "512Mi": must be less than or equal to memory limit of 256Mi

Pe scurt

Containerul cere (requests) mai mult decât limita lui (limits) pentru aceeași resursă, ceea ce nu are sens. Fă requests mai mic sau egal cu limits, de exemplu requests 256Mi și limits 512Mi.

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

Ce înseamnă

requests e ce rezervă scheduler-ul pentru container pe nod; limits e maximul pe care containerul îl poate folosi. Pentru aceeași resursă, rezerva nu poate fi mai mare decât maximul, așa că API server-ul respinge podul.

Greșeala apare când inversezi valorile, când crești doar requests după o problemă de performanță și uiți limita, sau când un LimitRange din namespace pune o limită implicită mai mică decât requests-ul tău (atunci mesajul pare să vină de nicăieri: limita nu e în fișierul tău).

Atenție și la unități: requests: 500m și limits: 0.2 (CPU) înseamnă 500 de milinuclee față de 200, deci tot invers.

De ce apare: cauzele frecvente

1Valori inversate

Greșit
YAML
        requests:
          memory: 512Mi
        limits:
          memory: 256Mi
Corect
YAML
        requests:
          memory: 256Mi
        limits:
          memory: 512Mi

Rezerva trebuie să încapă în limită.

2Ai crescut doar requests

Greșit
YAML
        requests:
          cpu: 500m
        limits:
          cpu: 200m
Corect
YAML
        requests:
          cpu: 500m
        limits:
          cpu: "1"

Când crești rezerva, verifică și limita.

3Limita vine dintr-un LimitRange

Greșit
YAML
# fără limits în fișier
        requests:
          memory: 1Gi
Corect
YAML
kubectl describe limitrange -n echipa
# pune limits explicit, >= requests

LimitRange adaugă limita implicită, care poate fi sub requests-ul tău.

Repară tu

Repară eroarea, direct în pagină

Podul api al unui magazin de jucării are în ~/k8s/api.yaml requests.memory: 512Mi și limits.memory: 256Mi, iar kubectl apply dă must be less than or equal to memory limit. Inversează valorile (requests 256Mi, limits 512Mi) și aplică fișierul.

Indiciu

Rezerva (requests) nu poate depăși maximul (limits).

Alte forme ale mesajului

  • spec.containers[0].resources.requests: Invalid value: "500m": must be less than or equal to cpu limit of 200m

Cum o eviți pe viitor

  • Scrie requests și limits împreună, unul sub altul, ca să le compari ușor.
  • Pentru memorie, o regulă simplă: limits egal sau puțin peste requests.
  • Verifică LimitRange-urile namespace-ului (kubectl describe limitrange) înainte să lași limits implicite.
  • Pornește de la consumul real (kubectl top pods) când alegi valorile, nu de la estimări.

Întrebări frecvente

Pot avea requests fără limits?

Da. Containerul nu are atunci o limită proprie (sau primește una implicită din LimitRange). E permis, dar pentru memorie e riscant: poate consuma tot nodul.

Ce înseamnă requests egal cu limits?

Clasa QoS Guaranteed, dacă e așa pentru CPU și memorie la toate containerele. Podurile Guaranteed sunt ultimele evacuate când nodul rămâne fără resurse.

Erori înrudite

← 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.