The Pod "api" is invalid: spec.containers[0].resources.limits[memory]: Invalid value: "256mb": must be a valid quantity
Valoarea unei resurse nu e scrisă în formatul Kubernetes. Memoria se scrie cu Mi sau Gi (256Mi, 1Gi), fără „mb” sau spații; CPU-ul în nuclee sau milinuclee (0.5, 500m). Corectează unitatea și aplică din nou.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cantitățile din Kubernetes (memorie, CPU, stocare) au un format strict: un număr urmat opțional de un sufix. Pentru memorie: sufixe binare Ki, Mi, Gi (1Mi = 1024 × 1024 bytes) sau zecimale k, M, G. Pentru CPU: un număr de nuclee (1, 0.5) sau milinuclee (500m).
Greșelile frecvente: 256mb, 1GB (unitățile nu sunt cele din alte unelte), spații (2 cores, 512 Mi), m mic la memorie (256m e 0,256 bytes, deci valid, dar absurd, și podul cade imediat), virgulă în loc de punct.
Mesajul spune exact câmpul (limits[memory]) și valoarea respinsă.
De ce apare: cauzele frecvente
1Unități ca în alte unelte
limits:
memory: 256mb limits:
memory: 256MiKubernetes folosește Mi și Gi pentru memorie.
2CPU scris în cuvinte
limits:
cpu: 2 cores limits:
cpu: "2" # sau 2000mCPU-ul e un număr de nuclee sau milinuclee, fără text.
3m mic la memorie
memory: 512m memory: 512Mi512m înseamnă 0,512 bytes: valid ca format, dar containerul nu poate porni cu atât.
Repară eroarea, direct în pagină
Podul api al unei aplicații de facturare are în ~/k8s/api.yaml limita de memorie scrisă 256mb, iar kubectl apply dă must be a valid quantity. Scrie limita în formatul Kubernetes (256 de mebibytes) și aplică fișierul.
Indiciu
Sufixul pentru mebibytes este Mi.
Reparația
Validarea eșuează:
kubectl apply -f api.yaml || trueError from server (Invalid): error when creating "api.yaml": The Pod "api" is invalid: spec.containers[0].resources.limits[memory]: Invalid value: "256mb": must be a valid quantityUnitatea corectă:
sed -i 's/256mb/256Mi/' api.yaml
kubectl apply -f api.yaml
kubectl get pod api -o jsonpath='{.spec.containers[0].resources}'
echopod/api created
{"requests":{"memory":"128Mi"},"limits":{"memory":"256Mi"}}De ce merge
Kubernetes acceptă doar sufixele lui pentru cantități: Ki, Mi, Gi sau k, M, G. mb nu e unul dintre ele, deci API server-ul respinge podul. Cu 256Mi, limita e exact 256 × 1024 × 1024 bytes, iar podul se creează cu ea.
Alte forme ale mesajului
spec.containers[0].resources.limits[cpu]: Invalid value: "2 cores": must be a valid quantityquantities must match the regular expression '^([+-]?[0-9.]+)([eEinumkKMGTP]*[-+]?[0-9]*)$'
Cum o eviți pe viitor
- Folosește mereu
Mi/Gipentru memorie șimpentru CPU. - Copiază un bloc
resourcesverificat dintr-un manifest existent al echipei. - Atenție la
mmic la memorie: e format valid, dar înseamnă aproape nimic. - Validează cu
kubectl apply --dry-run=server -f.
Întrebări frecvente
Care e diferența dintre M și Mi?
M înseamnă 1.000.000 de bytes, Mi înseamnă 1.048.576. Diferența e mică, dar Mi e convenția obișnuită în Kubernetes.
Ce înseamnă cpu: 250m?
250 de milinuclee, adică un sfert dintr-un nucleu de procesor.
Erori înrudite
The Pod "api" is invalid: spec.containers[0].resources.requests: Invalid value: "512Mi": must be less than or equal to memory limit of 256Mi 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. Last State: Terminated, Reason: OOMKilled, Exit Code: 137 Containerul a depășit limita de memorie (resources.limits.memory), iar kernel-ul l-a oprit forțat. Mărește limita la un nivel realist pentru aplicație sau reduce consumul de memorie; codul 137 înseamnă oprire cu SIGKILL. 0/3 nodes are available: 2 Insufficient memory, 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 nu mai au destulă memorie nerezervată pentru requests.memory al podului. Fie podul cere mai mult decât încape pe un nod, fie replicile împreună au umplut nodurile. Coboară requests.memory la necesarul real sau redu numărul de replici. Î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.
