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

您为什么需要 Jpom

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

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

使用Jpom前

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

使用Jpom后

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

一键安装（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/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/

一键启动 docker-compose

• 无需安装任何环境,自动编译构建

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

git clone https://gitee.com/dromara/Jpom.git
cd Jpom
docker-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”，获取项目源码地址。