...
Eroare Kubernetes · Containere care nu pornesc sau cad

Last State: Terminated, Reason: OOMKilled, Exit Code: 137

Pe scurt

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.

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

Ce înseamnă

Limita de memorie a unui container e aplicată de kernel-ul nodului prin cgroups. Când procesul încearcă să folosească mai mult, kernel-ul îl omoară imediat cu SIGKILL, fără avertisment. Kubernetes raportează Reason: OOMKilled și Exit Code: 137 (128 + 9, numărul semnalului) în secțiunea Last State din kubectl describe pod, apoi repornește containerul, de obicei până la CrashLoopBackOff.

Jurnalul se oprește brusc, de multe ori fără nicio eroare a aplicației. De aceea motivul se caută în describe, nu în logs.

Două situații diferite: limita e prea mică pentru ce face aplicația (cade imediat, la fiecare pornire), sau aplicația are o scurgere de memorie (cade după ore sau zile). În primul caz mărești limita; în al doilea, o limită mai mare doar amână căderea.

De ce apare: cauzele frecvente

1Limită sub necesarul aplicației

Greșit
YAML
        resources:
          limits:
            memory: 200Mi   # aplicația are nevoie de ~250Mi
Corect
YAML
        resources:
          limits:
            memory: 384Mi

Limita trebuie să acopere consumul normal plus o rezervă.

2Runtime care nu știe de limită

Greșit
YAML
        image: aplicatie-java
        resources:
          limits:
            memory: 512Mi
Corect
YAML
        env:
        - name: JAVA_TOOL_OPTIONS
          value: "-XX:MaxRAMPercentage=75"

Heap-ul crește peste limită dacă JVM-ul (sau Node, .NET) nu e configurat să o respecte.

3Cauți motivul în jurnal

Greșit
YAML
kubectl logs incarcator
Corect
YAML
kubectl describe pod incarcator | grep -A3 'Last State'

OOMKilled apare în starea containerului, nu în jurnalul aplicației.

Repară tu

Repară eroarea, direct în pagină

Serviciul de import al unui magazin de mobilă (import, imaginea academia/memorie:1.0, care încarcă aproximativ 250 MiB) repornește continuu. Găsește în starea containerului motivul și codul de ieșire, apoi ridică limita de memorie la 512Mi (requests rămân 128Mi).

Indiciu

kubectl describe pod → secțiunea Last State; kubectl set resources schimbă limita.

Alte forme ale mesajului

  • Reason: OOMKilled
  • Exit Code: 137
  • Container incarcator was OOM killed

Cum o eviți pe viitor

  • Măsoară consumul real cu kubectl top pods sub sarcină normală și pune limita cu o rezervă de 25-50%.
  • Configurează runtime-ul să respecte limita containerului (Java, Node, .NET).
  • Pune alerte pe restarturi cu motiv OOMKilled.
  • Nu scoate limita de tot: un container fără limită poate consuma memoria nodului și poate provoca evacuarea altor poduri.

Întrebări frecvente

137 înseamnă mereu lipsă de memorie?

Nu. 137 înseamnă doar SIGKILL. Dacă motivul e Error (nu OOMKilled), procesul a fost oprit forțat din alt motiv, de exemplu după o probă de liveness eșuată și perioada de grație depășită.

Requests contează la OOMKilled?

Nu direct. Doar limits declanșează OOMKilled. Requests contează la programare și la ce poduri sunt evacuate primele când nodul rămâne fără memorie.

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.