docker: Error response from daemon: network-scoped alias is supported only for containers in user defined networks.
Ai folosit --network-alias fără o rețea proprie, iar rețeaua implicită bridge nu are DNS, deci nu acceptă aliasuri. Creează o rețea (docker network create magazin-net) și pornește containerul cu --network magazin-net --network-alias nume.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un alias de rețea e un nume în plus sub care containerul poate fi găsit de celelalte containere din aceeași rețea (de exemplu containerul cache răspunde și la redis). Numele se rezolvă prin DNS-ul intern al Docker, care există doar în rețelele create de tine (și în cele ale proiectelor Compose).
Rețeaua implicită bridge, folosită când nu dai --network, nu are DNS între containere. De aceea daemon-ul refuză --network-alias acolo, cu mesajul acesta, iar containerul nu e creat.
Apare des când copiezi o comandă din documentație și sari peste docker network create, când scrii --network-alias fără --network, sau când folosești --network bridge explicit.
De ce apare: cauzele frecvente
1Alias fără --network
docker run -d --name cache --network-alias redis redis:7docker network create magazin-net
docker run -d --name cache --network magazin-net --network-alias redis redis:7În magazin-net, DNS-ul Docker rezolvă și cache, și aliasul redis.
2Rețeaua bridge explicită
docker run -d --network bridge --network-alias db postgres:16docker run -d --network magazin-net --network-alias db -e POSTGRES_PASSWORD=parola postgres:16Doar rețelele proprii acceptă aliasuri.
3Alias la conectarea ulterioară
docker network connect --alias api bridge webdocker network connect --alias api magazin-net webAceeași regulă la network connect: aliasul se dă într-o rețea proprie.
Repară eroarea, direct în pagină
Aplicația caută cache-ul la numele redis, iar docker run -d --name cache --network-alias redis redis:7 dă network-scoped alias is supported only for containers in user defined networks. Rețeaua magazin-net există deja. Pornește containerul cache din redis:7 în ea, cu aliasul redis.
Indiciu
Adaugă --network magazin-net la aceeași comandă.
Reparația
docker run -d --name cache --network magazin-net --network-alias redis redis:7
docker inspect -f '{{json .NetworkSettings.Networks}}' cacheDe ce merge
Fără --network, containerul ajungea în rețeaua implicită bridge, care nu are DNS și nu acceptă aliasuri. În magazin-net, daemon-ul înregistrează containerul sub numele cache și sub aliasul redis, deci orice alt container din rețea se conectează cu redis:6379.
Alte forme ale mesajului
Error response from daemon: network-scoped alias is supported only for containers in user defined networksdocker: Error response from daemon: network-scoped aliases are only supported for user-defined networks.
Cum o eviți pe viitor
Pentru aplicații cu mai multe containere, creează mereu o rețea proprie (sau folosește Compose, care o creează automat) și pornește toate containerele în ea. Acolo containerele se găsesc după nume, iar aliasurile merg. Verifică aliasurile cu docker inspect -f '{{json .NetworkSettings.Networks}}' nume (câmpurile Aliases și DNSNames).
Întrebări frecvente
La ce folosește un alias, dacă am deja numele containerului?
Aplicația poate folosi un nume stabil (redis, db) indiferent cum se numește containerul, iar mai multe containere pot avea același alias, ca DNS-ul să împartă cererile între ele.
În Compose cum pun un alias?
Sub serviciu: networks: { default: { aliases: [redis] } }. Numele serviciului e oricum rezolvabil, deci aliasul e doar un nume în plus.
Erori înrudite
ping: bad address 'cache' Containerul nu poate traduce numele altui container în adresă IP, pentru că sunt pe rețeaua bridge implicită, unde Docker nu oferă DNS după nume. Creează o rețea proprie (docker network create magazin) și leagă ambele containere de ea; acolo numele containerelor se rezolvă automat. docker: Error response from daemon: network magazin-net not found. Rețeaua dată la --network nu există pe acest daemon: n-a fost creată încă, are alt nume sau a fost ștearsă. Creeaz-o cu docker network create magazin-net (sau verifică numele cu docker network ls), apoi pornește containerul. Error response from daemon: endpoint with name api already exists in network magazin-net 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. Î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.
