打包指令_NodeJSDocker打包优化

最近 NodeJS 后端工程的 Docker 打包优化工作总算告一段落了。其实去年 12 月份就开始试点改造&＃xff0c;期间遇到了很难复现的间歇性 socket hang up 问题&＃xff0c;不得不延后。上周终于抽出时间全力排查了下&＃xff0c;发现是升级 NodeJS 到 6.15.0 后&＃xff0c;其有一个 HTTP Keep-alive 连接超时的 Bug。不得不感慨&＃xff1a;这小版本升级也要格外小心啊。

回到正题。在确认没有其他附带问题后&＃xff0c;在试点的基础上&＃xff0c;又增加了一些新的目标。总的目标大概如下&＃xff1a;

• 支持优雅停机&＃xff0c;要求 Node 进程能够接收到 SIGTERM 软终止信号
• 提升打包速度&＃xff0c;充分利用 Docker Layer 缓存机制&＃xff0c;降低 yarn install、node_modules 拷贝等高 IO 动作的运行频率
• 保证源代码安全&＃xff0c;不要将源代码打包到镜像里
• 尽可能降低最终镜像大小&＃xff0c;不要包含不必要的文件(如 node_modules 中的 devDependencies)

下面从各个目标一一介绍下我们的优化实践之路。

基础镜像设置

由于之前的基础镜像使用的是 FROM node:6&＃xff0c;只有 major version&＃xff0c;没有指定 minor version、patch version。当该基础镜像 minor 或 patch 版本更新后&＃xff0c;如果本地的镜像缓存也被清除了&＃xff0c;那么打包就会使用新版本的基础镜像。这也是上面不经意升级到 node 6.15.0 的原因。所以这里我们限定了基础镜像的全版本&＃xff1a;FROM node:6.16.0。

我们的产品主要在国内使用&＃xff0c;运维人员也都是在国内。为了更方便查看日志中的时间、方便程序中的日期计算&＃xff0c;把时区调整为北京时区(即东八区)&＃xff1a;RUN rm /etc/localtime && echo "Asia/Shanghai" > /etc/timezone && dpkg-reconfigure -f noninteractive tzdata。注意&＃xff0c;Debian Stretch 版本后需要 rm /etc/localtime&＃xff0c;否则时区修改可能无法生效(被替换回原值)。

最后设置镜像的工作目录&＃xff1a;WORKDIR /app。这样&＃xff0c;我们新的基础镜像就完成了。

支持优雅停机

优雅停机(Gracefully Shutdown)&＃xff0c;就是当应用(进程)要被关闭时&＃xff0c;首先会被发送一个软终止信号。应用在收到这个信号后&＃xff0c;执行清理工作&＃xff0c;然后自行退出。如果在指定的时间内没有自行退出&＃xff0c;则会被强制关闭——这自然就不优雅了。这个软终止信号一般就是指 SIGTERM。NodeJS 进程默认会对 SIGTERM 信号进行响应&＃xff0c;执行进程退出。但是默认的监听程序并不会执行清理工作。我们需要显式监听该信号&＃xff0c;并在清理完毕后执行 process.exit(0) 以退出进程。

然而&＃xff0c;在 Docker 容器里实现优雅停机会有一些新的问题需要面对。当使用 docker stop 停止一个容器时&＃xff0c;docker 会首先发送一个 SIGTERM 信号给容器内的 PID&＃61;1 进程&＃xff0c;也就是常说的 init 进程。如果 PID&＃61;1 进程没有在规定时间(一般 10 秒)内退出&＃xff0c;则 docker 会发送 SIGKILL 信号强制退出容器内的所有进程。PID&＃61;1 进程比较特殊&＃xff0c;在 linux 下&＃xff0c;它会忽略所有默认的信号监听程序&＃xff0c;也就是说收到 SIGTERM 默认不会退出。所以&＃xff0c;我们的 PID&＃61;1 进程要求能显式监听 SIGTERM 并执行后续动作。

然而&＃xff0c;当我们使用 shell form 的 ENTRYPOINT 或 CMD 指令时——如 CMD npm run start&＃xff0c;Docker 容器会默认启用一个 Shell 来运行后面的指令。此时 PID&＃61;1 进程是 /bin/sh&＃xff0c;完整的运行命令是 /bin/sh -c &＃39;npm run start&＃39;。当 sh 收到 SIGTERM 信号时&＃xff0c;它自身并不会退出。因为 sh 并没有显式监听 SIGTERM&＃xff0c;默认的信号处理器被忽略了。自然 sh 内部也不会把信号转发给子进程。最后只会超时&＃xff0c;继而被 SIGKILL 强制关闭。

Docker 推荐我们用 exec form 的 ENTRYPOINT 或 CMD 指令&＃xff0c;如 CMD ["npm