docker · Docker
A mensagem
COPY failed: file not found in build context or excluded by .dockerignore
O que significa
O COPY só pega arquivos de dentro do contexto de build, e o arquivo não está lá. O contexto é o último argumento do docker build, então normalmente você apontou para uma pasta acima com ../x, ou o .dockerignore filtrou o arquivo — clássico quando node_modules ou *.env está ignorado e depois se copia algo de dentro dele. A mensagem cita as duas causas, então leia cat .dockerignore primeiro e reescreva o caminho a partir da raiz do contexto. Alargar o contexto para resolver significa enviar a pasta inteira ao daemon, e todo build fica mais lento.
A correção
cat .dockerignore- Impresso por
- docker
- Docker
- 12
Os erros do Docker só ficam legíveis quando você os coloca numa camada — o cliente que não alcança o daemon, o registro que te recusa, um RUN que falha durante o build e um contêiner que morre ao subir são quatro problemas diferentes — e nas camadas de build e execução a linha em si não é o motivo: o motivo está na saída do comando que rodava dentro, e o preço de cada correção também muda por camada.
Como ler uma mensagem de erro
- Leia da primeira linha para baixo. Quanto mais abaixo, mais são as tripas da ferramenta; a causa costuma estar no topo.
- Se há arquivo e número de linha, comece ali — não o quadro superior da pilha, e sim a linha mais alta que nomeie um arquivo seu.
- Pesquise a mensagem literal, mas tire primeiro seus caminhos e nomes de variáveis: é isso que impede a busca de casar.
- A mesma condição é redigida de formas diferentes conforme a versão. Se os resultados não batem, some o número da versão.
- Antes de colar uma correção, veja o que ela descarta. Algumas não dá para desfazer.
Perguntas frequentes
Q. O que significa “COPY failed: file not found in build context or excluded by .dockerignore”?
O COPY só pega arquivos de dentro do contexto de build, e o arquivo não está lá. O contexto é o último argumento do docker build, então normalmente você apontou para uma pasta acima com ../x, ou o .dockerignore filtrou o arquivo — clássico quando node_modules ou *.env está ignorado e depois se copia algo de dentro dele. A mensagem cita as duas causas, então leia cat .dockerignore primeiro e reescreva o caminho a partir da raiz do contexto. Alargar o contexto para resolver significa enviar a pasta inteira ao daemon, e todo build fica mais lento.
Q. Como corrigir?
cat .dockerignore — antes de rodar, veja acima o que este comando descarta.
Q. Qual ferramenta imprime isso?
docker. Fica em Docker e a mensagem tem 12 palavras.