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

Error from server (AlreadyExists): configmaps "setari" already exists

Pe scurt

kubectl create configmap nu poate actualiza un ConfigMap existent. Ca să-i schimbi valorile, generează-l cu --dry-run=client -o yaml și trimite-l la kubectl apply -f -, sau editează-l (kubectl edit). Apoi repornește podurile care îl folosesc ca variabile.

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

Ce înseamnă

kubectl create configmap (și create secret) e o comandă de creare: dacă obiectul există, API server-ul răspunde AlreadyExists și nu schimbă nimic. Situația apare des când vrei să actualizezi o valoare și rulezi din nou comanda inițială, cu alte valori.

Tiparul folosit pentru actualizări este: kubectl create configmap setari --from-literal=... --dry-run=client -o yaml | kubectl apply -f -. Prima parte construiește local manifestul, fără să-l trimită; a doua îl aplică, creând sau actualizând obiectul. Merge la fel pentru Secret-uri și pentru --from-file.

Atenție: podurile care folosesc ConfigMap-ul ca variabile de mediu nu văd valorile noi până nu sunt recreate (kubectl rollout restart deployment/...).

De ce apare: cauzele frecvente

1Rulezi create din nou cu altă valoare

Greșit
YAML
kubectl create configmap setari --from-literal=ORAS=Cluj
Corect
YAML
kubectl create configmap setari --from-literal=ORAS=Cluj --dry-run=client -o yaml | kubectl apply -f -

apply actualizează obiectul existent.

2Ștergi și recreezi

Greșit
YAML
kubectl delete configmap setari
kubectl create configmap setari --from-literal=ORAS=Cluj
Corect
YAML
kubectl create configmap setari --from-literal=ORAS=Cluj --dry-run=client -o yaml | kubectl apply -f -

Între ștergere și creare, podurile noi ar cădea cu configmap not found.

3Aștepți ca aplicația să vadă valoarea nouă

Greșit
YAML
# ConfigMap actualizat, aplicația arată tot Iasi
Corect
YAML
kubectl rollout restart deployment/magazin

Variabilele de mediu se citesc doar la pornirea containerului.

Repară tu

Repară eroarea, direct în pagină

Magazinul unei florării (flori) citește orașul din ConfigMap-ul setari (ORAS=Iasi). Florăria s-a mutat la Cluj, dar kubectl create configmap setari --from-literal=ORAS=Cluj dă AlreadyExists. Actualizează ConfigMap-ul la ORAS=Cluj și repornește Deploymentul, ca aplicația să primească valoarea nouă.

Indiciu

--dry-run=client -o yaml | kubectl apply -f -, apoi kubectl rollout restart.

Alte forme ale mesajului

  • Error from server (AlreadyExists): secrets "db" already exists
  • error: failed to create configmap: configmaps "setari" already exists

Cum o eviți pe viitor

  • Folosește tiparul --dry-run=client -o yaml | kubectl apply -f - în scripturi: e idempotent.
  • Ține ConfigMap-urile ca fișiere YAML în git și aplică-le cu kubectl apply -f.
  • Pentru schimbări care trebuie să ajungă imediat în aplicație, folosește ConfigMap-uri cu nume versionate (setari-v2) și schimbă referința din Deployment.

Întrebări frecvente

De ce nu există kubectl update configmap?

Pentru că apply face deja asta, pentru orice tip de obiect. create rămâne strict pentru creare.

kubectl edit e o variantă bună?

Pentru o schimbare rapidă, da. Dar dacă ConfigMap-ul e în git, următorul apply din fișier îți suprascrie modificarea.

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.