Error from server (AlreadyExists): error when creating "web.yaml": deployments.apps "web" already exists
Încerci să creezi un obiect care există deja cu același nume în namespace. kubectl create (sau create -f) doar creează; ca să actualizezi obiectul din fișier, folosește kubectl apply -f, care creează sau modifică după caz.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Numele unui obiect este unic pentru tipul lui în namespace. kubectl create trimite o cerere de creare, iar API server-ul o refuză cu AlreadyExists dacă obiectul există: nu îl suprascrie și nu îl modifică.
Situația tipică: ai creat Deploymentul cu kubectl create -f web.yaml, ai schimbat fișierul (alt număr de replici, altă imagine) și ai rulat din nou aceeași comandă. Pentru lucrul cu fișiere, comanda potrivită este kubectl apply -f, care compară fișierul cu obiectul din cluster și aplică doar diferențele. Poate fi rulată de oricâte ori.
Același mesaj apare la kubectl create deployment, create configmap, create secret și la Helm, când un obiect cu același nume a fost creat manual înainte.
De ce apare: cauzele frecvente
1Recreezi din fișier după o modificare
kubectl create -f web.yaml # a doua oarăkubectl apply -f web.yamlcreate nu modifică obiecte existente. apply le creează sau le actualizează.
2Comanda imperativă rulată de două ori
kubectl create deployment web --image=nginx:1.27
kubectl create deployment web --image=nginx:1.26kubectl set image deployment/web nginx=nginx:1.26Obiectul există deja; schimbi doar ce vrei, cu set, scale sau edit.
3Vrei să înlocuiești complet obiectul
kubectl create -f web.yamlkubectl replace -f web.yaml # sau --force pentru recrearereplace înlocuiește obiectul existent cu cel din fișier.
Repară eroarea, direct în pagină
Deploymentul web al unei pizzerii a fost creat cu kubectl create -f web.yaml. Ai schimbat în fișier numărul de replici la 3, iar kubectl create -f web.yaml dă AlreadyExists. Aplică modificarea din fișier asupra Deploymentului existent, fără să-l ștergi.
Indiciu
Comanda care creează sau actualizează obiectul după fișier este kubectl apply -f.
Reparația
Comanda care eșuează:
kubectl create -f web.yaml || trueError from server (AlreadyExists): error when creating "web.yaml": deployments.apps "web" already existsAplică fișierul:
kubectl apply -f web.yaml
kubectl rollout status deploy/webdeployment.apps/web configured
Waiting for deployment "web" rollout to finish: 1 of 3 updated replicas are available...
Waiting for deployment "web" rollout to finish: 2 of 3 updated replicas are available...
deployment "web" successfully rolled outDe ce merge
create cere serverului un obiect nou și eșuează dacă numele e luat. apply compară fișierul cu obiectul existent și trimite doar diferențele: aici spec.replicas trece de la 1 la 3, iar podurile existente rămân. Prima rulare pe un obiect creat cu create afișează un avertisment despre adnotarea lipsă, care e normal.
Alte forme ale mesajului
Error from server (AlreadyExists): configmaps "setari" already existsError from server (AlreadyExists): secrets "db" already exists
Cum o eviți pe viitor
- Lucrează cu fișiere și
kubectl apply -f: poate fi rulat de oricâte ori, cu același rezultat. - Folosește
kubectl createdoar pentru obiecte noi, temporare sau pentru a genera YAML cu--dry-run=client -o yaml. - În scripturi,
kubectl create ... --dry-run=client -o yaml | kubectl apply -f -creează sau actualizează fără eroare.
Întrebări frecvente
Care e diferența dintre create și apply?
create e imperativ: „creează obiectul acesta”, și eșuează dacă există. apply e declarativ: „fă ca în cluster să fie ca în fișier”, deci creează sau actualizează.
Pot folosi apply pe un obiect creat cu create?
Da. Prima dată kubectl afișează un avertisment că lipsește adnotarea last-applied-configuration și o adaugă; după aceea apply funcționează normal.
Erori înrudite
The Deployment "web" is invalid: spec.selector: Invalid value: v1.LabelSelector{MatchLabels:map[string]string{"app":"magazin-web"}, MatchExpressions:[]v1.LabelSelectorRequirement(nil)}: field is immutable Selectorul unui Deployment (StatefulSet, DaemonSet) nu se mai poate schimba după creare. Ca să-l schimbi, șterge obiectul și creează-l din nou din fișier (kubectl delete -f, apoi apply -f, sau kubectl replace --force -f), acceptând că podurile se recreează. Error from server (AlreadyExists): configmaps "setari" already exists 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. Error: INSTALLATION FAILED: cannot re-use a name that is still in use Există deja un release cu acest nume în namespace. Ca să-l modifici, folosește helm upgrade (sau helm upgrade --install, care merge și la prima instalare); helm install e doar pentru release-uri noi. Î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.
