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

Error: Cannot find module './config.json'

Pe scurt

Aplicația Node din container nu găsește un fișier pe care îl încarcă la pornire, deci iese cu eroare, iar podul ajunge în CrashLoopBackOff. Dacă a apărut după o versiune nouă, întoarce Deploymentul la revizia anterioară (kubectl rollout undo) și repară imaginea; dacă fișierul e configurare, montează-l dintr-un ConfigMap.

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

Ce înseamnă

Mesajul vine din Node.js: require('./config.json') nu a găsit fișierul în folderul aplicației. Procesul se oprește cu cod 1, kubelet-ul îl repornește, iar podul ajunge în CrashLoopBackOff. Jurnalul complet (kubectl logs --previous) arată și fișierul și linia care l-a cerut (/app/server.js:4).

În Kubernetes, cauzele sunt două. Fie imaginea nouă a fost construită fără fișier (lipsă din COPY sau ignorat de .dockerignore), caz în care orice pod cu acea imagine cade. Fie fișierul era montat dintr-un ConfigMap sau volum, iar montarea lipsește sau ascunde folderul aplicației (un volum montat peste /app ascunde tot ce era acolo).

Când problema a apărut la o actualizare, cel mai rapid e kubectl rollout undo: Deploymentul revine la imaginea anterioară, care funcționa.

De ce apare: cauzele frecvente

1Versiune nouă construită greșit

Greșit
YAML
kubectl set image deploy/magazin magazin=academia/magazin:v3
Corect
YAML
kubectl rollout undo deploy/magazin
# repară Dockerfile-ul, apoi publică v4

Imaginea v3 nu conține fișierul; revizia anterioară funcționa.

2Volum montat peste folderul aplicației

Greșit
YAML
        volumeMounts:
        - name: config
          mountPath: /app
Corect
YAML
        volumeMounts:
        - name: config
          mountPath: /app/config.json
          subPath: config.json

Montarea peste /app ascunde codul; subPath montează doar fișierul.

3Fișierul ignorat la build

Greșit
YAML
# .dockerignore
*.json
Corect
YAML
# .dockerignore
node_modules

Un model prea larg în .dockerignore scoate fișierul din imagine.

Repară tu

Repară eroarea, direct în pagină

Magazinul online al unei edituri (Deploymentul magazin) a fost actualizat la academia/magazin:v3, iar podurile noi stau în CrashLoopBackOff. Citește jurnalul unui pod nou ca să vezi eroarea, apoi întoarce Deploymentul la versiunea anterioară, care funcționa.

Indiciu

kubectl logs deploy/magazin --previous sau logs pe un pod în CrashLoopBackOff; kubectl rollout undo revine la revizia anterioară.

Alte forme ale mesajului

  • Error: Cannot find module 'express'
  • code: 'MODULE_NOT_FOUND'

Cum o eviți pe viitor

  • Testează imaginea nouă local sau într-un mediu de test înainte de producție (docker run).
  • Urmărește livrarea cu kubectl rollout status și pune progressDeadlineSeconds, ca un rollout stricat să fie observat repede.
  • Montează fișierele de configurare individual, cu subPath, nu peste folderul aplicației.
  • Folosește maxUnavailable: 0, ca podurile vechi să rămână până pornesc cele noi.

Întrebări frecvente

Aplicația a rămas disponibilă în timpul problemei?

La un rolling update, de obicei da: podurile vechi nu sunt oprite până nu devin gata cele noi, iar cele noi nu devin gata niciodată. Rollout-ul rămâne blocat.

Ce face rollout undo exact?

Creează o revizie nouă cu șablonul reviziei anterioare (aici imaginea v1), iar Deploymentul înlocuiește podurile stricate.

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.