Linux Node.js如何实现自动化部署流程

Linux Node.js 自动化部署流程

一 架构与流程概览

• 代码托管与触发：将项目托管在 Git（GitHub/GitLab），通过 push/PR 触发 CI/CD 流水线（如 GitHub Actions/GitLab CI），完成安装依赖、构建、测试与发布。
• 构建与产物：执行 npm/yarn install、npm run build，将产物与应用代码同步到目标机器（或制品库）。
• 目标机运行环境：在 Linux 上用 NVM 管理 Node.js LTS，使用 PM2 守护进程，配合 Nginx 反向代理与 HTTPS。
• 发布策略：优先采用 零停机 发布（如 PM2 reload 或 Nginx 蓝绿切换），并接入日志轮转与监控告警。

二 服务器前置与安全加固

• 系统与权限：选择 Ubuntu 22.04/CentOS 8 等稳定发行版；创建 非 root 用户并授予 sudo；禁用 root SSH 登录，使用 SSH 密钥 认证；按需配置 安全组/防火墙 仅开放 22/80/443 等必要端口。
• Node 与进程管理：用 NVM 安装 Node.js LTS 与 PM2；PM2 启动应用、设置开机自启、支持 集群模式 与 日志管理。
• 反向代理与证书：以 Nginx 暴露 80/443，反向代理到应用端口（如 3000）；通过 Let’s Encrypt/certbot 配置 HTTPS 并设置自动续期。

三 三种落地方案

• 方案一 GitHub Actions 到服务器直连发布（轻量、通用）

  • 思路：在仓库 Settings → Secrets 配置 SSH_HOST/SSH_USERNAME/SSH_KEY；Actions 检出代码、安装依赖、构建后通过 SSH 在服务器执行拉取、安装生产依赖与 PM2 reload。
  • 示例要点：
    • 运行器：ubuntu-latest；步骤含 actions/checkout@v4、actions/setup-node@v4（指定 Node 18/20 LTS）、安装依赖与构建。
    • 部署步骤使用 appleboy/ssh-action 执行远程脚本：
      • 脚本示例：
        • cd /path/to/project
        • git pull
        • yarn install --production
        • pm2 reload all
    • 适用：单台/少量服务器、快速交付；如需审批/多环境可扩展为 workflow_dispatch 或接入 Argo CD。

• 方案二 服务器 Webhook 自动拉取（自托管、事件驱动）

  • 思路：在服务器以 Node.js 启动 HTTP 服务，使用 github-webhook-handler 校验 secret；收到 push 事件后执行部署脚本（git pull、安装依赖、重启）。
  • 关键配置：
    • GitHub Webhook：Payload URL（如 http://your-domain/autodeploy）、Content type application/json、设置 Secret。
    • 服务器监听端口（如 7777），可用 Nginx 反向代理与鉴权；部署脚本中执行 git reset --hard origin/main && git pull && npm install && pm2 restart app。
    • 适用：不依赖第三方 CI、对内网/私有仓库友好。

• 方案三 本地 Node.js 脚本一键打包上传（零依赖 CI）

  • 思路：本地用 Node.js 脚本（如 ssh2 + archiver）打包前端/静态产物，上传至服务器临时目录并解压替换，最后执行远程重启命令。
  • 关键依赖与流程：
    • 依赖：ssh2、archiver、dotenv、ora；.env 管理 SERVER_HOST/PORT/USER、本地 dist 目录与目标部署目录。
    • 流程：本地 npm run build → 压缩为 zip → SSH 上传 → 远程解压到部署目录 → 执行 pm2 reload 或等效命令。
    • 适用：前端或静态站点、希望“本地一键发布”的团队。

四 零停机发布与回滚策略

• PM2 零停机：使用 集群模式 启动（如 pm2 start app.js -i max），发布时执行 pm2 reload all，实现连接无损切换与滚动更新。
• Nginx 蓝绿：在 upstream 中同时配置 旧版本:3000 与 新版本:3001，通过 split_clients 按 客户端标识/权重 将流量切至新版本；验证无误后全量切换，异常可快速回切到旧版本。
• 回滚预案：保留上一版本产物与 PM2 应用清单；异常时执行 git checkout <旧提交> && pm2 reload all 或切回 Nginx 上游指向。

五 生产级加固与运维要点

• 进程与日志：用 PM2 管理进程，开启 日志轮转（如 pm2-logrotate 设置 max_size/retain），关键业务接入 结构化日志（如 winston）便于检索与告警。
• 监控告警：接入 PM2 Keymetrics 或自建 Prometheus + Grafana，监控 CPU/内存/请求错误率 并设置阈值告警。
• 安全合规：强制 密钥登录、限制 sudo 权限、最小端口开放；定期 系统与安全补丁 更新；证书 自动续期 校验。
• 备份与恢复：对代码与关键数据做 定时/增量备份（如 rsync），保留 多份历史 并定期演练恢复流程。