docker · Docker
El mensaje
COPY failed: file not found in build context or excluded by .dockerignore
Qué significa
COPY solo puede tomar archivos de dentro del contexto de compilación, y el archivo no está ahí. El contexto es el último argumento de docker build, así que normalmente apuntaste a una carpeta superior con ../x, o .dockerignore filtró el archivo: clásico cuando se ignora node_modules o *.env y luego se copia algo de dentro. El mensaje nombra ambas causas, así que lee primero cat .dockerignore y reescribe la ruta relativa a la raíz del contexto. Ampliar el contexto para arreglarlo implica enviar toda la carpeta al demonio, y cada compilación se vuelve más lenta.
El arreglo
cat .dockerignore- Lo imprime
- docker
- Docker
- 12
Los errores de Docker solo se vuelven legibles cuando los sitúas en una capa —el cliente que no alcanza al demonio, el registro que te rechaza, un RUN que falla durante la compilación y un contenedor que muere al arrancar son cuatro problemas distintos— y en las capas de compilación y ejecución la línea en sí no es el motivo: el motivo está en la salida del comando que corría dentro, y el precio de cada arreglo también cambia según la capa.
Cómo leer un mensaje de error
- Lee desde la primera línea. Cuanto más abajo, más son las tripas de la herramienta; la causa suele estar arriba.
- Si hay un archivo y un número de línea, empieza ahí: no el marco superior de la pila, sino la línea más alta que nombre un archivo tuyo.
- Busca el mensaje literal, pero quita antes tus rutas y nombres de variables: eso es lo que impide que la búsqueda coincida.
- La misma condición se redacta distinto según la versión. Si los resultados no cuadran, añade el número de versión.
- Antes de pegar un arreglo, comprueba qué descarta. Algunos no se pueden deshacer.
Preguntas frecuentes
Q. ¿Qué significa «COPY failed: file not found in build context or excluded by .dockerignore»?
COPY solo puede tomar archivos de dentro del contexto de compilación, y el archivo no está ahí. El contexto es el último argumento de docker build, así que normalmente apuntaste a una carpeta superior con ../x, o .dockerignore filtró el archivo: clásico cuando se ignora node_modules o *.env y luego se copia algo de dentro. El mensaje nombra ambas causas, así que lee primero cat .dockerignore y reescribe la ruta relativa a la raíz del contexto. Ampliar el contexto para arreglarlo implica enviar toda la carpeta al demonio, y cada compilación se vuelve más lenta.
Q. ¿Cómo se arregla?
cat .dockerignore — antes de ejecutarlo, mira arriba qué descarta este comando.
Q. ¿Qué herramienta lo imprime?
docker. Está en Docker y el mensaje tiene 12 palabras.