...
Eroare Docker · Dockerfile și docker build

ERROR: failed to solve: When using COPY with more than one source file, the destination must be a directory and end with a /

Pe scurt

Copiezi mai multe fișiere (sau un model ca *.json) într-o destinație fără / la final, iar Docker nu știe dacă e un fișier sau un folder. Pune / la capătul destinației: COPY package.json package-lock.json ./ sau COPY a.txt b.txt /app/.

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

Ce înseamnă

La COPY sursa destinatie, destinația fără / la final poate fi un fișier: COPY config.json /app/setari.json copiază și redenumește. Cu mai multe surse, redenumirea nu are sens, deci Docker cere explicit un folder, marcat prin / la final.

Regula se aplică și când ai o singură sursă scrisă cu wildcard care se potrivește cu mai multe fișiere (COPY *.json /app): dacă modelul prinde două fișiere, apare eroarea; dacă prinde unul, merge. De aceea build-ul poate funcționa la tine și să cadă la un coleg care are un fișier în plus.

Reparația e mereu aceeași: / la finalul destinației. Folderul e creat automat dacă nu există. Același mesaj îl dă și ADD.

De ce apare: cauzele frecvente

1Două fișiere, destinație fără /

Greșit
BASH
COPY package.json package-lock.json /app
Corect
BASH
COPY package.json package-lock.json /app/

Cu / la final, /app e tratat ca folder și primește ambele fișiere.

2Wildcard care prinde mai multe fișiere

Greșit
BASH
COPY *.json .
# merge
COPY *.json /app
# eroare cu 2+ fișiere
Corect
BASH
COPY *.json /app/

Modelul poate prinde mai multe fișiere; destinația trebuie să fie folder.

3WORKDIR folosit fără ./

Greșit
BASH
WORKDIR /app
COPY requirements.txt setup.py .
Corect
BASH
WORKDIR /app
COPY requirements.txt setup.py ./

./ este folderul curent (WORKDIR), marcat explicit ca folder.

Repară tu

Repară eroarea, direct în pagină

În ~/api, Dockerfile-ul copiază package.json și server.js cu COPY package.json server.js /app, iar build-ul dă When using COPY with more than one source file, the destination must be a directory. Repară linia, construiește api:1.0 și verifică că ambele fișiere ajung în /app.

Indiciu

Destinația trebuie să se termine cu /.

Alte forme ale mesajului

  • When using COPY with more than one source file, the destination must be a directory and end with a /
  • ERROR: failed to solve: When using ADD with more than one source file, the destination must be a directory and end with a /

Cum o eviți pe viitor

Pune din obișnuință / la finalul oricărei destinații care e folder: COPY . /app/, COPY *.json ./, COPY src/ /app/src/. Lasă destinația fără / doar când chiar vrei să copiezi un singur fișier sub alt nume. Când folosești wildcard-uri, gândește-te că mâine modelul poate prinde mai multe fișiere decât azi.

Întrebări frecvente

De ce COPY . . merge fără /?

Pentru că sursa e un singur folder (contextul), iar Docker îi copiază conținutul în destinație. Regula cu / se aplică doar când sunt mai multe surse.

Trebuie să creez folderul înainte cu RUN mkdir?

Nu. COPY creează automat folderul destinație (și părinții lui) dacă nu există.

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.