一、概述 ​

Oinone 平台为合作伙伴提供了多种部署方式，这篇文章将介绍如何在私有云环境部署 Oinone 平台 JAR包。

注意：

本文以5.2.6为例进行介绍。

二、部署环境要求 ​

（一）包含全部中间件及设计器服务的环境要求 ​

  • CPU：8 vCPU
  • 内存（RAM）：16G以上
  • 硬盘（HDD/SSD）：60G以上

（二）仅设计器服务的环境要求 ​

  • CPU：8 vCPU
  • 内存（RAM）：8G以上
  • 硬盘（HDD/SSD）：40G以上

三、部署准备 ​

（一）在部署环境创建部署目录 ​

shell
mkdir -p /home/admin/oinone-designer

提示：

为方便管理，所有Oinone部署所需文件都应该在该目录下存放。

（二）服务器需要安装的中间件 ​

（三）使用 Docker 启动所有中间件 ​

点击下载一键部署所有中间件套件包

middleware-kits.zip

四、部署清单 ​

下面列举了文章中在本地环境操作结束后的全部文件：

  • 设计器JAR包：pamirs-designer-boot-v5.2-5.2.6.jar
  • 离线部署结构包：oinone-designer-jar-offline.zip
  • 第三方数据库驱动包（非 MySQL 数据库必须）

提示：

如需一次性拷贝所有部署文件到部署环境，可以将文档步骤在本地环境执行后，一次性将所有文件进行传输。

五、在本地环境准备部署文件 ​

（一）下载离线部署结构包 ​

oinone-designer-jar-offline.zip

（二）下载部署JAR包 ​

找到独立部署所有设计器 JAR 标题，下面有对应的 JAR 包提供下载。

例如： https://oinone-jar.oss-cn-zhangjiakou.aliyuncs.com/install/oinone-designer/pamirs-designer-boot-v5.2-5.2.6.jar

六、后端服务部署 ​

（一）将部署 JAR 包移动到backend目录下，并重命名为oinone-designer.jar ​

shell
mv pamirs-designer-boot-v5.2-5.2.6.jar backend/oinone-designer.jar

提示：

该名称为startup.sh脚本的默认值，可根据实际情况自行修改

（二）将 Pamirs 许可证移动到backend/config目录下，并重命名为license.lic ​

shell
mv oinone-demo_1730163770607.lic backend/config/license.lic

（三）加载非 MySQL 数据库驱动（按需） ​

将驱动jar文件移动到backend/lib目录下即可。

以 KDB8 数据库驱动kingbase8-8.6.0.jar为例

shell
mv kingbase8-8.6.0.jar backend/lib/

提示：

backend/lib目录为非设计器内置包的外部加载目录（外部库），可以添加任何jar包集成到设计器中。

（四）修改backend/startup.sh脚本 ​

  • IP：修改为可被外部访问的 IP 地址
  • DB_BASE_：base 库相关数据库连接配置
  • DB_PAMIRS_：pamirs 库相关数据库连接配置
  • REDIS_：Redis 相关配置
  • MQ_NAME_SERVER：RocketMQ 的 name-server 连接地址
  • ZOOKEEPER_：Zookeeper 相关配置

提示：

若需要配置方言或其他参数，可直接修改backend/config/application.yml配置文件，变量仅用于简单配置场景

（五）执行startup.sh脚本启动 ​

shell
sh startup.sh

执行完成后会打印三个路径

  • 后端路径：backend root path: /path/to/backend
  • 前端路径：frontend root path: /path/to/frontend
  • Nginx 配置路径：nginx services path: /path/to/nginx

七、Nginx 配置 ​

（一）在本地 nginx 服务中找到nginx.conf，并添加 Nginx 配置路径为加载目录 ​

nginx
http {
    ...
    include /path/to/nginx/*.conf;
}

（二）修改结构包中的default.conf第7行root配置为前端路径到dist目录下 ​

nginx
server {
    ...
    root /path/to/frontend/dist;
}

（三）修改结构包中的oss.conf第30行alias配置为前端路径到static目录下 ​

nginx
server {
    ...
    location /static {
        ...
        alias /path/to/frontend/static;
    }
}

八、访问服务 ​

使用http://127.0.0.1:9090访问服务