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

docker: Error response from daemon: network-scoped alias is supported only for containers in user defined networks.

Pe scurt

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

Greșit
BASH
docker run -d --name cache --network-alias redis redis:7
Corect
BASH
docker 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ă

Greșit
BASH
docker run -d --network bridge --network-alias db postgres:16
Corect
BASH
docker run -d --network magazin-net --network-alias db -e POSTGRES_PASSWORD=parola postgres:16

Doar rețelele proprii acceptă aliasuri.

3Alias la conectarea ulterioară

Greșit
BASH
docker network connect --alias api bridge web
Corect
BASH
docker network connect --alias api magazin-net web

Aceeași regulă la network connect: aliasul se dă într-o rețea proprie.

Repară tu

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

Alte forme ale mesajului

  • Error response from daemon: network-scoped alias is supported only for containers in user defined networks
  • docker: 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

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