docker · Docker
El mensaje
exec /usr/local/bin/entrypoint.sh: exec format error
Qué significa
El núcleo no reconoció la cabecera de ese ejecutable y, hoy en día, casi siempre es un desajuste de arquitectura: una imagen arm64 construida en Apple Silicon ejecutándose en un host amd64, o lo contrario. Un script de shell sin su primera línea #!/bin/sh produce el mismo texto. Construir con docker build --platform=linux/amd64 es la respuesta habitual, pero no elimina el desajuste: lo tapa con emulación, y todo lo que pasa por QEMU es varias veces más lento que lo nativo. Para una imagen que vas a conservar, construir ambas arquitecturas con buildx es el camino que no cuesta nada en ejecución.
El arreglo
docker build --platform=linux/amd64 .- 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 «exec /usr/local/bin/entrypoint.sh: exec format error»?
El núcleo no reconoció la cabecera de ese ejecutable y, hoy en día, casi siempre es un desajuste de arquitectura: una imagen arm64 construida en Apple Silicon ejecutándose en un host amd64, o lo contrario. Un script de shell sin su primera línea #!/bin/sh produce el mismo texto. Construir con docker build --platform=linux/amd64 es la respuesta habitual, pero no elimina el desajuste: lo tapa con emulación, y todo lo que pasa por QEMU es varias veces más lento que lo nativo. Para una imagen que vas a conservar, construir ambas arquitecturas con buildx es el camino que no cuesta nada en ejecución.
Q. ¿Cómo se arregla?
docker build --platform=linux/amd64 . — antes de ejecutarlo, mira arriba qué descarta este comando.
Q. ¿Qué herramienta lo imprime?
docker. Está en Docker y el mensaje tiene 5 palabras.