文章来源：http://www.jb51.net/article/96617.htm
最近公司在试验如何将项目部署到docker容器中去，这其中涉及到一个技术环节，那就是如何让docker容器优雅的终止。所谓优雅终止，指的就是程序在退出前有清理资源，保存必要中间状态，持久化内存数据的机会。下面通过这篇大家一起由简单到复杂逐一考量一下。
前言
在Docker大行其道的今天，我们能够非常方便的使用容器打包我们的应用程序，并且将它在我们的服务器上部署并运行起来。但是，谈论到如何停掉运行中的docker容器并正确的终止其中的程序，这就成为一个非常值得讨论的话题了。
事实上，在我们日常的项目当中，这是我们经常需要面对和处理的问题：
场景A：假如我们打包在容器中的程序，提供HTTP方式的服务，负责处理各种HTTP requests并返回结果，我们必然希望在容器被停掉的时候，能够让程序有时间把已经在处理中的请求继续处理完毕，并返回结果给客户端。
场景B：又比如我们打包在容器中的程序，负责写入数据到某个数据文件中，我们希望程序能够在容器被停掉的时候，有时间把内存中缓存的数据持久化到存储设备中，以防数据丢失。
场景C：再比如现在流行的微服务架构中，一般会有服务发现的机制，也即每一个微服务在启动之后，都会主动把自己的地址信息注册到服务发现模块当中，让其他的服务可以知道自己的存在。而在容器被停掉的时候，微服务需要即时从服务发现模块中注销自己，以防止从API Gateway而来的请求被错误的路由到了已经被停止掉的微服务。
如上的各种场景中，都要求打包在容器中的应用程序能够被优雅的终止(也即gracefully shutdown)，这种gracefully shutdown的方式，允许程序在容器被停止的时候，有一定时间做一些后续处理操作，这也是我们需要进一步探讨的话题。
docker stop 与 docker kill 的区别
Docker本身提供了两种终止容器运行的方式，即docker stop与docker kill。
docker stop
先来说说docker stop吧，当我们用docker stop命令来停掉容器的时候，docker默认会允许容器中的应用程序有10秒的时间用以终止运行。所以我们查看docker stop命令帮助的时候，会有如下的提示:
?
1
2
3
4
5
6
→ 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 stop命令执行的时候，会先向容器中PID为1的进程发送系统信号SIGTERM，然后等待容器中的应用程序终止执行，如果等待时间达到设定的超时时间，或者默认的10秒，会继续发送SIGKILL的系统信号强行kill掉进程。在容器中的应用程序，可以选择忽略和不处理SIGTERM信号，不过一旦达到超时时间，程序就会被系统强行kill掉，因为SIGKILL信号是直接发往系统内核的，应用程序没有机会去处理它。在使用docker stop命令的时候，我们唯一能控制的是超时时间，比如设置为20秒超时:
?
1
docker stop –time=20 container_name
docker kill
接着我们来看看docker kill命令，默认情况下，docker kill命令不会给容器中的应用程序有任何gracefully shutdown的机会。它会直接发出SIGKILL的系统信号，以强行终止容器中程序的运行。通过查看docker kill命令的帮助，我们可以看到，除了默认发送SIGKILL信号外，还允许我们发送一些自定义的系统信号：
?
1
2
3
4
5
6
→ 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中的程序发送SIGINT信号，我们可以这样来实现：
?
1
docker kill –signal=SIGINT container_name
与docker stop命令不一样的地方在于，docker kill没有任何的超时时间设置，它会直接发送SIGKILL信号，以及用户通过signal参数指定的其他信号。
其实不难看出，docker stop命令，更类似于Linux系统中的kill命令，二者都是发送系统信号SIGTERM。而docker kill命令，更像是Linux系统中的kill -9或者是kill -SIGKILL命令，用来发送SIGKILL信号，强行终止进程。
在程序中接收并处理信号
了解了docker stop与docker kill的区别，我们能够知道，docker kill适合用来强行终止程序并实现快速停止容器。而如果希望程序能够gracefully shutdown的话，docker stop才是不二之选。这样，我们可以让程序在接收到SIGTERM信号后，有一定的时间处理、保存程序执行现场，优雅的退出程序。
接下来我们可以写一个简单的Go程序来实现信号的接收与处理，程序在启动过后，会一直阻塞并监听系统信号，直到监测到对应的系统信号后，输出控制台并退出执行。
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// main.go
package main
import (
“fmt”
“os”
“os/signal”
“syscall”
)
func main() {
fmt.Println(“Program started…”)
ch := make(chan os.Signal, 1)
signal.Notify(ch, syscall.SIGTERM)
s := <-ch
if s == syscall.SIGTERM {
fmt.Println(“SIGTERM received!”)
//Do something…
}
fmt.Println(“Exiting…”)
}
接下来使用交叉编译的方式来编译程序，让程序可以在Linux下运行:
?
1
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o graceful
编译好之后，我们还需要打包程序到容器中运行。于是，我们还得有个Dockerfile。在这里，我们选择使用体积小又轻盈的alpine镜像作为基础镜像，打包这个Go程序:
?
1
2
3
4
from alpine:latest
MAINTAINER Timothy
ADD graceful /graceful
CMD [“/graceful”]
这里需要避开的一个坑，是Dockerfile中CMD命令的用法。
CMD命令有两种方式：
?
1
CMD /graceful
使用 CMD command param1 param2 这种方式，其实是以shell的方式运行程序。最终程序被执行时，类似于/bin/sh -c的方式运行了我们的程序，这样会导致/bin/sh以PID为1的进程运行，而我们的程序只不过是它fork/execs出来的子进程而已。前面我们提到过docker stop的SIGTERM信号只是发送给容器中PID为1的进程，而这样，我们的程序就没法接收和处理到信号了。
?
1
CMD [“/graceful”]
使用 CMD [“executable”,”param1”,”param2”] 这种方式启动程序，才是我们想要的，这种方式执行和启动时，我们的程序会被直接启动执行，而不是以shell的方式，这样我们的程序就能以PID=1的方式开始执行了。
话题转回来，我们开始执行容器构建操作，打包程序：
?
1
docker build -t registry.xiaozhou.net/graceful:latest .
打包过后的镜像，才6MB左右:
?
1
2
3
λ Timothy [workspace/src/graceful] → docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
registry.xiaozhou.net/graceful latest b2210a85ca55 20 hours ago 6.484 MB
启动并运行容器:
?
1
λ Timothy [workspace/src/graceful] → docker run -d –name graceful b2210a85
查看容器运行状态:
?
1
2
3
λ Timothy [workspace/src/graceful] → docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
fd18eedafd16 b221 “/graceful” 3 seconds ago Up 2 seconds graceful
查看容器输出，能看到程序已经正常启动：
?
1
2
λ Timothy [workspace/src/graceful] → docker logs graceful
Started…
接着我们要使用docker stop大法，看程序能否响应SIGTERM信号:
?
1
2
λ Timothy [workspace/src/graceful] → docker stop graceful
graceful
最后，查看容器的日志，检验输出：
?
1
2
3
4
λ Timothy [workspace/src/graceful] → docker logs graceful
Started…
SIGTERM received!
Exiting…
总结
以上就是这篇文章的全部内容了，用docker kill命令，可以简单粗暴的终止docker容器中运行的程序，但是想要优雅的终止掉的话，我们需要使用docker stop命令，并且在程序中多花一些功夫来处理系统信号，这样能保证程序不被粗暴的终止掉，从而实现gracefully shutdown。