Error: Database is uninitialized and superuser password is not specified.
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
kubectl create deployment db --image=postgres:16kubectl create secret generic db-parola --from-literal=parola=...
# env: POSTGRES_PASSWORD din secretKeyRefImaginea are nevoie de parola superutilizatorului la inițializare.
2Parola pusă direct în manifest
env:
- name: POSTGRES_PASSWORD
value: Parola123 env:
- name: POSTGRES_PASSWORD
valueFrom:
secretKeyRef:
name: db-parola
key: parolaManifestele ajung în git; parola trebuie să stea într-un Secret.
3Cheie greșită în Secret
secretKeyRef:
name: db-parola
key: password # cheia e parolasecretKeyRef:
name: db-parola
key: parolaO cheie lipsă dă CreateContainerConfigError, nu pornește containerul.
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.
Reparația
Jurnalul rulării căzute:
kubectl logs deploy/dans-db --previous | head -3Error: Database is uninitialized and superuser password is not specified.
You must specify POSTGRES_PASSWORD to a non-empty value for the
superuser. For example, "-e POSTGRES_PASSWORD=password" on "docker run".Secret-ul și variabila din el:
kubectl create secret generic dans-db-parola --from-literal=parola=Dans2026
kubectl patch deployment dans-db -p '{"spec":{"template":{"spec":{"containers":[{"name":"postgres","env":[{"name":"POSTGRES_PASSWORD","valueFrom":{"secretKeyRef":{"name":"dans-db-parola","key":"parola"}}}]}]}}}}'
kubectl rollout status deployment/dans-db
kubectl exec deploy/dans-db -- pg_isreadysecret/dans-db-parola created
deployment.apps/dans-db patched
Waiting for deployment "dans-db" rollout to finish: 0 of 1 updated replicas are available...
deployment "dans-db" successfully rolled out
/var/run/postgresql:5432 - accepting connectionsDe ce merge
Scriptul de pornire al imaginii postgres se oprește fără parola superutilizatorului, iar kubelet-ul repornește containerul la nesfârșit. Cu secretKeyRef, variabila POSTGRES_PASSWORD primește valoarea din Secret în momentul creării containerului, fără ca parola să apară în Deployment. Baza se inițializează, iar pg_isready confirmă că primește conexiuni.
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=trustdecâ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
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: secret "db-secret" not found Containerul cere o valoare dintr-un Secret care nu există în namespace, așa că nu poate fi creat (CreateContainerConfigError). Creează Secret-ul cu numele și cheile așteptate (kubectl create secret generic); podul pornește singur la următoarea încercare. Error: couldn't find key password in Secret default/db Secret-ul există, dar nu are cheia cerută de secretKeyRef (aici password; Secret-ul are poate parola). Folosește în pod numele exact al cheii din Secret sau adaugă cheia în Secret. Î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.
