我们可能都使用过 docker stop 命令来停止正在运行的容器，有时可能会使用 docker kill 命令强行关闭容器或者把某个信号传递给容器中的进程。这些操作的本质都是通过从主机向容器发送信号实现主机与容器中程序的交互。比如我们可以向容器中的应用发送一个重新加载信号，容器中的应用程序在接到信号后执行相应的处理程序完成重新加载配置文件的任务。本文将介绍在 docker 容器中捕获信号的基本知识。

信号(linux)

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

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

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

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

容器中的信号

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 信号并优雅的退出了：

结论

容器中的 1 号进程是非常重要的，如果它不能正确的处理相关的信号，那么应用程序退出的方式几乎总是被强制杀死而不是优雅的退出。究竟谁是 1 号进程则主要由 EntryPoint, CMD, RUN 等指令的写法决定，所以这些指令的使用是很有讲究的。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

# docker  # 容器捕获信号  # 捕获信号  # docker容器如何优雅的终止详解  # Docker 容器操作退出后进入解决办法  # Docker常用的清除容器镜像命令小结  # Docker 解决容器时间与主机时间不一致的问题三种解决方案  # Docker为网络bridge模式指定容器ip的方法  # 如何在Docker容器内外互相拷贝数据  # Docker容器中文乱码(修改docker容器编码格式)的解决方案  # Docker 容器内存监控原理及应用  # 详解挂载运行的docker容器中如何挂载文件系统  # 两种方式创建docker镜像的启动容器时区别介绍(总结篇)  # 应用程序  # 都是  # 镜像  # 用在  # 我们可以  # 发送给  # 的是  # 是一个  # 加载  # 这一  # 是一种  # 在这个  # 出了  # 你可以  # 很有  # 感兴趣  # 能让  # 这不是  # 如果没有  # 会让 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： Laravel Pest测试框架怎么用_从PHPUnit转向Pest的Laravel测试教程  Laravel如何安装使用Debugbar工具栏_Laravel性能调试与SQL监控插件【步骤】  如何获取上海专业网站定制建站电话？  Laravel怎么使用artisan命令缓存配置和视图  利用 Google AI 进行 YouTube 视频 SEO 描述优化  如何在Tomcat中配置并部署网站项目？  ,怎么在广州志愿者网站注册？  php嵌入式断网后怎么恢复_php检测网络重连并恢复硬件控制【操作】  如何在 Go 中优雅地映射具有动态字段的 JSON 对象到结构体  Laravel Blade组件怎么用_Laravel可复用视图组件的创建与使用  Laravel如何设置定时任务（Cron Job）_Laravel调度器与任务计划配置  Laravel Artisan命令怎么自定义_创建自己的Laravel命令行工具完全指南  JavaScript如何操作视频_媒体API怎么控制播放  想要更高端的建设网站，这些原则一定要坚持！  JS实现鼠标移上去显示图片或微信二维码  Windows10如何更改计算机工作组_Win10系统属性修改Workgroup  Win11搜索不到蓝牙耳机怎么办 Win11蓝牙驱动更新修复【详解】  Python文本处理实践_日志清洗解析【指导】  阿里云高弹*务器配置方案｜支持分布式架构与多节点部署  如何在橙子建站上传落地页？操作指南详解  Laravel怎么实现观察者模式Observer_Laravel模型事件监听与解耦开发【指南】  Edge浏览器提示“由你的组织管理”怎么解决_去除浏览器托管提示【修复】  如何快速搭建个人网站并优化SEO？  如何在万网自助建站平台快速创建网站？  如何在宝塔面板中修改默认建站目录？  php485函数参数是什么意思_php485各参数详细说明【介绍】  Win11怎么更改系统语言为中文_Windows11安装语言包并设为显示语言  js实现获取鼠标当前的位置  清除minerd进程的简单方法  PHP的CURL方法curl_setopt()函数案例介绍(抓取网页,POST数据)  如何在阿里云香港服务器快速搭建网站？  Java遍历集合的三种方式  java ZXing生成二维码及条码实例分享  Laravel如何使用Scope本地作用域_Laravel模型常用查询逻辑封装技巧【手册】  利用python获取某年中每个月的第一天和最后一天  高配服务器限时抢购：企业级配置与回收服务一站式优惠方案  如何在Windows虚拟主机上快速搭建网站？  Laravel模型关联查询教程_Laravel Eloquent一对多关联写法  Laravel如何实现登录错误次数限制_Laravel自带LoginThrottles限流配置【方法】  详解阿里云nginx服务器多站点的配置  如何在 React 中条件性地遍历数组并渲染元素  网站制作大概要多少钱一个,做一个平台网站大概多少钱？  如何在云主机上快速搭建多站点网站？  今日头条微视频如何找选题 今日头条微视频找选题技巧【指南】  Laravel怎么配置S3云存储驱动_Laravel集成阿里云OSS或AWS S3存储桶【教程】  如何在IIS服务器上快速部署高效网站？  ChatGPT回答中断怎么办 引导AI继续输出完整内容的方法  html如何与html链接_实现多个HTML页面互相链接【互相】  JavaScript Ajax实现异步通信  宙斯浏览器文件分类查看教程 快速筛选视频文档与图片方法