docker container stop

Descripción

El proceso principal dentro del contenedor recibirá SIGTERM y, tras un período de gracia, SIGKILL. La primera señal se puede cambiar con la instrucción STOPSIGNAL en el Dockerfile del contenedor, o con la opción --stop-signal de docker run y docker create.

Opciones

Ejemplos

$ docker stop my_container

Detener contenedor con señal (-s, --signal)

El flag --signal envía la señal de llamada al sistema al contenedor para que finalice. Esta señal puede ser un nombre de señal en el formato SIG<NOMBRE>, por ejemplo SIGKILL, o un número entero sin signo que coincida con una posición en la tabla de llamadas al sistema del kernel, por ejemplo 9. Consulta signal(7) para conocer las señales disponibles.

La señal por defecto a utilizar está definida por el StopSignal de la imagen, que se puede establecer a través de la instrucción de Dockerfile STOPSIGNAL al construir la imagen, o configurarse mediante la opción --stop-signal al crear el contenedor. Si no se configura ninguna señal para el contenedor, se utiliza SIGTERM por defecto.

Detener contenedor con tiempo de espera (-t, --timeout)

El flag --timeout establece el número de segundos a esperar a que el contenedor se detenga después de enviar la señal de llamada al sistema predefinida (ver --signal). Si el contenedor no finaliza una vez transcurrido el tiempo de espera, se le termina abruptamente por la fuerza con una señal SIGKILL.

Si estableces --timeout en -1, no se aplica ningún tiempo de espera y el demonio espera indefinidamente a que el contenedor finalice.

El tiempo de espera predeterminado se puede especificar mediante la opción --stop-timeout al crear el contenedor. Si no se configura ningún valor predeterminado para el contenedor, el demonio determina el valor predeterminado, que es de 10 segundos para contenedores Linux y de 30 segundos para contenedores Windows.