2021-01-07 11:49:52

docker exited(code) docker 的异常退出码含义解释分析


docker exited(code) docker 的异常退出码含义解释分析

我写这篇博文的起源是在开发者交流群中有人问 docker 的 Exited (143) 状态是什么意思,我们就产生了如下的交流讨论,如果你也想加入开发交流群组请访问https://www.renfei.net/about/#shequn扫描对应的二维码加入,我也专门去研究了一下这个状态码的来源和它的含义解释。

首先 Exited 状态就是 docker 已经退出结束的状态,这个大家都没有什么意见,争论的点主要在后面的代码部分,有 125、126、127、128、130、137、143 等,这些是什么意思呢,我就去研究了一下这些数字的来历。

Exited(code) 诞生

说到 Exited(code) 诞生,可以一直追溯到2014年6月28日,rhatdan 提出了一个 issues 建议:docker run exit code consisency #6734,他觉得 docker 退出无法区别原因,所以建议给出一个退出代码,并建议遵循chroot标准,bgrant0607 觉得应该与 shell 的退出代码保持一致,指出Bash脚本指南中Appendix E. Exit Codes With Special Meanings

终于在2015年6月18日,sallyom 提交了一个PR:Change 'docker run' exit codes to distinguish docker/contained errors #14012,又经过了一番讨论,在2015年11月5日被管理员 thaJeztah 合并到了master分支,docker 1.10 就包含了这些修改代码。

官方文档中退出状态 Exit Status

在官方文档中也描述了退出状态,参见:https://docs.docker.com/engine/reference/run/#exit-status,一共四种:

  • 125:是由Docker守护程序本身造成的,一般是因为 docker run 命令本身报错了

  • 126:无法调用所包含的命令,例如权限不足,无法访问目录或者执行命令

  • 127:找不到所包含的命令,例如环境中没有安装 curl 命令,但你调用了 curl 命令,那就找不到咯

  • 其他:内部程序抛出的信号

Bash脚本指南中的代码

上面我们提到,有人建议跟 shell 保持一致,那还参考了Bash脚本指南,参见:https://tldp.org/LDP/abs/html/exitcodes.html,这里只说除了 docker 官方文档中那三个还有一个特殊的「128+N」,因为126到128已经被占用,那剩下的只能是128往上,所以是128+N,这个N就是 Linux Signal 信号,说到  Linux Signal 信号我在另一篇文章《在 Linux 中 kill、kill -9、kill -3命令是什么意思有什么区别》中提到过,可以去看看,比如信号是15,那么128+15=143,这时候 docker 的 退出代码就是 Exited(143),很好理解吧。

还有一点在手册里已经说明了,编号不能大于255,如果大于255就会被取模,就是求余数,比如3809大于255就会被:3809 % 256 = 225,变成了225,导致了错误的代码,不过这个应该是 docker 操心的事儿,咱们不用管,除非你想自定义一种退出信号。


商业用途请联系作者获得授权。
版权声明:本文为博主「任霏」原创文章,遵循 CC BY-NC-SA 4.0 版权协议,转载请附上原文出处链接及本声明。
原文链接:https://www.renfei.net/posts/1003433
评论与留言
以下内容均由网友提交发布,版权与真实性无法查证,请自行辨别。

本站有缓存策略,时间约2小时后能看到您的评论。本站使用自动审核机制,如果您的内容包含广告/谩骂/恐怖/暴力/涉政等不和谐内容将无法展示!


本站有缓存策略,时间约2小时后能看到您的评论。本站使用自动审核机制,如果您的内容包含广告/谩骂/恐怖/暴力/涉政等不和谐内容将无法展示!