docker · Docker
El mensaje
failed to register layer: Error processing tar file(exit status 1): no space left on device
Qué significa
No queda espacio en el disco para descomprimir la capa de la imagen. Normalmente el proyecto no es grande: es Docker que sigue guardando meses de imágenes viejas, caché de compilación y volúmenes de contenedores que ya borraste. docker system df muestra cuánto ocupan imágenes, contenedores, volúmenes y caché de compilación y cuánto es recuperable, así que léelo antes de borrar nada. docker system prune elimina contenedores parados, imágenes colgantes, redes sin usar y la caché de compilación —la siguiente compilación será claramente más lenta sin esa caché— y añadir --volumes borra además los volúmenes no vinculados a un contenedor, que es exactamente donde la gente pierde sus bases de datos.
El arreglo
docker system df- 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 «failed to register layer: Error processing tar file(exit status 1): no space left on device»?
No queda espacio en el disco para descomprimir la capa de la imagen. Normalmente el proyecto no es grande: es Docker que sigue guardando meses de imágenes viejas, caché de compilación y volúmenes de contenedores que ya borraste. docker system df muestra cuánto ocupan imágenes, contenedores, volúmenes y caché de compilación y cuánto es recuperable, así que léelo antes de borrar nada. docker system prune elimina contenedores parados, imágenes colgantes, redes sin usar y la caché de compilación —la siguiente compilación será claramente más lenta sin esa caché— y añadir --volumes borra además los volúmenes no vinculados a un contenedor, que es exactamente donde la gente pierde sus bases de datos.
Q. ¿Cómo se arregla?
docker system df — antes de ejecutarlo, mira arriba qué descarta este comando.
Q. ¿Qué herramienta lo imprime?
docker. Está en Docker y el mensaje tiene 15 palabras.