Error: couldn't find key PROGRAM in ConfigMap default/setari
ConfigMap-ul există, dar nu are cheia cerută de configMapKeyRef (aici PROGRAM). Adaugă cheia în ConfigMap sau corectează numele cheii din pod (contează literele mari și mici).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cu valueFrom.configMapKeyRef, containerul primește valoarea unei singure chei. Dacă ConfigMap-ul există, dar cheia lipsește, kubelet-ul nu creează containerul: CreateContainerConfigError, cu evenimentul couldn't find key PROGRAM in ConfigMap default/setari. Mesajul spune cheia, namespace-ul și numele ConfigMap-ului.
Cauze: cheia are alt nume (program față de PROGRAM, ORA_DESCHIDERE față de ORA-DESCHIDERE), ConfigMap-ul a fost recreat dintr-un fișier fără ea, sau a fost creat din fișier (--from-file=setari.env), caz în care cheia este numele fișierului, nu variabilele din el (pentru asta e --from-env-file).
Cheile existente le vezi cu kubectl get configmap setari -o yaml sau kubectl describe configmap setari.
De ce apare: cauzele frecvente
1Cheie lipsă
kubectl create configmap setari --from-literal=ORAS=Iasi
# podul cere cheia PROGRAMkubectl create configmap setari --from-literal=ORAS=Iasi --from-literal=PROGRAM=9-18 --dry-run=client -o yaml | kubectl apply -f -Cheia PROGRAM trebuie să existe în ConfigMap.
2--from-file în loc de --from-env-file
kubectl create configmap setari --from-file=setari.envkubectl create configmap setari --from-env-file=setari.env--from-file face o singură cheie, setari.env; --from-env-file face câte o cheie pe linie.
3Litere mari și mici
key: program key: PROGRAMCheile sunt sensibile la majuscule.
Repară eroarea, direct în pagină
Podul orar al unei biblioteci cere valoarea cheii PROGRAM din ConfigMap-ul setari, dar ConfigMap-ul are doar ORAS=Iasi, iar podul stă în CreateContainerConfigError. Adaugă cheia PROGRAM=9-18 în ConfigMap, păstrând ORAS.
Indiciu
kubectl create configmap ... --dry-run=client -o yaml | kubectl apply -f - actualizează ConfigMap-ul existent.
Reparația
Motivul și cheile existente:
kubectl describe pod orar | grep -m1 'Error:'
kubectl get configmap setari -o jsonpath='{.data}'
echo Warning Failed 9s (x2 over 19s) kubelet Error: couldn't find key PROGRAM in ConfigMap default/setari
{"ORAS":"Iasi"}Adaugă cheia:
kubectl create configmap setari --from-literal=ORAS=Iasi --from-literal=PROGRAM=9-18 --dry-run=client -o yaml | kubectl apply -f -
kubectl wait --for=condition=Ready pod/orar --timeout=60s
kubectl exec orar -- printenv PROGRAMconfigmap/setari configured
pod/orar condition met
9-18De ce merge
Kubelet-ul caută exact cheia PROGRAM și, fără ea, nu poate construi variabila. Recrearea ConfigMap-ului cu ambele chei prin --dry-run | apply actualizează obiectul existent. La următoarea încercare, kubelet-ul găsește cheia, iar containerul pornește, fără să recreezi podul.
Alte forme ale mesajului
Error: couldn't find key ORAS in ConfigMap magazin/setari
Cum o eviți pe viitor
- Folosește
envFromcând vrei toate cheile unui ConfigMap: nu mai depinzi de nume individuale. - Ține ConfigMap-ul în același fișier cu Deploymentul, ca o cheie nouă să ajungă odată cu codul care o folosește.
- Marchează
optional: truecheile care pot lipsi.
Întrebări frecvente
Pot face o cheie opțională?
Da: configMapKeyRef acceptă optional: true. Dacă cheia lipsește, variabila nu e setată, iar containerul pornește.
De ce aplicația nu vede o cheie nouă adăugată în ConfigMap?
Variabilele de mediu sunt citite doar la crearea containerului. După modificare, repornește podurile (kubectl rollout restart).
Erori înrudite
Error: configmap "setari-magazin" not found Podul folosește un ConfigMap (prin env, envFrom sau valueFrom) care nu există în namespace-ul lui, așa că containerul nu poate fi creat (CreateContainerConfigError). Creează ConfigMap-ul cu numele exact; kubelet-ul reîncearcă singur și pornește containerul. 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. The ConfigMap "setari" is invalid: data[ora deschidere]: Invalid value: "ora deschidere": a valid config key must consist of alphanumeric characters, '-', '_' or '.' (e.g. 'key.name', or 'KEY_NAME', or 'key-name', regex used for validation is '[-._a-zA-Z0-9]+') Numele unei chei din ConfigMap sau Secret conține caractere nepermise (spațiu, diacritice, /). Folosește doar litere, cifre, -, _ și ., de exemplu ORA_DESCHIDERE. Î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.
