Jpom项目运维 Jpom项目运维
🛡️安全公告
📢项目公告
  • 新手路线

    • 十分钟上手(图文)
    • 菜单地图与路径速查
  • 典型操作(图文)

    • 节点项目:新增与启停
    • 节点脚本:定时任务
    • 节点分发:多节点发布
    • 日志搜索:集中查日志
    • 在线构建:仓库到发布
    • 监控与告警
  • 立马上手安装

    • 一键安装
    • 下载安装
    • 容器安装
    • 安装服务
    • Go 插件端(安装/切换/升级)
  • 大版本升级

    • v2.10.X迁移到v2.11.X指南
    • v2.9.X迁移到v2.10.X指南
    • v2.8.X迁移到v2.9.X指南
    • 数据库迁移到 mysql
    • 数据库迁移到 mariadb
    • 数据库迁移到 postgresql
  • 文档碎片

    • 分类
    • 标签
    • 归档
  • 实践案例目录
  • Oauth2平台登录
  • 安装实践

    • 一键安装教程
    • Docker 容器安装教程
    • 离线安装教程
  • 通用教程

    • Jpom 为 Jpom 发版
    • 自定义第三方通知
    • DSL 项目来管理 NGINX
    • 管理证书文件
  • 名词解释
  • 账户相关
  • 构建相关
  • 工作空间
  • 权限说明
  • 资产说明
  • DSL 入门与场景

    • DSL 是什么、能做什么
    • 配置字段详解(YAML)
    • 常见问题与排查
  • 配置示例

    • 管理 Java 项目(含 JDK 版本)
    • 管理 Python 项目
    • 容器构建的 DSL
  • 实践案例(当前写法)

    • DSL 管理 NGINX
    • DSL 接口探活监控报警
    • DSL 管理 Tomcat
    • DSL 管理 Elasticsearch
  • 老版本写法(2.9 及以前)

    • 万能的 DSL 项目模板(Java)
    • 自定义管理 python 项目
    • 接口探活(旧写法)
  • 🔋赞赏支持💰
  • 📑赞赏记录
  • 🎁专属纪念品
  • 💬社群讨论
  • 💪🏻如何贡献
  • 👥贡献者们
  • 🚩我们用户
  • 🤝企业服务
  • 发版日志

    • 稳定版本-release
    • 内测版本-beta
  • 下载中心

    • 稳定版本-release
    • 内测版本-beta
  • Gitee (opens new window)
  • Github (opens new window)
  • Gitcode (opens new window)
🛡️安全公告
📢项目公告
  • 新手路线

    • 十分钟上手(图文)
    • 菜单地图与路径速查
  • 典型操作(图文)

    • 节点项目:新增与启停
    • 节点脚本:定时任务
    • 节点分发:多节点发布
    • 日志搜索:集中查日志
    • 在线构建:仓库到发布
    • 监控与告警
  • 立马上手安装

    • 一键安装
    • 下载安装
    • 容器安装
    • 安装服务
    • Go 插件端(安装/切换/升级)
  • 大版本升级

    • v2.10.X迁移到v2.11.X指南
    • v2.9.X迁移到v2.10.X指南
    • v2.8.X迁移到v2.9.X指南
    • 数据库迁移到 mysql
    • 数据库迁移到 mariadb
    • 数据库迁移到 postgresql
  • 文档碎片

    • 分类
    • 标签
    • 归档
  • 实践案例目录
  • Oauth2平台登录
  • 安装实践

    • 一键安装教程
    • Docker 容器安装教程
    • 离线安装教程
  • 通用教程

    • Jpom 为 Jpom 发版
    • 自定义第三方通知
    • DSL 项目来管理 NGINX
    • 管理证书文件
  • 名词解释
  • 账户相关
  • 构建相关
  • 工作空间
  • 权限说明
  • 资产说明
  • DSL 入门与场景

    • DSL 是什么、能做什么
    • 配置字段详解(YAML)
    • 常见问题与排查
  • 配置示例

    • 管理 Java 项目(含 JDK 版本)
    • 管理 Python 项目
    • 容器构建的 DSL
  • 实践案例(当前写法)

    • DSL 管理 NGINX
    • DSL 接口探活监控报警
    • DSL 管理 Tomcat
    • DSL 管理 Elasticsearch
  • 老版本写法(2.9 及以前)

    • 万能的 DSL 项目模板(Java)
    • 自定义管理 python 项目
    • 接口探活(旧写法)
  • 🔋赞赏支持💰
  • 📑赞赏记录
  • 🎁专属纪念品
  • 💬社群讨论
  • 💪🏻如何贡献
  • 👥贡献者们
  • 🚩我们用户
  • 🤝企业服务
  • 发版日志

    • 稳定版本-release
    • 内测版本-beta
  • 下载中心

    • 稳定版本-release
    • 内测版本-beta
  • Gitee (opens new window)
  • Github (opens new window)
  • Gitcode (opens new window)
