V2EX 10月31日 10:46
DocFlow 部署问题排查与 Docker 部署优势
index_new5.html
../../../zaker_core/zaker_tpl_static/wap/tpl_guoji1.html

 

本文记录了在使用 Next.js 开发 DocFlow 项目时遇到的部署问题。项目在部署后出现 CPU 爆满、网站 502 的情况,通过 `htop` 命令发现是 `next-server` 和 `node` 进程占用大量 CPU 资源。进一步排查发现是 PM2 进程频繁重启导致内存占用过高。作者回顾了近期提交,推测是某个配置更改引发了此问题。文章随后对比了 PM2 和 Docker 两种部署方案的优劣,强调了 Docker 在依赖管理、环境一致性、服务中断、CI/CD 集成和快速回滚等方面的优势,并最终决定采用 Docker 进行部署,以解决 PM2 带来的资源抢占和潜在的服务中断问题。

🚀 **部署困境与初步诊断:** 在 Next.js 项目 DocFlow 的部署过程中,遇到了 CPU 资源耗尽导致网站无法访问和 SSH 连接失败的严重问题。通过 `htop` 工具,初步定位到 `next-server` 和运行 `main.js` 的 `node` 进程是资源占用的主要元凶,表明应用进程存在异常。

💡 **PM2 重启引发的资源危机:** 深入分析后发现,问题根源在于 PM2 进程管理工具频繁重启应用,导致内存被迅速占满,进而引发 CPU 飙升和服务器崩溃。作者通过查看近期提交记录,推测是某个配置变更触发了 PM2 的异常重启行为,但具体原因难以直接追溯。

🐳 **Docker 部署的显著优势:** 文章详细对比了 PM2 和 Docker 的部署方式。Docker 通过容器化技术,解决了 PM2 在依赖管理、环境一致性、服务中断、CI/CD 集成和快速回滚等方面的局限性。Docker 确保了部署的标准化和环境的独立性,即使代码出现问题,也不会影响正在运行的容器,保障了生产环境的稳定性和高可用性。

✅ **最终解决方案与实践:** 鉴于 PM2 部署方案带来的潜在风险,作者最终选择了 Docker 进行部署。Docker 部署不仅解决了 PM2 导致的多进程资源抢占问题,还提供了更可靠、更自动化、更易于管理和回滚的部署流程,尤其适合需要高可用性的生产环境。

最近在使用 NextJs 开发 DocFlow 协同编辑这个项目,运行了很久都没有问题,最近终于在部署方面出现了问题了,早上的时候发现 ssh 连不上了,一开始并没有太在意,但后来打开京东云控制台,好家伙真的好家伙:

真的小母牛坐飞机牛逼上天了!原来是 CPU 爆了,怪不得连接不上了,当然网站也 502 了:

那是什么原因呢,接下来就要开始慢慢排查了,既然 vscode 连不上,那我们就在官方提供的 ssh 来连接:

输入命令 htop ,罪魁祸首马上出现:

原来是 next-server 和 node (运行在 /home/DocFlow-Server/dist/main.js )占用了基本全部的 CPU ,那这个原因就很清楚了,那么接下来就可以排查了这个问题的原因了。

首先,可以明确的一点是,之前一直都是同样的方式部署的,没有出现问题,但是为什么今天就一直出现这个问题呢,那肯定是在运行的进程出现了问题。

我项目使用的是 pm2 部署的,那打个日志看看咯:

问题找到了,原来是 pm2 一直在重启,把内存全部占用了,具体是什么原因的已经不好查了,有可能是安装了一些依赖。我这个部署脚本是基本没问题的,至少能跑,现在查看这两天的 commit ,想起来有一个这样的操作:

那基本就可以确定是这个问题了。

其他部署方案

PM2 是一种流行的进程管理工具,适用于 Node.js 应用,尤其在小型项目和单机部署时很有效。然而,PM2 的部署流程存在一些局限性:

    依赖管理和版本控制:PM2 需要手动确保服务器上安装正确的 Node.js 和 pnpm 版本。每次代码更新后,你还需要在服务器上重新 构建项目(执行 pnpm run build),这可能会导致生产环境与开发环境之间的不一致,并增加了维护工作。

    服务中断问题:每次代码更新时,PM2 需要 重启应用 来使新版本生效。如果没有正确配置或管理,应用在重启过程中可能会停机一段时间,这对于高可用性要求较高的生产环境来说是个问题。

与 PM2 相比,Docker 自动化部署 通过容器化解决了这些问题,提供了更简洁、更一致的部署流程,特别适用于云端和多环境部署。主要优势包括:

    无需依赖管理和环境配置:Docker 将应用及其所有依赖、环境变量、构建过程封装在 Docker 镜像 中。这样,服务器上无需安装特定版本的 Node.js 或 pnpm ,避免了手动配置和版本不一致的问题。你只需要在 构建镜像时 配置好所有的依赖和环境,部署时无需再进行任何安装或构建操作。

    代码问题不会影响运行:如果代码有问题,Docker 使得应用 不会受到当前部署的影响。因为 Docker 镜像已经包含了所有必要的依赖,部署失败时,原先的镜像仍然可以继续运行,确保生产环境不受影响。而在 PM2 部署 时,更新代码后需要重启应用,如果代码有问题,应用会直接停机,导致服务中断。

    无缝的 CI/CD 集成:Docker 完美集成 CI/CD 流程。例如,使用 GitHub Actions ,你可以自动构建 Docker 镜像并推送到仓库。服务器只需要 拉取最新镜像,并启动新的容器。如果部署失败,不会影响当前运行的容器,你可以迅速恢复服务,且无需手动修复。相反,PM2 需要重新启动应用,且服务停机时需要手动修复代码。

    快速回滚:由于 Docker 镜像的版本化机制,你可以轻松回滚到之前的稳定版本。即便遇到部署失败的情况,只需要拉取旧版本的镜像,应用立即恢复,不需要手动操作,这为应用提供了更高的可靠性。

总结

PM2 部署中,如果代码有问题,必须手动修复并重启应用,这可能会导致 服务中断,并影响用户体验。而且每次更新都需要在服务器上重新构建项目,这可能导致环境不一致,增加了部署的复杂性。

Docker 部署则通过 容器化 确保应用和环境的一致性,部署失败时不会影响生产环境的运行,原有容器仍可继续工作,且通过 CI/CD 流程可以自动恢复和快速回滚,不需要人工干预。即使代码存在问题,原有的容器仍可保持正常服务,确保应用的高可用性。

因此,对于生产环境,Docker 提供了比 PM2 更稳定、高效、自动化的部署方式,尤其适合大规模、高可用的应用部署。

最后看到的问题是启动 PM2 一次性给我开了 3 个进程,资源相互抢占,导致服务器崩溃的,最后直接换成了 Docker 部署了

Fish AI Reader

Fish AI Reader

AI辅助创作,多种专业模板,深度分析,高质量内容生成。从观点提取到深度思考,FishAI为您提供全方位的创作支持。新版本引入自定义参数,让您的创作更加个性化和精准。

FishAI

FishAI

鱼阅,AI 时代的下一个智能信息助手,助你摆脱信息焦虑

联系邮箱 441953276@qq.com

相关标签

DocFlow Next.js 部署 PM2 Docker CPU爆满 网站502 排查 CI/CD 高可用性 Deployment Troubleshooting High Availability
相关文章