...
Eroare Docker · Rețele, porturi și volume

Error response from daemon: endpoint with name api already exists in network magazin-net

Pe scurt

Containerul e deja conectat la acea rețea, așa că docker network connect nu mai are ce face. Verifică cu docker network inspect sau docker inspect: dacă vrei un alias în plus, deconectează-l întâi (docker network disconnect), apoi conectează-l din nou cu --alias.

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

Ce înseamnă

Fiecare container conectat la o rețea are acolo un endpoint: interfața lui de rețea, cu IP și nume DNS. docker network connect magazin-net api cere crearea unui endpoint nou pentru api, dar daemon-ul găsește deja unul cu același nume în magazin-net și refuză.

Cazurile tipice: containerul a fost pornit direct în rețea (docker run --network magazin-net) și apoi un script îl mai conectează o dată; scriptul de configurare rulează a doua oară; sau vrei să adaugi un alias (--alias baza) unui container deja conectat, ceea ce nu se poate face prin încă un connect.

Eroarea nu strică nimic: containerul rămâne conectat ca înainte. Vezi rețelele lui cu docker inspect -f '{{json .NetworkSettings.Networks}}' api.

De ce apare: cauzele frecvente

1Conectat deja la pornire

Greșit
BASH
docker run -d --name api --network magazin-net nginx
docker network connect magazin-net api
Corect
BASH
docker run -d --name api --network magazin-net nginx

--network la pornire face deja conexiunea; al doilea connect e în plus.

2Vrei un alias nou

Greșit
BASH
docker network connect --alias backend magazin-net api
Corect
BASH
docker network disconnect magazin-net api
docker network connect --alias backend magazin-net api

Alias-urile se dau la conectare; deconectezi și reconectezi cu alias-ul dorit.

3Script rulat de două ori

Greșit
BASH
docker network connect magazin-net api
Corect
BASH
docker network inspect -f '{{range .Containers}}{{.Name}} {{end}}' magazin-net | grep -qw api || docker network connect magazin-net api

Conectezi doar dacă containerul nu apare deja în rețea.

Repară tu

Repară eroarea, direct în pagină

API-ul api rulează deja în rețeaua magazin-net, iar acum vrei ca baza de date să-l găsească și sub numele backend. docker network connect --alias backend magazin-net api dă endpoint with name api already exists. Fă ca api să fie în magazin-net cu alias-ul backend și verifică dintr-un container busybox cu ping -c 1 backend.

Indiciu

Alias-ul se dă la conectare: deconectează api din rețea și conectează-l din nou cu --alias.

Alte forme ale mesajului

  • Error response from daemon: endpoint with name db already exists in network magazin_default
  • Error response from daemon: endpoint with name api already exists in network bridge

Cum o eviți pe viitor

Hotărăște rețelele la pornire (--network) sau în compose.yaml (networks:) și nu le mai modifica din scripturi separate. Când un script trebuie să fie sigur la rulări repetate, verifică întâi cu docker network inspect ce containere sunt în rețea. Alias-urile se dau la docker run --network-alias sau la connect --alias, o singură dată.

Întrebări frecvente

Un container poate fi în mai multe rețele?

Da. Îl pornești într-una cu --network și îl adaugi în altele cu docker network connect. Primește câte un IP în fiecare rețea și poate vorbi cu containerele din toate.

Ce e un endpoint?

Conexiunea unui container la o rețea: interfața de rețea, adresa IP și numele sub care îl găsesc celelalte containere. docker network inspect le listează la Containers.

Erori înrudite

← Toate erorile Docker

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ță Docker de la zero, cu exerciții la fiecare lecție

Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.