...
Eroare Kubernetes · Manifeste YAML, apply și câmpuri invalide

Error from server (AlreadyExists): error when creating "web.yaml": deployments.apps "web" already exists

Pe scurt

Î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

Greșit
YAML
kubectl create -f web.yaml   # a doua oară
Corect
YAML
kubectl apply -f web.yaml

create nu modifică obiecte existente. apply le creează sau le actualizează.

2Comanda imperativă rulată de două ori

Greșit
YAML
kubectl create deployment web --image=nginx:1.27
kubectl create deployment web --image=nginx:1.26
Corect
YAML
kubectl set image deployment/web nginx=nginx:1.26

Obiectul există deja; schimbi doar ce vrei, cu set, scale sau edit.

3Vrei să înlocuiești complet obiectul

Greșit
YAML
kubectl create -f web.yaml
Corect
YAML
kubectl replace -f web.yaml   # sau --force pentru recreare

replace înlocuiește obiectul existent cu cel din fișier.

Repară tu

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.

Alte forme ale mesajului

  • Error from server (AlreadyExists): configmaps "setari" already exists
  • Error 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 create doar 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

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