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 操心的事儿，咱们不用管，除非你想自定义一种退出信号。