广告采用随机轮播方式显示 ❤️成为赞助商
  • 自述序言

  • 安装使用

  • 备份&升级

  • 迁移数据

  • Go插件端

  • 快速上手

    • 十分钟上手:从登录到第一个项目上线
    • 菜单地图与操作路径速查
    • 在线构建:从仓库到自动发布
      • 这个页面能帮你做什么
      • 操作路径
      • 第一步:加仓库
      • 第二步:新增构建(5 步向导)
        • ① 构建方式
        • ② 基础信息
        • ③ 构建流程
        • ④ 发布操作
        • ⑤ 其他配置
      • 第三步:触发构建
      • 常见问题
      • 相关文档
    • 监控与告警:让项目挂了第一时间知道
  • 用户&权限

  • 工作空间&集群

  • 资产管理

  • 节点&项目

  • DSL说明

  • AI运维

  • 常见问题

  • 历史文档

  • 文档
  • 快速上手
bwcx_jzy
2026-11-19
目录

在线构建:从仓库到自动发布

# 这个页面能帮你做什么

把「拉代码 → 编译打包 → 传到服务器 → 重启项目」这条链路交给 Jpom: 以后要么点一下按钮构建,要么推一次代码(Gitee/GitLab Webhook)就自动上线。

# 操作路径

步骤 菜单
1. 加仓库(只需一次) 【在线构建】->【仓库信息】->【新增】
2. 建构建任务 【在线构建】->【构建列表】->【新增】
3. 看结果 【在线构建】->【构建历史】

构建列表

# 第一步:加仓库

【仓库信息】->【新增】:

新增仓库

字段 说明
仓库名称 显示用
分组 虚拟分组
仓库类型 目前主要是 GIT
仓库地址 HTTPS 或 SSH 地址
协议 选 HTTP(S) 就填账号密码/令牌;选 SSH 需要提前在服务器上配好私钥
账号 / 密码 私有仓库必填;公开仓库可留空
引用环境变量 账号密码也可以从【脚本管理】->【环境变量】里引用,避免明文
全局 / 当前工作空间 全局仓库所有工作空间可用

仓库信息

# 第二步:新增构建(5 步向导)

【构建列表】->【新增】,会打开一个整页向导(不是弹窗),分 5 步:

# ① 构建方式

构建方式

  • 本地构建:直接在服务端所在服务器执行构建命令 → 该服务器必须装好 JDK / Maven / Node 等
  • 容器构建:用 Docker 容器跑构建,环境隔离,不用在宿主机装依赖 → 需要先在【Docker管理】里添加 Docker 并分配工作空间,且宿主机能访问公网拉镜像

选定后不能改

「创建后构建方式不支持修改」。如果两个都要,就建两个构建任务。 另外:容器方式安装的 Jpom 服务端不能用本地构建(容器里没有宿主机的构建环境)。

# ② 基础信息

基础信息

名称、分组名称、源仓库(点【选择仓库】挑上一步加的仓库)。

# ③ 构建流程

