¿Qué hacen set -e y exec “$ @” para los scripts de punto de entrada de Docker?

He notado que muchos scripts entrypoint.sh para Docker hacen algo como esto:

#!/bin/bash
set -e

... code ...

exec "[email protected]"

¿Para qué son set -ey exec "[email protected]"para qué?

Básicamente, toma los argumentos de la línea de comandos que se le pasan entrypoint.shy los ejecuta como un comando. La intención es básicamente "Hacer todo en este script .sh, luego en el mismo shell ejecutar el comando que el usuario pasa en la línea de comandos".

Ver:

• ¿Cuáles son las variables especiales de caparazón del signo de dólar?
• Necesita explicaciones para el comportamiento del comando ejecutivo integrado bash de Linux

set -eestablece una opción de shell para salir inmediatamente si algún comando que se está ejecutando sale con un código de salida distinto de cero. El script volverá con el código de salida del comando que falla. Desde la página de manual de bash:

set -e:

Salga inmediatamente si una canalización (que puede consistir en un solo comando simple), una lista o un comando compuesto (ver SHELL GRAMMAR arriba), sale con un estado distinto de cero. El shell no sale si el comando que falla es parte de la lista de comandos inmediatamente después de una palabra clave while o until, parte de la prueba que sigue a las palabras reservadas if o elif, parte de cualquier comando ejecutado en && o || lista excepto el comando que sigue al final && o ||, cualquier comando en una canalización excepto el último, o si el valor de retorno del comando se invierte con!. Si un comando compuesto que no sea un subshell devuelve un estado distinto de cero porque un comando falló mientras se ignoraba -e, el shell no se cierra. Una trampa en ERR, si se establece, se ejecuta antes de que salga el shell.

Si un comando compuesto o una función de shell se ejecuta en un contexto donde se ignora -e, ninguno de los comandos ejecutados dentro del comando compuesto o el cuerpo de la función se verá afectado por la configuración de -e, incluso si -e está establecido y un comando devuelve un estado de falla. Si un comando compuesto o una función de shell establece -e mientras se ejecuta en un contexto donde se ignora -e, esa configuración no tendrá ningún efecto hasta que se complete el comando compuesto o el comando que contiene la llamada a la función.

exec "[email protected]"se usa generalmente para hacer que el punto de entrada sea un paso que luego ejecuta el comando docker. Reemplazará el shell en ejecución actual con el comando al que "[email protected]"apunta. De forma predeterminada, esa variable apunta a los argumentos de la línea de comandos.

Si tiene una imagen con un punto de entrada que apunta a entrypoint.sh y ejecuta su contenedor como docker run my_image server start, eso se traducirá en ejecutarse entrypoint.sh server starten el contenedor. En la línea ejecutiva entrypoint.sh, el shell que se ejecuta como pid 1 se reemplazará por el comando server start.

Esto es fundamental para el manejo de señales. Sin usarlo exec, el server startdel ejemplo anterior se ejecutaría como otro pid y, después de salir, volvería a su script de shell. Con un shell en pid 1, un SIGTERM se ignorará por defecto. Eso significa que docker stopel serverproceso nunca recibiría la elegante señal de parada que envía a su contenedor . Después de 10 segundos (por defecto), docker stoprenunciaría al cierre ordenado y enviaría un SIGKILL que obligará a su aplicación a salir, pero con una posible pérdida de datos o conexiones de red cerradas, que los desarrolladores de la aplicación podrían haber codificado si recibieron la señal. También significa que su contenedor siempre tardará 10 segundos en detenerse.

Tenga en cuenta que con comandos de shell como shifty set --, puede cambiar el valor de "[email protected]". Por ejemplo, aquí hay una pequeña parte de un script que elimina el /bin/sh -c "..."del comando que puede aparecer si usa la sintaxis de shell de Docker para CMD:

# convert `/bin/sh -c "server start"` to `server start`
if [ $# -gt 1 ] && [ x"$1" = x"/bin/sh" ] && [ x"$2" = x"-c" ]; then
  shift 2
  eval "set -- $1"
fi

....

exec "[email protected]"

set -e - salir del script si falla algún comando (valor distinto de cero)

exec "[email protected]"- redireccionará las variables de entrada, vea más aquí