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

Error: Database is uninitialized and superuser password is not specified.

Pe scurt

Imaginea oficială postgres refuză să pornească fără parola superutilizatorului. Dă-i variabila POSTGRES_PASSWORD, ideal dintr-un Secret (secretKeyRef); containerul pornește la următoarea încercare.

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

Ce înseamnă

La prima pornire, imaginea postgres inițializează folderul de date și creează utilizatorul postgres. Ca să nu creeze o bază fără parolă, scriptul de intrare se oprește cu acest mesaj dacă POSTGRES_PASSWORD lipsește sau e goală, iar containerul iese cu cod 1. În Kubernetes vezi asta ca CrashLoopBackOff, iar mesajul e în kubectl logs POD --previous.

Mesajul sugerează și POSTGRES_HOST_AUTH_METHOD=trust, care permite conexiuni fără parolă. Nu folosi asta în afara unui test local: orice pod din cluster s-ar putea conecta.

Parola trebuie dată prin env sau envFrom. Varianta corectă e un Secret referit cu secretKeyRef, nu valoarea scrisă direct în manifest. Odată inițializată baza (pe un volum persistent), parola nu se mai schimbă dacă modifici variabila.

De ce apare: cauzele frecvente

1Lipsește variabila

Greșit
YAML
kubectl create deployment db --image=postgres:16
Corect
YAML
kubectl create secret generic db-parola --from-literal=parola=...
# env: POSTGRES_PASSWORD din secretKeyRef

Imaginea are nevoie de parola superutilizatorului la inițializare.

2Parola pusă direct în manifest

Greșit
YAML
        env:
        - name: POSTGRES_PASSWORD
          value: Parola123
Corect
YAML
        env:
        - name: POSTGRES_PASSWORD
          valueFrom:
            secretKeyRef:
              name: db-parola
              key: parola

Manifestele ajung în git; parola trebuie să stea într-un Secret.

3Cheie greșită în Secret

Greșit
YAML
secretKeyRef:
  name: db-parola
  key: password   # cheia e parola
Corect
YAML
secretKeyRef:
  name: db-parola
  key: parola

O cheie lipsă dă CreateContainerConfigError, nu pornește containerul.

Repară tu

Repară eroarea, direct în pagină

Baza de date a unei școli de dans (dans-db, postgres:16) cade la pornire. Citește jurnalul rulării anterioare, creează Secret-ul dans-db-parola cu cheia parola=Dans2026 și dă-l containerului ca POSTGRES_PASSWORD prin secretKeyRef, apoi verifică faptul că baza răspunde.

Indiciu

kubectl set env deployment/dans-db --from=secret/dans-db-parola --keys=parola ar crea variabila PAROLA; folosește un patch cu valueFrom.secretKeyRef.

Alte forme ale mesajului

  • You must specify POSTGRES_PASSWORD to a non-empty value for the superuser.

Cum o eviți pe viitor

  • Pornește bazele de date din charturi testate (de exemplu bitnami/postgresql), care creează singure Secret-ul cu parola.
  • Creează Secret-ul înainte de Deployment sau StatefulSet, în același fișier ori pipeline.
  • Pune datele pe un volum persistent: fără el, baza se reinițializează la fiecare recreare a podului.
  • Nu folosi POSTGRES_HOST_AUTH_METHOD=trust decât local.

Întrebări frecvente

Am schimbat POSTGRES_PASSWORD, dar parola veche încă merge. De ce?

Variabila e folosită doar la inițializarea unei baze noi. Dacă folderul de date există deja pe volum, parola se schimbă cu ALTER USER postgres PASSWORD ... în psql.

De ce mesajul apare doar la --previous?

Pentru că apare la pornire, după care containerul iese. Containerul curent poate fi în pauza de back-off și să nu fi scris nimic încă.

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.