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

The Pod "api" is invalid: spec.containers[0].resources.limits[memory]: Invalid value: "256mb": must be a valid quantity

Pe scurt

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

Greșit
YAML
        limits:
          memory: 256mb
Corect
YAML
        limits:
          memory: 256Mi

Kubernetes folosește Mi și Gi pentru memorie.

2CPU scris în cuvinte

Greșit
YAML
        limits:
          cpu: 2 cores
Corect
YAML
        limits:
          cpu: "2"   # sau 2000m

CPU-ul e un număr de nuclee sau milinuclee, fără text.

3m mic la memorie

Greșit
YAML
          memory: 512m
Corect
YAML
          memory: 512Mi

512m înseamnă 0,512 bytes: valid ca format, dar containerul nu poate porni cu atât.

Repară tu

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.

Alte forme ale mesajului

  • spec.containers[0].resources.limits[cpu]: Invalid value: "2 cores": must be a valid quantity
  • quantities must match the regular expression '^([+-]?[0-9.]+)([eEinumkKMGTP]*[-+]?[0-9]*)$'

Cum o eviți pe viitor

  • Folosește mereu Mi/Gi pentru memorie și m pentru CPU.
  • Copiază un bloc resources verificat dintr-un manifest existent al echipei.
  • Atenție la m mic 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

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