Jpom-简而轻的项目监控软件

简而轻的低侵入式在线构建、自动部署、日常运维、项目监控软件

您为什么需要 Jpom

项目部署运维时，通用的方法是登录服务器，上传新的项目包，备份现有版本，执行相应命令。如果管理多个项目则重复操作上述步骤。不同项目亦存在不同的命令处理方式。项目的运行状态无法掌握等.

在中小团队中或者没有专业运维的公司（开发兼运维工作），暂时不便引入复杂的 CI/CD 工具时使用 Jpom 轻量化、无侵入的过度

使用Jpom前

1. 登录服务器（专业软件：RDP、SSH等）
2. 不同项目有不同的管理命令（不易记、易混淆）
3. 查看项目运行状态需要再次使用命令
4. 服务器密码分发混乱（安全性低）
5. 集群项目需要挨个操作项目步骤

使用Jpom后

1. 使用浏览器登录方便快捷的管理项目
2. 使用项目分发一键搞定集群项目多机关部署
3. 在线构建不用手动更新升级项目支持拉取 GIT、SVN 仓库支持 ssh 方式发布支持定时构建支持 webhook 形式触发构建
4. 项目状态监控异常自动 警、自动尝试重启支持邮件+钉钉群+微信群通知，主动感知项目运行状况
5. 用户操作监控，监控指定用户指定操作以邮件形式通知
6. 节点脚本模板+定时执行，拓展更多可能
7. 重要路径白名单模式，杜绝用户误操作系统文件
8. 多用户管理，用户项目权限独立(上传、删除权限可控制),完善的操作日志,使用工作空间隔离权限

一键安装（Linux）（推荐）

服务端

安装的路径位于执行命令目录（数据、日志存放目录默认位于安装路径,如需要修改参考配置文件：extConfig.yml ）

?? 特别提醒：一键安装的时候注意执行命令不可在同一目录下，即Server端和Agent端不可安装在同一目录下

如果需要修改数据、日志存储路径请参照 extConfig.yml 文件中 jpom.path 配置属性

yum install -y wget && wget -O install.sh https://dromara.gitee.io/jpom/docs/install.sh && bash install.sh Server备用地址yum install -y wget && wget -O install.sh https://cdn.jsdelivr.net/gh/dromara/Jpom/docs/install.sh && bash install.sh Server支持自动安装jdk环境yum install -y wget && wget -O install.sh https://dromara.gitee.io/jpom/docs/install.sh && bash install.sh Server jdk支持自动安装jdk和maven环境yum install -y wget && wget -O install.sh https://dromara.gitee.io/jpom/docs/install.sh && bash install.sh Server jdk+mvn

启动成功后,服务端的端口为 2122 访问管理页面 例如http://127.0.0.1:2122/

如无法访问，检查下是否开启了防火墙systemctl status firewalld，如状态显示为绿色Active: active (running)可临时关闭防火墙systemctl stop firewalld，然后重启防火墙firewall-cmd –reload（建议仅测试环境下使用，生产环境下慎用建议使用规则放行）

如关闭防火墙后仍无法访问，并且使用的是云服务器，还需要到云服务器管理后台中检查安全组规则(关闭防火墙)

?? 注意： linux 系统中防火墙可能存在多种：Firewall、Iptables，再检查防火墙配置时候需要都检查一下

容器化安装

?? 注意：容器化安装方式需要先安装docker

docker pull jpomdocker/jpomdocker volume create jpom-server-voldocker run -d -p 2122:2122 --name jpom-server -v /etc/localtime:/etc/localtime:ro -v jpom-server-vol:/usr/local/jpom-server jpomdocker/jpom

容器化安装仅提供服务端版本。由于容器和宿主机环境隔离，而导致插件端的很多功能无法正常使用，因此对插件端容器化意义不大。

安装docker、配置镜像、自动启动、查找安装后所在目录等可参考文档https://jpom.io/docs/

一键启动 docker-compose

需要注意修改 .env 文件中的 token 值

git clone https://gitee.com/dromara/Jpom.gitcd Jpomdocker-compose up

管理命令

1. windows 中 Agent.bat 、Server.bat

# 服务端Server.bat     启动管理面板(按照面板提示输入操作)# 插件端Agent.bat     启动管理面板(按照面板提示输入操作)

windows 中执行启动后需要根据日志取跟进启动的状态、如果出现乱码请检查或者修改编码格式，windows 中 bat 编码格式推荐为 GB2312

1. linux 中 Agent.sh 、Server.sh

# 服务端Server.sh start     启动Jpom服务端Server.sh stop      停止Jpom服务端Server.sh restart   重启Jpom服务端Server.sh status    查看Jpom服务端运行状态Server.sh create    创建Jpom服务端的应用服务（jpom-server）# 插件端Agent.sh start     启动Jpom插件端Agent.sh stop      停止Jpom插件端Agent.sh restart   重启Jpom插件端Agent.sh status    查看Jpom插件端运行状态Agent.sh create    创建Jpom插件端的应用服务（jpom-agent）

linux 服务方式管理

这里安装服务仅供参考，实际中可以根据需求自定义配置

在使用 Server.sh create/Agent.sh create 成功后

service jpom-server {status | start | stop}

service jpom-agent {status | start | stop}

Jpom 的参数配置

在项目运行的根路径下的extConfig.yml文件

1. 插件端示例：extConfig.yml
2. 服务端示例：extConfig.yml

演示项目

https://demo.jpom.io

https://jpom.keepbx.cn (备用)

账 ：demo密码：jpom123

演示系统有部分功能做了限制，完整功能请自行部署体验

如果出现登录不上，请联系我们，联系方式在最底部

构建案例仓库代码

1. Jboot 案例代码
2. SpringBoot 案例代码(ClassPath)
3. SpringBoot 案例代码(Jar)
4. node vue 案例代码(antdv)
5. python 案例代码

nodejs 编译指定目录：

    yarn --cwd xxxx/ install    yarn --cwd xxxx/ build

maven 编译指定目录：

    mvn -f xxxx/pom.xml clean package

源码获取：

关注回复“Jpom”，获取项目源码地址。