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

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

Pe scurt

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

Greșit
YAML
        command: ["porneste-app"]
Corect
YAML
        command: ["sh", "-c", "echo pornit; sleep 3600"]

busybox nu are porneste-app; are sh.

2Comandă și argumente într-un singur șir

Greșit
YAML
        command: ["npm start"]
Corect
YAML
        command: ["npm", "start"]

Fiecare cuvânt e un element separat al listei.

3Argumentele puse în command

Greșit
YAML
kubectl create job r --image=academia/raport:1.0 -- --zile 7
Corect
YAML
kubectl create job r --image=academia/raport:1.0 -- raport --zile 7

Cu kubectl create job, ce urmează după -- devine command; primul element trebuie să fie programul.

Repară tu

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.

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: unknown
  • StartError
  • RunContainerError

Cum o eviți pe viitor

  • Folosește args câ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 și which 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

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