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.
| Caso | Uso típico |
|---|---|
| Activar pipefail | Detectar fallos en pipelines durante el build. |
| Usar Bash | Aprovechar características que sh no soporta. |
| Imágenes Windows | Cambiar entre cmd y PowerShell. |
| Builds consistentes | Dejar 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-existeEn 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
- Qué es un Dockerfile: ubica SHELL dentro de la construcción de imágenes.
- Instrucción RUN Dockerfile: entiende dónde suele notarse más el shell.
- Instrucción CMD Dockerfile: diferencia shell, comando por defecto y formato JSON.
- Instrucción ENTRYPOINT Dockerfile: conecta el intérprete con el proceso principal.
- índice del curso de Docker: vuelve al índice del curso.
Documentación oficial y recursos
- Dockerfile SHELL: referencia oficial de la instrucción.
- Dockerfile RUN: relación entre RUN y el shell configurado.
- Dockerfile CMD: diferencias entre forma shell y exec.
- Dockerfile ENTRYPOINT: comportamiento del proceso principal.
- Bash Reference Manual: referencia de Bash y opciones como pipefail.
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.

