...
Eroare Kubernetes · ConfigMap, Secret, namespace-uri și cote

Error: couldn't find key PROGRAM in ConfigMap default/setari

Pe scurt

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ă

Greșit
YAML
kubectl create configmap setari --from-literal=ORAS=Iasi
# podul cere cheia PROGRAM
Corect
YAML
kubectl 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

Greșit
YAML
kubectl create configmap setari --from-file=setari.env
Corect
YAML
kubectl 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

Greșit
YAML
              key: program
Corect
YAML
              key: PROGRAM

Cheile sunt sensibile la majuscule.

Repară tu

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.

Alte forme ale mesajului

  • Error: couldn't find key ORAS in ConfigMap magazin/setari

Cum o eviți pe viitor

  • Folosește envFrom câ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: true cheile 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

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