Error: Cannot find module './config.json'
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
kubectl set image deploy/magazin magazin=academia/magazin:v3kubectl rollout undo deploy/magazin
# repară Dockerfile-ul, apoi publică v4Imaginea v3 nu conține fișierul; revizia anterioară funcționa.
2Volum montat peste folderul aplicației
volumeMounts:
- name: config
mountPath: /app volumeMounts:
- name: config
mountPath: /app/config.json
subPath: config.jsonMontarea peste /app ascunde codul; subPath montează doar fișierul.
3Fișierul ignorat la build
# .dockerignore
*.json# .dockerignore
node_modulesUn model prea larg în .dockerignore scoate fișierul din imagine.
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ă.
Reparația
Podurile noi și eroarea lor:
kubectl get pods -l app=magazin
POD=$(kubectl get pods -l app=magazin | grep CrashLoop | head -1 | cut -d' ' -f1)
kubectl logs $POD --previous | grep ErrorNAME READY STATUS RESTARTS AGE
magazin-6sxg7xc4zs-75hkq 1/1 Running 0 62s
magazin-6sxg7xc4zs-vd7mj 1/1 Running 0 62s
magazin-zgjb6828kn-xq7nv 0/1 Running 3 (22s ago) 43s
Error: Cannot find module './config.json'Revino la versiunea anterioară:
kubectl rollout undo deployment/magazin
kubectl rollout status deployment/magazin
kubectl get deploy magazin -o jsonpath='{.spec.template.spec.containers[0].image}'
echodeployment.apps/magazin rolled back
deployment "magazin" successfully rolled out
academia/magazin:v1De ce merge
Imaginea v3 nu conține config.json, deci Node iese la pornire și podurile noi cad la nesfârșit. Podurile v1 au rămas în funcțiune, pentru că rolling update-ul nu le-a oprit înainte să fie gata cele noi. rollout undo creează o revizie nouă cu șablonul anterior (v1) și scoate podurile stricate.
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 puneprogressDeadlineSeconds, 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
Back-off restarting failed container api in pod api-6d8f7c9b5-x2kq9_default Containerul pornește și se oprește iar și iar, iar kubelet-ul așteaptă tot mai mult între reporniri (CrashLoopBackOff). Cauza e aproape mereu în jurnalul rulării care a căzut: kubectl logs POD --previous. Repară configurarea sau codul care face procesul să iasă. error: deployment "plati" exceeded its progress deadline Rollout-ul nu a avansat în progressDeadlineSeconds (implicit 600 s): podurile noi nu ajung Ready (imagine greșită, crash, probe). Kubernetes nu face rollback automat; revino cu kubectl rollout undo și caută cauza în podurile noi. error: unable to find specified revision 7 in history Revizia cerută la rollout undo --to-revision nu există în istoricul Deploymentului. Listează reviziile cu kubectl rollout history și alege un număr existent; fără --to-revision, undo revine la revizia anterioară. Î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.
