首页 > 编程语言 >Ubuntu下Node.js持续集成指南

Ubuntu下Node.js持续集成指南

来源：互联网 2026-07-06 08:02:06

Ubuntu环境下，通过GitHubActions或Jenkins为Node.js项目搭建持续集成流水线。配置依赖安装、多版本测试及自动部署，使用npmci确保一致性，敏感信息存入密钥管理，实现代码提交后自动验证与部署。

Ubuntu环境下Node.js持续集成（CI）实现指南

持续集成（CI）这件事，说简单也简单，说复杂——无非是让代码从提交到验证的过程自动化起来。对于Node.js项目来说，CI几乎成了标配：每次push都自动跑一遍测试、检查依赖、甚至直接部署，能省下大量人工排查的时间。Ubuntu作为Linux世界的常青树，环境配置灵活，配合GitHub Actions、Jenkins这些工具，能搭出一套非常顺手的CI流水线。下面聊聊具体怎么落地。

长期稳定更新的攒劲资源： >>>点此立即查看<<<

一、前置准备

动工之前，得先把基础环境收拾利索：

Ubuntu系统环境：确保系统里装了Node.js、npm和Git。以Node.js 16.x为例，几行命令就能搞定：

# 安装Node.js（以16.x版本为例）
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt install -y nodejs
# 验证安装
node -v  # 输出版本号（如v16.20.2）
npm -v   # 输出版本号（如9.6.7）
# 安装Git
sudo apt install -y git

代码托管库：把Node.js项目推送到GitHub、Gitee这类平台，项目根目录下要有package.json——依赖和脚本都靠它定义。
服务器准备（如果需要部署）：假如CI跑完还要把产物部署到远程Ubuntu服务器，得提前配好SSH访问权限。生成一对SSH密钥，把公钥扔到服务器的~/.ssh/authorized_keys里就行。

二、常用CI工具及配置步骤

1. GitHub Actions（推荐：轻量、集成度高）

GitHub自己带的CI/CD工具，不用额外搭服务器，中小型项目首选。配置起来也简单：

创建工作流文件：在项目根目录下建个.github/workflows文件夹，里面放一个ci.yml（或者deploy.yml），定义整个CI流程。
基础CI（构建+测试）：下面的配置会在你向main或dev分支push代码、或者发起pull request时自动触发——检出代码、装依赖、跑测试，一气呵成：

name: Node.js CI Pipeline
on:
  push:
    branches: ["main", "dev"]       # 触发分支
  pull_request:
    branches: ["main", "dev"]       # PR触发分支
jobs:
  build-and-test:
    runs-on: ubuntu-latest          # 运行环境（Ubuntu最新版）
    strategy:
      matrix:
        node-version: ["16.x", "18.x"]  # 多版本Node.js兼容测试
    steps:
      - name: Checkout code
        uses: actions/checkout@v3
      - name: Set up Node.js
        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.node-version }}
      - name: Install dependencies
        run: npm ci                # 用npm ci确保依赖一致性
      - name: Run tests
        run: npm test              # 项目里得有测试脚本

进阶：部署到服务器：如果需要把构建产物（比如dist目录）部署到远程Ubuntu服务器，可以在工作流里加一个SSH部署步骤。注意敏感信息（服务器IP、SSH私钥）要存在GitHub Secrets里：

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
       # 前置步骤（与build-and-test一致，略）
       # ...
      - name: SSH Deploy
        uses: appleboy/ssh-action@v0.1.10
        with:
          host: ${{ secrets.SERVER_IP }}
          username: root
          key: ${{ secrets.SSH_PRIVATE_KEY }}
          script: |
            cd ${{ secrets.DEPLOY_PATH }}
            git pull origin main
            npm install --production
            pm2 reload ecosystem.config.js --env production
            pm2 sa ve

配置完成后，每次推送代码到指定分支，GitHub Actions就会自动拉起CI流程。

2. Jenkins（适合企业级复杂流程）

Jenkins是老牌开源CI/CD工具，流水线配置灵活，大型项目或团队协作经常用。配置步骤稍多：

安装Jenkins：在Ubuntu服务器上执行：

# 安装JDK（Jenkins依赖Ja va）
sudo apt install -y openjdk-11-jdk
# 添加Jenkins仓库并安装
wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
sudo apt update
sudo apt install -y jenkins
# 启动Jenkins
sudo systemctl start jenkins
sudo systemctl enable jenkins
# 访问管理界面（http://服务器IP:8080），完成初始化设置

配置Jenkins环境：
- 安装必要插件：进入“Manage Jenkins”→“Manage Plugins”，把Git、NodeJS、Pipeline装上。
- 配置全局工具：进入“Manage Jenkins”→“Global Tool Configuration”，添加Node.js安装路径（可以自动安装，或指定服务器上已有的路径）。
创建Jenkins任务：
- 新建“Freestyle project”或“Pipeline”任务，源码管理选Git，填上仓库URL和凭证。
- 配置构建触发器——可以用“Poll SCM”定期检查代码变更，或者用Webhook实时触发。
- 添加构建步骤：比如执行Shell脚本：

cd /var/lib/jenkins/workspace/[任务名称]/项目目录
npm install
npm test
npm run build

如果需要部署到服务器，可以再加一个“Execute Shell”步骤，或者用“Publish over SSH”插件（需要先配好SSH凭证）。

三、关键注意事项

依赖管理：用npm ci而不是npm install——前者会严格按照package-lock.json来装依赖，杜绝“本地能跑，CI上崩了”的玄学问题。
环境一致性：利用CI工具的矩阵策略（GitHub Actions的matrix、Jenkins的Node.js插件）跑多个Node.js版本，提前发现兼容性问题。
安全性：敏感信息（SSH私钥、服务器IP、API密钥）不要硬编码在配置文件里。GitHub Actions用secrets，Jenkins用凭证管理，都是正经做法。
监控与反馈：配置构建结果通知——邮件、Slack都行，出了问题团队能第一时间知道。部署后用PM2这类进程管理工具盯着应用状态，确保上线后不出幺蛾子。