Java 项目在线管理 Jpom

国

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

你为什么需要Jpom

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

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

此方法不足的是

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

在使用Jpom后

1. 使用浏览器登录方便快捷管理项目
2. 界面形式实时查看项目运行状态、控制台日志、管理项目文件
3. 在线 SSH 终端,让您在没有 Xshell、FianlShell 等软件也能轻松管理服务器
   1. 运维登录 Jpom 系统不需要知道服务器密码
   2. 并且能自动执行命令日志
   3. 能指定 ssh 禁止执行命令，避免执行搞风险命令
   4. SSH 命令模版在线执行脚本还能定时执行
4. 集群项目使用项目分发一键搞定多机部署
5. 在线构建不用手动上传项目包
   1. 支持拉取 GIT、SVN 仓库
   2. 支持 ssh 方式发布
   3. 支持定时构建
   4. 支持 webhook 形式触发构建
6. 通过 Jpom 快速编辑 nginx 配置文件并自动 reload
7. 项目状态监控异常自动报警、并且能自动尝试重启
   1. 支持邮件+钉钉群+微信群通知
8. 用户操作监控，监控指定用户指定操作以邮件形式通知
9. 节点脚本模版+定时执行

项目主要功能及特点

1. 使用浏览器登录方便快捷管理项目
2. 界面形式实时查看项目运行状态、控制台日志、管理项目文件
   1. 在线修改项目文本文件
3. 在线 SSH 终端,让您在没有 Xshell、FianlShell 等软件也能轻松管理服务器
   1. 运维登录 Jpom 系统后不需要知道服务器密码
   2. 并且能自动执行命令日志
   3. 能指定 ssh 禁止执行命令，避免执行高风险命令
   4. 设置文件目录，在线查看管理对应项目文件及配置文件
   5. SSH 命令模版在线执行脚本还能定时执行
   6. 在线修改文本文件
   7. 轻量的实现了简单的"堡垒机"功能
4. 使用项目分发一键搞定集群项目多机部署
5. 在线构建不用手动更新升级项目
   1. 支持拉取 GIT、SVN 仓库
   2. 支持 ssh 方式发布
   3. 支持定时构建
   4. 支持 webhook 形式触发构建
6. 支持在线编辑 nginx 配置文件并自动 reload等操作
   1. 管理 nginx 状态
   2. 管理 ssl 证书
7. 项目状态监控异常自动报警、自动尝试重启
   1. 支持邮件+钉钉群+微信群通知，主动感知项目运行状况
8. 用户操作监控，监控指定用户指定操作以邮件形式通知
9. 节点脚本模版+定时执行，拓展更多可能
10. 重要路径白名单模式，杜绝用户误操作系统文件
11. 多用户管理，用户项目权限独立(上传、删除权限可控制),完善的操作日志,使用工作空间隔离权限

特别提醒

1. 在 Windows 服务器中可能有部分功能因为系统特性造成兼容性问题，建议在实际使用中充分测试。Linux 目前兼容良好
2. 服务端和插件端请安装到不同目录中，切勿安装到同一目录中
3. 卸载 Jpom 插件端或者服务端，先停止对应服务，删除对应的程序文件、日志文件夹、数据目录文件夹即可
4. 构建依赖的是系统环境，如果需要 maven 或者 node 需要服务端所在的服务器中有对应插件，如果已经启动服务端再安装的对应环境需要通过命令行重启服务端后才生效。
5. 在Ubuntu/Debian服务器作为插件端可能会添加失败，请在当前用户的根目录创建 .bash_profile文件

一键安装

服务端

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

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

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

yum install -y wget && wget -O install.sh https://keepbx.gitee.io/jpom/install.sh && bash install.sh Server

插件端

yum install -y wget && wget -O install.sh https://keepbx.gitee.io/jpom/install.sh && bash install.sh Agent

容器化安装

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

docker pull jpomdocker/jpom
docker volume create jpom-server-vol
docker 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/

下载安装

帮助文档

1. 下载安装包 https://gitee.com/keepbx/Jpom/attach_files
2. 解压文件
3. 安装插件端（流程说明）
   1. agent-x.x.x-release 目录为插件端的全部安装文件
   2. 上传到对应服务器
   3. 命令运行（Agent.sh、Agent.bat）
4. 安装服务端（流程说明）
   1. server-x.x.x-release 目录为服务端的全部安装文件
   2. 上传到对应服务器
   3. 命令运行（Server.sh、Server.bat）

编译安装

帮助文档

1. 访问Jpom的码云主页,拉取最新完整代码(建议使用master分支)
2. 进入项目目录执行:mvn clean package
3. 安装插件端（流程说明）
   1. 查看插件端安装包 modules/agent/target/agent-x.x.x-release
   2. 打包上传服务器运行
   3. 命令运行（Agent.sh、Agent.bat）
4. 安装服务端（流程说明）
   1. 查看插件端安装包 modules/server/target/server-x.x.x-release
   2. 打包上传服务器运行
   3. 命令运行（Server.sh、Server.bat）

编译运行

1. 访问Jpom的码云主页,拉取最新完整代码(建议使用master分支、如果想体验新功能请使用dev分支)
2. 运行插件端
   1. 运行cn.keepbx.jpom.JpomAgentApplication
   2. 注意控制台打印的默认账号密码信息
3. 运行服务端
   1. 运行cn.keepbx.jpom.JpomServerApplication
   2. 浏览器访问（如：http://127.0.0.1:2122）

管理命令

1. windows中Agent.bat 、Server.bat

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

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

1. linux中Agent.sh 、Server.sh

# 服务端
Server.sh start     启动Jpom服务端
Server.sh stop      停止Jpom服务端
Server.sh restart   重启Jpom服务端
Server.sh status    查看Jpom服务端运行状态

# 插件端
Agent.sh start     启动Jpom插件端
Agent.sh stop      停止Jpom插件端
Agent.sh restart   重启Jpom插件端
Agent.sh status    查看Jpom插件端运行状态

Jpom 的参数配置

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

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

演示项目

https://jpom.keepbx.cn

账号：demo
密码：jpom123

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

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

1. Jboot案例代码
2. SpringBoot案例代码(ClassPath)
3. SpringBoot案例代码(Jar)

常见问题、操作说明

https://jpom-site.keepbx.cn/docs/

https://jpom-site.keepbx.cn/docs/#/FQA/FQA

Jpom 插件开发