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

Error: container has runAsNonRoot and image will run as root (pod: "api_default(...)", container: api)

Pe scurt

Podul cere runAsNonRoot: true, dar imaginea pornește ca root (UID 0) și nu i-ai dat alt utilizator, așa că kubelet-ul refuză să pornească containerul (CreateContainerConfigError). Setează runAsUser cu un UID nenul (de exemplu 1000) sau folosește o imagine care rulează ca utilizator obișnuit.

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

Ce înseamnă

runAsNonRoot: true din securityContext e o garanție: containerul nu are voie să ruleze ca root. Kubelet-ul o verifică înainte de pornire, uitându-se la utilizatorul din imagine (instrucțiunea USER din Dockerfile) și la runAsUser. Dacă rezultatul e UID 0 sau nu poate fi stabilit numeric, refuză containerul: statusul devine CreateContainerConfigError, iar mesajul apare în evenimente.

Multe imagini oficiale (nginx, postgres, imaginile de bază) pornesc ca root. Soluția simplă e runAsUser: 1000 (și runAsGroup, fsGroup pentru fișiere), dar aplicația trebuie să poată rula așa: să nu asculte pe porturi sub 1024 și să poată scrie unde are nevoie.

Varianta image has non-numeric user (node), cannot verify user is non-root apare când imaginea are USER node, nu un UID numeric.

De ce apare: cauzele frecvente

1Imagine care rulează ca root

Greșit
YAML
      securityContext:
        runAsNonRoot: true
Corect
YAML
      securityContext:
        runAsNonRoot: true
        runAsUser: 1000
        runAsGroup: 1000

runAsUser alege un utilizator obișnuit, deci verificarea trece.

2Utilizator nenumeric în imagine

Greșit
YAML
# Dockerfile: USER node
Corect
YAML
# Dockerfile: USER 1000
# sau runAsUser: 1000 în pod

kubelet-ul poate verifica doar UID-uri numerice.

3Server pe port privilegiat

Greșit
YAML
        image: nginx:1.27   # ascultă pe 80, ca root
Corect
YAML
        image: nginxinc/nginx-unprivileged:1.27   # ascultă pe 8080

Ca utilizator obișnuit, procesul nu poate deschide porturi sub 1024.

Repară tu

Repară eroarea, direct în pagină

Echipa de securitate a cerut ca API-ul unei asigurări (Deploymentul api, academia/magazin:v1, port 8080) să nu ruleze ca root, așa că șablonul are runAsNonRoot: true. Podurile stau în CreateContainerConfigError. Adaugă runAsUser: 1000 în securityContext-ul podului și verifică faptul că pornește.

Indiciu

runAsUser stă lângă runAsNonRoot, în spec.template.spec.securityContext.

Alte forme ale mesajului

  • Error: container has runAsNonRoot and image has non-numeric user (node), cannot verify user is non-root

Cum o eviți pe viitor

  • Construiește imaginile proprii cu USER 1000 (numeric) în Dockerfile.
  • Pune runAsNonRoot: true și runAsUser împreună în șabloanele echipei.
  • Pentru imagini terțe, caută variantele „unprivileged” sau „rootless”.
  • Testează podul cu securityContext încă din mediul de dezvoltare, nu doar în producție.
  • Verifică utilizatorul efectiv al procesului cu kubectl exec POD -- id.

Întrebări frecvente

De ce să nu rulez ca root în container?

Dacă cineva compromite aplicația, ca root are mai multe căi de a ieși din container sau de a strica nodul. Un utilizator obișnuit limitează pagubele.

Unde pun securityContext, la pod sau la container?

La pod (spec.securityContext) se aplică tuturor containerelor; la container (containers[].securityContext) suprascrie valorile pentru acel container.

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.