Instrucción SHELL Dockerfile

instruccion-shell
instruccion-shell

En esta lección aprenderás qué hace la Instrucción SHELL Dockerfile y cuándo tiene sentido cambiar el intérprete que Docker usa para ejecutar instrucciones en forma shell. Es útil, pero no debería usarse por costumbre.

Por defecto, Docker ejecuta muchas instrucciones con el shell definido por la imagen base. En Linux normalmente será sh; en Windows puede variar. SHELL permite cambiar ese comportamiento para las instrucciones siguientes del Dockerfile.

👉 Y recuerda, si quieres aprender más de Linux, visita el curso de Linux gratis.

🐳 Si quieres aprender más de Docker, visita el curso de Docker gratis.

Para qué sirve SHELL

Problema: algunas imágenes necesitan ejecutar comandos de build con un intérprete concreto, opciones estrictas o comportamiento distinto al shell por defecto.

Qué aporta Docker: SHELL cambia el intérprete usado por instrucciones posteriores en forma shell, como RUN, CMD o ENTRYPOINT cuando se escriben sin formato JSON.

CasoUso típico
Activar pipefailDetectar fallos en pipelines durante el build.
Usar BashAprovechar características que sh no soporta.
Imágenes WindowsCambiar entre cmd y PowerShell.
Builds consistentesDejar explícito qué intérprete ejecuta los comandos.

Ejemplo de Instrucción SHELL Dockerfile

Un uso habitual en Linux es cambiar a Bash con pipefail para que un pipeline fallido no pase desapercibido durante la construcción de la imagen.

FROM debian:12-slim

SHELL ["/bin/bash", "-o", "pipefail", "-c"]

RUN echo "uno" | grep uno
RUN echo "fallo" | grep no-existe

En este ejemplo, la segunda instrucción RUN debe fallar porque grep no encuentra el texto. Eso es justo lo que quieres en un build serio: que el error aparezca durante la construcción y no más tarde.

Construir y verificar el shell

Después de editar el Dockerfile, construye la imagen y verifica qué shell quedó configurado. Si el build falla, revisa si el fallo es esperado por pipefail o si realmente escribiste mal el comando.

docker build -t demo-shell:1.0 .

docker image inspect demo-shell:1.0 --format '{{json .Config.Shell}}' 

Resultado esperado: inspect debe mostrar el array de shell configurado. Si no aparece como esperas, quizá inspeccionaste otra imagen o la instrucción SHELL no quedó antes de los comandos que querías afectar.

Cuándo usar SHELL y cuándo no

SHELL es útil cuando necesitas cambiar el intérprete de forma global para parte del Dockerfile. Si solo quieres ejecutar un comando concreto con Bash, muchas veces basta con hacerlo explícito en esa instrucción.

# Ejemplo conceptual para imágenes Windows
SHELL ["powershell", "-Command"]
RUN Write-Host "Construyendo con PowerShell"
  • Úsala con intención: cambia el comportamiento de las instrucciones siguientes.
  • No la mezcles sin control: alternar shells muchas veces vuelve difícil leer el Dockerfile.
  • Prefiere formato JSON cuando importe: evita sorpresas de expansión del shell.
  • Comprueba la imagen base: no todas incluyen Bash, PowerShell u otros intérpretes.

Errores comunes

  • Usar SHELL para arreglar un Dockerfile sin entender qué comando está fallando.
  • Asumir que Bash existe en imágenes mínimas como Alpine o slim.
  • Olvidar que SHELL afecta a las instrucciones posteriores, no solo a una línea.
  • Confundir SHELL con CMD: SHELL define intérprete; CMD define comando por defecto.
  • Romper builds multiplataforma usando un shell que solo existe en una familia de imágenes.
  • Ocultar errores de pipeline por no usar opciones estrictas cuando hacen falta.

La regla práctica para Instrucción SHELL Dockerfile es esta: úsala cuando el intérprete forme parte de la intención del build y quieras dejarlo explícito para quien mantenga la imagen.

Lecciones relacionadas del curso Docker

Documentación oficial y recursos

En resumen, la Instrucción SHELL Dockerfile cambia el intérprete usado por instrucciones posteriores del Dockerfile. Bien aplicada, mejora builds que necesitan Bash, PowerShell u opciones estrictas.

No la uses como decoración: cada cambio de shell debe explicar mejor el build, no hacerlo más confuso. Si basta con un comando explícito, mantén el Dockerfile simple.

Comentarios

No hay comentarios aún. ¿Por qué no comienzas el debate?

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *