docker container kill

Descripción

El subcomando docker kill termina abruptamente (kill) uno o más contenedores. Al proceso principal dentro del contenedor se le envía la señal SIGKILL (por defecto), o la señal que sea especificada con la opción --signal. Puedes hacer referencia a un contenedor mediante su ID, prefijo de ID o nombre.

La bandera --signal establece la señal de llamada del sistema que se envía al contenedor. Esta señal puede ser el nombre de una señal en el formato SIG<NOMBRE>, por ejemplo SIGINT, o un número sin signo que coincida con una posición en la tabla de llamadas al sistema del kernel, por ejemplo 2.

Aunque la señal por defecto (SIGKILL) detendrá el contenedor, la señal establecida a través de --signal puede no ser terminal, dependiendo del proceso principal del contenedor. Por ejemplo, la señal SIGHUP en la mayoría de los casos no será terminal, y el contenedor continuará ejecutándose después de recibir la señal.

Note

ENTRYPOINT y CMD en la forma de shell se ejecutan como un proceso hijo de /bin/sh -c, el cual no transmite señales. Esto significa que el ejecutable no es el PID 1 del contenedor y no recibe las señales de Unix.

Opciones

Ejemplos

Enviar una señal KILL a un contenedor

El siguiente ejemplo envía la señal SIGKILL por defecto al contenedor llamado my_container:

$ docker kill my_container

Enviar una señal personalizada a un contenedor (--signal)

El siguiente ejemplo envía una señal SIGHUP al contenedor llamado my_container:

$ docker kill --signal=SIGHUP  my_container

Puedes especificar una señal personalizada ya sea por nombre o por número. El prefijo SIG es opcional, por lo que los siguientes ejemplos son equivalentes:

$ docker kill --signal=SIGHUP my_container
$ docker kill --signal=HUP my_container
$ docker kill --signal=1 my_container

Consulta la página de manual signal(7) para obtener una lista de las señales estándar de Linux.