1 信號

信號是事件發生時對進程的通知機制，有時也稱之為軟件中斷。

# kill -l 1) SIGHUP       2) SIGINT       3) SIGQUIT       4) SIGILL       5) SIGTRAP      6) SIGABRT       7) SIGBUS       8) SIGFPE       9) SIGKILL 10) SIGUSR1    11) SIGSEGV     12) SIGUSR2 13) SIGPIPE    14) SIGALRM     15) SIGTERM... ...

• 1) SIGHUP當終端斷開（掛機）時，將發送該信號給終端控制進程。SIGHUP 信號還可用于守護進程（比如，init 等）。許多守護進程會在收到 SIGHUP 信號時重新進行初始化并重讀配置文件。

• 2) SIGINT當用戶鍵入終端中斷字符（通常為Control-C） 時，終端驅動程序將發送該信號給前臺進程組。該信號的默認行為是終止進程。

• 3) SIGQUIT當用戶在鍵盤上鍵入退出字符（通常為Control-）時，該信號將發往前臺進程組。默認情況下，該信號終止進程，并生成用于調試的核心轉儲文件。進程如果陷入無限循環，或者不再響應時，使用 SIGQUIT 信號就很合適。

• 9) SIGKILL此信號為 “必殺（sure kill）” 信號，處理器程序無法將其阻塞、忽略或者捕獲，故而 “一擊必殺”，總能終止程序。

• 15) SIGTERM這是用來終止進程的標準信號，也是kill、killall、pkill命令所發送的默認信號。精心設計的應用程序應當為 SIGTERM 信號設置處理器程序，以便其能夠預先清除臨時文件和釋放其它資源，從而全身而退。因此，總是應該先嘗試使用SIGTERM信號來終止進程，而把SIGKILL作為最后手段，去對付那些不響應SIGTERM信號的失控進程。

• 20) SIGTSTP這是作業控制的停止信號，當用戶在鍵盤上輸入掛起字符（通常為 Control-Z ）時，將該信號給前臺進程組，使其停止運行。

值得注意的是，Control-D不會發起信號，它表示 EOF（End-Of-File），關閉標準輸入（stdin）管道（比如可以通過Control-D退出當前 shell）。如果程序不讀取當前輸入的話，是不受 Control-D 影響的。

以上知識大部分都來自 《Linux/UNIX 系統編程手冊》，想要了解更多的，可以查看該書上冊的 20、21、22 章節。

2 ENTRYPOINT 、 CMD

CMD有三種格式：

• CMD ["executable","param1","param2"]（exec 格式, 推薦使用這種格式）

• CMD ["param1","param2"]（作為 ENTRYPOINT 指令參數）

• CMD command param1 param2（shell 格式，默認 /bin/sh -c ）

ENTRYPOINT有兩種格式：

• ENTRYPOINT ["executable", "param1", "param2"]（exec 格式，推薦優先使用這種格式）

• ENTRYPOINT command param1 param2（shell 格式）

其中，不管你Dockerfile用其中哪個指令，兩個指令都推薦使用 exec 格式，而不是 shell 格式。原因就是因為使用 shell 格式之后，程序會以/bin/sh -c的子命令啟動，并且 shell 格式下不會傳遞任何信號給程序。這也就導致，在docker stop容器的時候，以這種格式運行的程序捕捉不到發送的信號，也就談不上優雅的關閉了。

?  ~ docker stop --help
Usage:  docker stop [OPTIONS] CONTAINER [CONTAINER...]
Stop one or more running containers
Options:      --help       Print usage  -t, --time int   Seconds to wait for stop before killing it (default 10)

?  ~ docker kill --help
Usage:  docker kill [OPTIONS] CONTAINER [CONTAINER...]
Kill one or more running containers
Options:      --help            Print usage  -s, --signal string   Signal to send to the container (default "KILL")

通過 docker kill的-s選項還可以指定給容器發送的信號。

3 實例

通過 Go 寫一個簡單的信號處理器：

?  ~ cat signals.gopackage main
import (    "fmt"    "os"    "os/signal"    "syscall")
func main() {    sigs := make(chan os.Signal, 1)    done := make(chan bool, 1)
    signal.Notify(sigs, syscall.SIGINT, syscall.SIGTERM)
    go func() {        sig := <-sigs        fmt.Println()        fmt.Println(sig)        done <- true    }()
    fmt.Println("awaiting signal")    <-done    fmt.Println("exiting")}

3.1 實例 1

?  ~ GOOS=linux GOARCH=amd64 go build signals.go?  ~ lsDockerfile signals    signals.go?  ~ cat DockerfileFROM busybox
COPY signals /signals
CMD ["/signals"]    # exec 格式執行?  ~ docker build -t signals .

通過 tmux 開啟兩個面板，一個運行容器，一個執行 docker stop ：

?  ~ docker run -it --rm --name signals signalsawaiting signal
terminatedexiting

?  ~ time docker stop signalssignalsdocker stop signals  0.01s user 0.02s system 4% cpu 0.732 total?  ~

可以發現，容器停止之前，程序接收到信號并輸出相應信息，并且停止總耗時為 0.732 s，達到了優雅的效果。

修改 Dockerfile 中 CMD 執行格式，執行相同操作：

?  ~ cat DockerfileFROM busybox
COPY signals /signals
CMD /signals        # shell 格式執行?  ~ docker build -t signals .

?  ~ docker run -it --rm --name signals signalsawaiting signal?  ~

?  ~ time docker stop signalssignalsdocker stop signals  0.01s user 0.01s system 0% cpu 10.719 total

通過 shell 格式之后，可以發現容器停止之前，程序并未接收到任何信號，并且停止時間為 10.719s，說明該容器是被強制停止的。

結論很明顯，為了優雅的退出容器，我們應該采用 exec 這種格式。

3.2 實例 2

?  ~ lsDockerfile signals    signals.go start.sh?  ~ cat DockerfileFROM busybox
COPY signals /signalsCOPY start.sh /start.sh     # 引入 shell 腳本啟動
CMD ["/start.sh"]?  ~ cat start.sh#!/bin/sh
/signals?  ~

測試依然引用實例 1 中的方法：

?  ~ docker run -it --rm --name signals signalsawaiting signal?  ~

?  ~ time docker stop signalssignalsdocker stop signals  0.01s user 0.02s system 0% cpu 10.765 total?  ~

?  ~ cat start.sh#!/bin/sh
exec /signals   # 加入 exec 執行?  ~ docker build -t signals .

?  ~ docker run -it --rm --name signals signalsawaiting signal
terminatedexiting

?  ~ time docker stop signalssignalsdocker stop signals  0.02s user 0.02s system 4% cpu 0.744 total?  ~

可以看到，加入 exec 命令之后，程序又可以接收到信號正常退出了。當然，如果你 Dockerfile 中的 CMD 是以 shell 格式運行的，即使啟動腳本中加入 exec 也是無效的。再者，如果你的程序本身不能針對信號做一些處理，也就談不上優雅關閉了。