JLC Docs
PIG
AI
PIG
AI

【进阶】单体版本部署

重要说明

PIGX 有且仅有一套代码，同时支持微服务与单体架构运行方式，注意看如下文档！

一、服务端代码运行

① 下载源代码

git clone https://git.pig4cloud.com/pig/pigx.git

② 设置 Maven boot Profile

Maven Profile 配置步骤

如下图：① 点击 IDEA 右侧 Maven 面板； ② 勾选 boot profile； ③ 点击 Maven reload ；直至 ④ 处 被识别为正确的蓝色 Maven module。 （如编译报错，请多次执行 ③ Maven reload）

Maven Profile 配置界面

③ 初始化数据库

数据库脚本说明

source db/0pigxx_boot.sql

④ 修改代码中的数据库和 Redis 连接信息

# pigx-boot/application-dev.yml
├── pigx-boot
│   ├── src
│   │   └── main
│   │       └── resources
│   │           ├── application-dev.yml
配置文件位置

⑤ 运行服务端

运行服务端

二、前端代码运行

① 下载源代码

git clone https://git.pig4cloud.com/pig/pigx-ui.git

② 指定前端架构

前端架构设置为单体

请务必检查前端 .env 文件中的 VITE_IS_MICRO 配置，需设置为 false。

VITE_IS_MICRO=false
前端架构配置

③ 安装前端依赖

Node 版本要求

Node 版本必须使用 18，如遇 install 失败，请删除 node_modules 文件夹，尝试重新 npm install

# 查看 node 版本
node -v

# 高版本执行切换至 18
n 18.20.4
# 下载前端源码
git clone https://git.pig4cloud.com/pig/pigx-ui.git

# 安装前端依赖
npm install --registry=https://registry.npmmirror.com

# 启动
npm run dev

必看：单体和微服务版本区别

关键差异说明

单体版本所有请求统一使用 /admin 前缀（context-path）

  • 登录端点：http://pigx-gateway:9999/admin/oauth2/token
  • 接口文档：http://pigx-gateway:9999/admin/doc.html
  • 路径变更示例：微服务版本的 /pay/order/save 在单体版本中变更为 /admin/order/save

功能支持差异

单体版本不支持以下功能：

  • ❌ 大屏设计器（参考文档）
  • ❌ 报表设计器（参考文档）
  • ❌ 路由管理、服务监控、流量监控等微服务概念服务

配置文件说明

单体版本配置文件加载规则与微服务版本有所不同，需要将所有的配置项配置在 pigx-boot 目录的本地文件中。
文件名作用
application.yml通用配置文件（正常情况下不需要改动）
application-dev.yml开发环境配置文件（redis, mysql）
本页目录