...
Eroare Docker · Docker Compose

services.deploy.replicas: can't set container_name and worker as container name must be unique: invalid compose project

Pe scurt

Ai cerut mai multe instanțe ale unui serviciu (deploy.replicas sau --scale), dar serviciul are container_name fix, iar numele de containere trebuie să fie unice. Șterge container_name și lasă Compose să numească instanțele (proiect-worker-1, -2, -3).

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

Ce înseamnă

container_name fixează numele exact al containerului. Cu replicas: 3 (sau docker compose up --scale worker=3), Compose ar trebui să creeze trei containere cu același nume, ceea ce Docker nu permite. Compose observă conflictul înainte de pornire și declară proiectul invalid.

Fără container_name, Compose numește singur instanțele: proiect-serviciu-1, proiect-serviciu-2 etc. Le găsești în continuare după numele serviciului: în rețeaua proiectului, numele worker se rezolvă la toate instanțele, iar comenzile acceptă serviciul (docker compose logs worker, docker compose exec --index 2 worker sh).

Păstrează container_name doar pentru servicii cu o singură instanță, unde chiar ai nevoie de un nume fix (de exemplu pentru scripturi externe).

De ce apare: cauzele frecvente

1replicas cu nume fix

Greșit
BASH
worker:
  image: busybox
  container_name: worker
  deploy:
    replicas: 3
Corect
BASH
worker:
  image: busybox
  deploy:
    replicas: 3

Compose dă fiecărei instanțe un nume unic, cu număr la final.

2--scale pe un serviciu cu nume fix

Greșit
BASH
docker compose up -d --scale api=2   # api are container_name
Corect
BASH
# scoate container_name de la api
docker compose up -d --scale api=2

Fiecare instanță are nevoie de alt nume de container.

Repară tu

Repară eroarea, direct în pagină

În ~/comenzi, serviciul worker trebuie să ruleze în trei instanțe (deploy.replicas: 3), dar docker compose up -d dă can't set container_name and worker as container name must be unique. Repară compose.yaml și pornește cele trei instanțe.

Indiciu

Un nume de container fix nu poate fi folosit de trei containere: scoate container_name.

Alte forme ale mesajului

  • services.deploy.replicas: can't set container_name and api as container name must be unique: invalid compose project
  • WARNING: The "worker" service is using the custom container name "worker". Docker requires each container to have a unique name. Remove the custom name to scale the service.

Cum o eviți pe viitor

Nu pune container_name din obișnuință: numele generate de Compose sunt previzibile și permit scalarea. Adresează serviciile după numele serviciului (în rețea și în comenzile docker compose). Dacă un serviciu trebuie scalat mai târziu, verifică dinainte cu docker compose config că nu are nume fix.

Întrebări frecvente

Cum mă conectez la o anumită instanță?

Cu docker compose exec --index 2 worker sh sau direct cu numele containerului: docker exec -it comenzi-worker-2 sh.

Pot scala un serviciu care publică un port fix?

Nu cu același port pe calculator: a doua instanță ar da port is already allocated. Publică doar portul containerului (- "80"), lasă Docker să aleagă porturi diferite sau pune un proxy în față.

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.