使用PM2以Cluster模式多进程部署Next.js（包括Docker下的部署）

一、介绍

Next.js 是一个强大的 React 框架，用于构建静态和服务器渲染的 React 应用程序。PM2 是一个带有内置负载均衡器的 Node.js 进程管理工具，它允许我们在多核服务器上运行多个 Node.js 实例。结合 Docker，可以实现高效的容器化应用管理。

二、准备工作

在开始之前，确保已经安装了以下工具：

• Node.js 和 npm
• PM2
• Docker

三、安装和配置Next.js

3.1 创建Next.js项目

首先，创建一个新的 Next.js 项目：

npx create-next-app@latest my-next-app
cd my-next-app
​

 

 

3.2 安装PM2

在项目中安装 PM2：

npm install pm2 --save
​

 

 

3.3 配置Next.js启动脚本

在 package.json 文件中添加一个启动脚本：

"scripts": {
  "dev": "next dev",
  "build": "next build",
  "start": "next start -p 3000"
}
​

 

 

四、使用PM2的Cluster模式

4.1 创建PM2配置文件

在项目根目录中创建一个 ecosystem.config.js 文件：

module.exports = {
  apps: [
    {
      name: 'my-next-app',
      script: 'npm',
      args: 'start',
      instances: 'max',  // 使用机器的所有CPU内核
      exec_mode: 'cluster',  // Cluster模式
      env: {
        NODE_ENV: 'production'
      }
    }
  ]
};
​

 

 

4.2 启动PM2

使用以下命令启动 PM2：

pm2 start ecosystem.config.js
​

 

 

4.3 管理PM2进程

查看PM2进程状态：

pm2 status
​

 

 

查看日志：

pm2 logs my-next-app
​

 

 

重启应用：

pm2 restart my-next-app
​

 

 

停止应用：

pm2 stop my-next-app
​

 

 

五、在Docker中部署Next.js和PM2

5.1 创建Dockerfile

在项目根目录中创建一个 Dockerfile 文件：

# 使用Node.js官方镜像作为基础镜像
FROM node:14

# 创建工作目录
WORKDIR /usr/src/app

# 复制package.json和package-lock.json文件
COPY package*.json ./

# 安装依赖
RUN npm install

# 复制项目文件
COPY . .

# 构建Next.js应用
RUN npm run build

# 安装PM2
RUN npm install pm2 -g

# 启动PM2和Next.js应用
CMD ["pm2-runtime", "start", "ecosystem.config.js"]
​

 

 

5.2 创建.dockerignore文件

在项目根目录中创建一个 .dockerignore 文件，以防止将不必要的文件复制到Docker镜像中：

node_modules
npm-debug.log
​

 

 

5.3 构建Docker镜像

使用以下命令构建Docker镜像：

docker build -t my-next-app .
​

 

 

5.4 运行Docker容器

使用以下命令运行Docker容器：

docker run -p 3000:3000 my-next-app
​

 

 

六、总结

通过上述步骤，我们实现了在Docker环境下使用PM2以Cluster模式多进程部署Next.js应用。这样不仅提高了应用的性能和可用性，还简化了部署和管理过程。

思维导图

- 使用PM2以Cluster模式多进程部署Next.js
  - 安装和配置Next.js
    - 创建Next.js项目
    - 安装PM2
    - 配置Next.js启动脚本
  - 使用PM2的Cluster模式
    - 创建PM2配置文件
    - 启动PM2
    - 管理PM2进程
  - 在Docker中部署Next.js和PM2
    - 创建Dockerfile
    - 创建.dockerignore文件
    - 构建Docker镜像
    - 运行Docker容器
  - 总结
​

 

 

通过这些步骤，可以确保您的Next.js应用在多核服务器上高效运行，并且在Docker环境中实现高效的容器化管理。