Error: failed to create containerd task: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: exec: "porneste-app": executable file not found in $PATH: unknown
Comanda dată containerului (command sau primul element din args la imagini fără ENTRYPOINT) nu există în imagine. Corectează command/args: folosește programul real (sh, node, raport) sau lasă comanda implicită a imaginii.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când pornește containerul, runtime-ul (runc) încearcă să execute primul element din command sau, dacă lipsește, ENTRYPOINT-ul imaginii. Dacă fișierul nu există în imagine sau nu e în PATH, procesul nici nu pornește: podul arată StartError sau RunContainerError, apoi CrashLoopBackOff, iar jurnalul e gol.
Cauze frecvente: command suprascrie ENTRYPOINT-ul imaginii (în Kubernetes, command = ENTRYPOINT, args = CMD), deci argumentele unui program devin program; comanda e scrisă ca un singur șir cu spații (command: ["npm start"] caută un fișier numit „npm start”); programul există doar în altă imagine (de exemplu bash în alpine, care are doar sh).
Mesajul pune între ghilimele exact ce s-a încercat să se execute.
De ce apare: cauzele frecvente
1Comandă care nu există în imagine
command: ["porneste-app"] command: ["sh", "-c", "echo pornit; sleep 3600"]busybox nu are porneste-app; are sh.
2Comandă și argumente într-un singur șir
command: ["npm start"] command: ["npm", "start"]Fiecare cuvânt e un element separat al listei.
3Argumentele puse în command
kubectl create job r --image=academia/raport:1.0 -- --zile 7kubectl create job r --image=academia/raport:1.0 -- raport --zile 7Cu kubectl create job, ce urmează după -- devine command; primul element trebuie să fie programul.
Repară eroarea, direct în pagină
Deploymentul agent al unei firme de curierat rulează busybox:1.36 cu command: ["porneste-app"], iar podul stă în CrashLoopBackOff cu StartError. Citește evenimentul, apoi schimbă comanda în sh -c "echo agent pornit; sleep 3600" și verifică faptul că podul rămâne pornit.
Indiciu
Comanda se schimbă în șablonul Deploymentului, de exemplu cu un kubectl patch pe command.
Reparația
Starea și evenimentul:
kubectl get pods -l app=agent
kubectl describe pod -l app=agent | grep -m1 'executable file not found' | grep -o 'exec: .*PATH'NAME READY STATUS RESTARTS AGE
agent-gkqt5jwffj-rlv9s 0/1 CrashLoopBackOff 3 (4s ago) 43s
exec: "porneste-app": executable file not found in $PATHComanda corectă:
kubectl patch deployment agent -p '{"spec":{"template":{"spec":{"containers":[{"name":"agent","command":["sh","-c","echo agent pornit; sleep 3600"]}]}}}}'
kubectl rollout status deployment/agent
kubectl logs deploy/agentdeployment.apps/agent patched
Waiting for deployment "agent" rollout to finish: 0 of 1 updated replicas are available...
deployment "agent" successfully rolled out
agent pornitDe ce merge
runc nu găsește porneste-app în imaginea busybox, deci procesul nu pornește niciodată, iar jurnalul rămâne gol. Evenimentul Failed spune exact ce s-a încercat. Cu sh -c, containerul rulează un program care există, scrie mesajul și rămâne activ prin sleep.
Alte forme ale mesajului
Error: failed to start container "app": Error response from daemon: OCI runtime create failed: container_linux.go:380: starting container process caused: exec: "bash": executable file not found in $PATH: unknownStartErrorRunContainerError
Cum o eviți pe viitor
- Folosește
argscând vrei doar să schimbi argumentele, și lasă ENTRYPOINT-ul imaginii în pace. - Scrie fiecare cuvânt al comenzii ca element separat în listă.
- Verifică ce programe are imaginea:
kubectl run t --image=IMAGINE -it --rm -- shșiwhich program. - Pentru imagini minimale (distroless, scratch), nu presupune că există sh sau bash.
Întrebări frecvente
Care e diferența dintre command și args?
command înlocuiește ENTRYPOINT-ul imaginii, args înlocuiește CMD-ul. Dacă dai doar args, imaginea își păstrează programul și primește argumentele tale.
De ce jurnalul e gol?
Pentru că procesul nu a pornit deloc. Mesajul e în evenimentele podului (kubectl describe pod), nu în logs.
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ă. CrashLoopBackOff (Last State: Terminated, Reason: Completed, Exit Code: 0) Procesul containerului se termină cu succes, dar podul face parte dintr-un Deployment, unde containerele trebuie să ruleze continuu, așa că e repornit la nesfârșit. Pentru o sarcină care se termină folosește un Job (sau CronJob); pentru un serviciu, asigură-te că procesul rămâne pornit în prim-plan. 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. Î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.
