docker kill¶
補足説明¶
docker kill
サブコマンドは、1つまたは複数のコンテナを SIGKILL
シグナルを送信するか、 --signal
オプションで指定したシグナルを送信します。コンテナの指定には、 ID、 ID の短縮形、コンテナ名が使えます。
--signal
(または短縮形の -s
)フラグは、コンテナに対して送信する、システムコールのシグナルを指定します。このシグナルには、 SIGINT
のように SIG<NAME>
形式のシグナル名も指定できます。あるいは、 2
のように、カーネルのシステムコール表で対応する数値です。
デフォルトの( SIGKILL
)シグナルがコンテナを終了させようとしますが、 --signal
で指定したシグナルを渡すのが(コンテナの)終了を意味するのではなく、(動作は)コンテナのメイン・プロセスに依存します。たとえば、ほとんどの SIGHUP
は終了ではなく、コンテナはシグナルを受信した後も実行し続けます。
コマンドの使用例は、以下の 使用例のセクション をご覧ください。
使用例¶
コンテナに KILL シグナルを送信¶
以下の例は、 my_container
という名前のコンテナに対して、デフォルトの SIGKILL
シグナルを送信します。
$ docker kill my_container
コンテナに任意のシグナルを送信¶
以下の例は、 my_container
という名前のコンテナに対して、 SIGHUP
シグナルを送信します。
$ docker kill --signal=SIGHUP my_container
「名前」あるいは「番号」のどちらかでも任意のシグナルを指定できます。 SIG
を冒頭に付けるのはオプションのため、以下の例はどれも同じです。
$ docker kill --signal=SIGHUP my_container
$ docker kill --signal=HUP my_container
$ docker kill --signal=1 my_container
標準 Linux シグナルの一覧は signal(7) の man ページをご覧ください。