字段 说明
分支 必选,支持通配符(feature/*)
标签 一般不选,默认拉最新提交
克隆深度 大仓库建议填 1,只拉最近一次提交
构建命令 如 mvn clean package -Dmaven.test.skip=true、npm i && npm run build,多行默认逐行执行,可用【严格执行】要求每一步退出码必须为 0
产物目录 相对仓库根目录,如 target/app.jar、dist,只取匹配到的第一项
执行方式 默认 / 多线程(实验属性)

构建命令里可用变量:${BUILD_ID}、${BUILD_NAME}、${BUILD_NUMBER_ID},也可以引用工作空间变量和全局脚本库(G@脚本名)。

# ④ 发布操作

这是最容易配错的一步。先选发布方式:

发布方式 适用
不发布 只想编译验证,产物留在构建历史里
分发项目 多节点统一发布(需先有节点分发)
项目 发布到某个节点里的某个项目(最常用)
SSH 通过 SSH 授权目录上传 + 执行命令
本地命令 在服务端本机执行命令发布
Docker 镜像 / 集群 构建镜像、推到仓库、发布到 Swarm

选「项目」时常见字段:

  • 发布项目:选节点 + 项目
  • 发布后操作:如重启项目
  • 二级目录:不填就发布到项目根目录
  • 清空发布 / 差异发布:清空=先删后传;差异=只传变化文件(两个都开时,会顺带删掉产物里没有的旧文件)
  • 发布前停止:先关项目再替换文件(Windows 下文件被占用时必须开)

变量替换

发布前后命令支持 ${BUILD_ID}、${BUILD_NAME}、${BUILD_RESULT_FILE}、${BUILD_NUMBER_ID}, 常见写法:发布前 sh stop.sh,发布后 sh start.sh。

# ⑤ 其他配置

缓存构建、保留产物、差异构建、严格执行、定时构建(cron)、事件脚本、附加环境变量(.env)、 同步到文件管理中心、发布隐藏文件、保留天数/个数、版本快照、排除发布(ANT 表达式)。

配好后点【保存】或【保存并构建】。

# 第三步:触发构建

有三种方式:

  1. 手动:构建列表行内点【构建】
  2. 定时:在第 ⑤ 步填 cron(默认不支持秒级,需服务端开启 jpom.system.timer-match-second)
  3. 代码推送自动构建:
    • Gitee:详见Gitee 提交代码后自动构建
    • GitLab:详见GitLab 提交代码后自动构建

构建完成后到【构建历史】看日志和产物;失败的构建会保留日志方便对照。

# 常见问题

Q:构建报「mvn: command not found」? A:本地构建用的是服务端所在服务器的环境。装好 Maven/JDK 后,重启服务端才会读到新的环境变量。

Q:产物找不到 / 发布后目录是空的? A:检查【产物目录】是否相对仓库根目录正确,且能匹配到实际文件(只取第一个匹配项)。

Q:发布到项目失败,提示没有授权目录? A:发布目标需要授权目录:项目用【节点&项目】->【授权配置】;SSH/FTP 发布需要各自配置授权目录。

Q:想回到上一个版本? A:开启【版本快照】后可在项目文件页的【版本管理】里回滚;或在【构建历史】里重新发布历史产物。

# 相关文档

  • 节点项目:发布目标项目怎么建
  • 节点分发:多节点统一发布
  • 构建相关常见问题
帮助我们改善此文档 (opens new window)
#构建#新手
更新时间: 2026/11/19, 12:33:35

← 菜单地图与操作路径速查 监控与告警:让项目挂了第一时间知道→

最近更新
01
在 Jpom 中如何使用 DSL 项目来管理 NGINX
11-19
02
DSL 项目接口探活监控报警
11-19
03
FTP 授权与文件管理
11-19
更多文章>
Theme by Vdoing | Copyright © 2019-2026 | Jpom开源项目

我们用户 | 贡献者们 | 专属纪念品

本站访问量:- | 京ICP备17044819号
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式
×