docker容器中怎么捕获信号

本文小编为大家详细介绍“docker容器中怎么捕获信号”，内容详细，步骤清晰，细节处理妥当，希望这篇“docker容器中怎么捕获信号”文章能帮助大家解决疑惑，下面跟着小编的思路慢慢深入，一起来学习新知识吧。

信号(linux)

信号是一种进程间通信的形式。一个信号就是内核发送给进程的一个消息，告诉进程发生了某种事件。当一个信号被发送给一个进程后，进程会立即中断当前的执行流并开始执行信号的处理程序。如果没有为这个信号指定处理程序，就执行默认的处理程序。

进程需要为自己感兴趣的信号注册处理程序，比如为了能让程序优雅的退出(接到退出的请求后能够对资源进行清理)一般程序都会处理 sigterm 信号。与 sigterm 信号不同，sigkill 信号会粗暴的结束一个进程。因此我们的应用应该实现这样的目录：捕获并处理 sigterm 信号，从而优雅的退出程序。如果我们失败了，用户就只能通过 sigkill 信号这一终极手段了。除了 sigterm 和 sigkill ，还有像 sigusr1 这样的专门支持用户自定义行为的信号。下面的代码简单的说明在 nodejs 中如何为一个信号注册处理程序：

process.on('sigterm', function() {
 console.log('shutting down...');
});

关于信号的更多信息，笔者在《》一文中有所提及，这里不再赘述。

容器中的信号

docker 的 stop 和 kill 命令都是用来向容器发送信号的。注意，只有容器中的 1 号进程能够收到信号，这一点非常关键！
stop 命令会首先发送 sigterm 信号，并等待应用优雅的结束。如果发现应用没有结束(用户可以指定等待的时间)，就再发送一个 sigkill 信号强行结束程序。

kill 命令默认发送的是 sigkill 信号，当然你可以通过 -s 选项指定任何信号。

下面我们通过一个 nodejs 应用演示信号在容器中的工作过程。创建 app.js 文件，内容如下：

'use strict';

var http = require('http');

var server = http.createserver(function (req, res) {
 res.writehead(200, {'content-type': 'text/plain'});
 res.end('hello world\n');
}).listen(3000, '0.0.0.0');

console.log('server started');

var signals = {
 'sigint': 2,
 'sigterm': 15
};

function shutdown(signal, value) {
 server.close(function () {
  console.log('server stopped by ' + signal);
  process.exit(128 + value);
 });
}

object.keys(signals).foreach(function (signal) {
 process.on(signal, function () {
  shutdown(signal, signals[signal]);
 });
});

这个应用是一个 http 服务器，监听端口 3000，为 sigint 和 sigterm 信号注册了处理程序。接下来我们将介绍以不同的方式在容器中运行程序时信号的处理情况。

应用程序作为容器中的 1 号进程

创建 dockerfile 文件，把上面的应用打包到镜像中：

from iojs:onbuild
copy ./app.js ./app.js
copy ./package.json ./package.json
expose 3000
entrypoint ["node", "app"]

请注意 entrypoint 指令的写法，这种写法会让 node 在容器中以 1 号进程的身份运行。

接下来创建镜像：

$ docker build --no-cache -t signal-app -f dockerfile .

然后启动容器运行应用程序：

$ docker run -it --rm -p 3000:3000 --name="my-app" signal-app

此时 node 应用在容器中的进程号为 1：

现在我们让程序退出，执行命令：

$ docker container kill --signal="sigterm" my-app

此时应用会以我们期望的方式退出：

应用程序不是容器中的 1 号进程

创建一个启动应用程序的脚本文件 app1.sh，内容如下：

#!/usr/bin/env bash
node app

然后创建 dockerfile1 文件，内容如下：

from iojs:onbuild
copy ./app.js ./app.js
copy ./app1.sh ./app1.sh
copy ./package.json ./package.json
run chmod +x ./app1.sh
expose 3000
entrypoint ["./app1.sh"]

接下来创建镜像：

$ docker build --no-cache -t signal-app1 -f dockerfile1 .

然后启动容器运行应用程序：

$ docker run -it --rm -p 3000:3000 --name="my-app1" signal-app1

此时 node 应用在容器中的进程号不再是 1：

现在给 my-app1 发送 sigterm 信号试试，已经无法退出程序了！在这个场景中，应用程序由 bash 脚本启动，bash 作为容器中的 1 号进程收到了 sigterm  信号，但是它没有做出任何的响应动作。

我们可以通过：

$ docker container stop my-app1
# or
$ docker container kill --signal="sigkill" my-app1

退出应用，它们最终都是向容器中的 1 号进程发送了 sigkill 信号。很显然这不是我们期望的，我们希望程序能够收到 sigterm  信号优雅的退出。

在脚本中捕获信号

创建另外一个启动应用程序的脚本文件 app2.sh，内容如下：

#!/usr/bin/env bash
set -x

pid=0

# sigusr1-handler
my_handler() {
 echo "my_handler"
}

# sigterm-handler
term_handler() {
 if [ $pid -ne 0 ]; then
  kill -sigterm "$pid"
  wait "$pid"
 fi
 exit 143; # 128 + 15 -- sigterm
}
# setup handlers
# on callback, kill the last background process, which is `tail -f /dev/null` and execute the specified handler
trap 'kill ${!}; my_handler' sigusr1
trap 'kill ${!}; term_handler' sigterm

# run application
node app &
pid="$!"

# wait forever
while true
do
 tail -f /dev/null & wait ${!}
done

这个脚本文件在启动应用程序的同时可以捕获发送给它的 sigterm 和 sigusr1 信号，并为它们添加了处理程序。其中 sigterm 信号的处理程序就是向我们的 node 应用程序发送 sigterm 信号。

然后创建 dockerfile2 文件，内容如下：

from iojs:onbuild
copy ./app.js ./app.js
copy ./app2.sh ./app2.sh
copy ./package.json ./package.json
run chmod +x ./app2.sh
expose 3000
entrypoint ["./app2.sh"]

接下来创建镜像：

$ docker build --no-cache -t signal-app2 -f dockerfile2 .

然后启动容器运行应用程序：

$ docker run -it --rm -p 3000:3000 --name="my-app2" signal-app2

此时 node 应用在容器中的进程号也不是 1，但是它却可以接收到 sigterm 信号并优雅的退出了：

读到这里，这篇“docker容器中怎么捕获信号”文章已经介绍完毕，想要掌握这篇文章的知识点还需要大家自己动手实践使用过才能领会，如果想了解更多相关内容的文章，欢迎关注亿速云行业资讯频道。