在 Debian 上实现 Node.js 应用的自动化部署

将 Node.js 应用部署到 Debian 服务器，手动操作不仅繁琐，还容易出错。有没有一套清晰、可靠的自动化流程呢？答案是肯定的。借助 Git、PM2 和一个简单的 Shell 脚本，就能搭建一套高效的自动化部署管道，让代码推送与服务器更新无缝衔接。

前提条件

在开始之前，确保你的 Debian 系统已经准备好以下工具。这些是构建自动化部署管道的基石。

1. Node.js 和 npm/yarn：应用运行的基础环境。

   sudo apt update
   sudo apt install nodejs npm

2. Git：代码版本控制的核心工具。

   sudo apt install git

3. PM2：用于进程管理和应用监控，保证服务稳定运行。

   sudo npm install pm2 -g

步骤指南

1. 设置代码仓库

首先，在服务器上为你的应用创建一个专属目录，并初始化 Git 仓库。这相当于在服务器上建立了一个代码的“接收站”。

mkdir my-node-app
cd my-node-app
git init

2. 配置远程仓库

接下来，将你的远程代码仓库（比如 GitHub 或 GitLab）地址添加到服务器本地仓库。这样，服务器就知道该从哪里拉取代码了。

git remote add origin <你的远程仓库地址>

3. 创建部署脚本

自动化部署的核心，就是一个能执行一系列命令的 Shell 脚本。假设你的应用入口文件是 app.js，可以创建一个名为 deploy.sh 的脚本。

#!/bin/bash

# 进入应用目录
cd /path/to/my-node-app

# 拉取最新代码
git pull origin master

# 安装依赖
npm install

# 重启 PM2 应用
pm2 restart my-node-app

脚本创建好后，别忘了赋予它执行权限。

chmod +x deploy.sh

4. 配置 PM2

为了让 PM2 更好地管理你的应用，建议在应用目录下创建一个配置文件 ecosystem.config.js。这里可以定义应用名称、启动脚本、实例数量等关键参数。

module.exports = {
  apps: [{
    name: 'my-node-app',
    script: 'app.js',
    instances: 'max',
    autorestart: true,
    watch: false,
    max_memory_restart: '1G',
    env: {
      NODE_ENV: 'production'
    },
    env_production: {
      NODE_ENV: 'production'
    }
  }]
};

5. 设置 Webhook

如何让代码推送自动触发部署脚本？这就需要 Webhook 了。在你的 Git 仓库设置中，添加一个 Webhook，指向服务器上一个能接收请求的 URL。对于本地或内网服务器，可以使用 ngrok 这类工具临时暴露一个公网地址。

ngrok http 3000

将 ngrok 生成的 URL 配置到 Git 仓库的 Webhook 设置中即可。

6. 自动化部署

最后一步，在服务器上创建一个简单的 HTTP 服务（比如用 Express）来接收 Webhook 请求，并执行我们写好的部署脚本。

首先，确保安装了 Express。

sudo apt install express-generator
cd /path/to/my-node-app
npm install express

然后，创建一个 deploy.js 文件作为请求处理器：

const express = require('express');
const { exec } = require('child_process');
const app = express();
const port = 3000;

app.post('/deploy', (req, res) => {
  exec('./deploy.sh', (error, stdout, stderr) => {
    if (error) {
      console.error(`Error: ${error.message}`);
      return res.status(500).send('Deployment failed');
    }
    console.log(stdout);
    res.send('Deployment successful');
  });
});

app.listen(port, () => {
  console.log(`Server running at https://localhost:${port}`);
});

启动这个服务：

node deploy.js

至此，整个链条就打通了。当你向远程仓库推送代码时，Git 平台的 Webhook 会向 https://your-ngrok-url/deploy 发送一个 POST 请求，触发服务器上的部署脚本自动执行，完成从拉取代码到重启应用的全过程。

总结

通过以上六个步骤——从环境准备、仓库设置，到编写部署脚本、配置 PM2，再到设置 Webhook 和搭建触发服务——一套在 Debian 上为 Node.js 应用量身定制的自动化部署流程就搭建完成了。这个流程结构清晰，每个环节各司其职，你可以根据项目的具体需求，对这个基础框架进行灵活的扩展和优化，从而显著提升部署效率和系统可靠性。