really/node-pm2-git

really/node-pm2-git

Docker容器，用于从公共/私有Git仓库拉取代码（需密钥时可提供），通过PM2实现Node项目的自动更新与进程管理，支持Keymetrics监控。

镜像概述

此镜像简化Node.js项目的容器化流程：支持Git仓库代码拉取（含私有仓密钥认证）、PM2进程调度（集群模式、自动更新）、额外系统依赖安装，同时可集成Keymetrics监控平台。

核心功能

1. Git代码拉取：兼容公共/私有仓库，通过REPO_KEY实现私有仓密钥认证；
2. PM2进程管理：支持集群模式、自动更新、自定义启动脚本；
3. 依赖扩展：通过PACKAGES安装系统依赖（如make、gcc等）；
4. Keymetrics集成：配置公钥/密钥即可接入监控平台。

使用场景

• Node.js项目的容器化部署；
• 需要自动拉取Git最新代码并更新的场景；
• 利用PM2实现进程集群管理的场景；
• 需Keymetrics监控Node项目运行状态的场景。

配置说明

环境变量

部署示例

Docker Run命令

bash
docker run -d -p 8080:8080 \  
  --env NPM_TOKEN=your-npm-token \  
  --env PACKAGES="make gcc g++ python" \  
  --env REPO_KEY="$(cat ~/.ssh/your-repo-key)" \  
  --env REPO="git@github.com:your-username/your-node-project.git" \  
  --env GIT_BRANCH="production" \  
  --env KEYMETRICS_PUBLIC=your-keymetrics-public \  
  --env KEYMETRICS_SECRET=your-keymetrics-secret \  
  --env PORT=8080 \  
  really/node-pm2-git ./pm2.json  

PM2配置示例（pm2.json）

json
{  
  "apps": [{  
    "name": "node-project",  
    "script": "./bin/www",  
    "instances": 0,  // 0表示根据CPU核心数自动分配  
    "exec_mode": "cluster",  
    "post_update": ["npm install", "echo 启动完成"],  
    "env": {  
      "NODE_ENV": "production"  
    }  
  }]  
}  

若无需PM2集群配置，可将启动命令中的./pm2.json替换为./bin/www（适用于典型ExpressJS项目）。