iPaaS 微服务版集成说明 | 普元数据资产管理平台

# iPaaS 微服务版集成说明

# 第一步、后端部署

# 1. 准备工作

确认 DAMP套件环境已安装并运行
准备好 iPaaS 应用的后端部署包,部署到服务器上,iPaaS 安装需要使用有
Primeton_iPaaS_9.1.0_Portal_Server.tar
Primeton_iPaaS_9.1.0_ESB_Server.tar
下载补丁iPaaS_9.1.0_20250728_P1并按照补丁说明正确安装, 链接: https://pan.baidu.com/s/1gaz6jbfA-ncMSi7m5h2vBQ?pwd=t6bk 提取码: t6bk
在资产套件的数据库下初始化iPaaS Portal数据库（数据库默认编码为UTF-8），执行{iPaaS-Portal安装目录}/db-scripts/如下脚本:

   eos/Mysql/eos_all.sql

   esb/Mysql/1-esb-afc-data.sql

   esb/Mysql/2-schema-esb-mysql.sql

   esb/Mysql/3-data-esb-mysql.sql

   esb/Mysql/4-data-ipaas-connector-mysql.sql

执行上述脚本后，还需要再执行如下脚本

UPDATE afc_menu SET NAME = 'API运维', CODE = 'DevOps', RES_ID = NULL, DESCRIPTION = NULL, SORT_NO = 15, IS_LEAF = '0', TREE_LEVEL = 0, SEQ = NULL, PARENT_ID = 'esb-60', TENANT_ID = 'sys_tenant', CREATE_TIME = NULL, UPDATE_TIME = NULL, CREATE_USER = NULL, UPDATE_USER = NULL, IS_FIXED = NULL, OPEN_TYPE = NULL, MENU_ICON = 'fenlei_6', MENU_TYPE = NULL, BUSINESS_OBJ_ID = NULL, IS_NEW_WINDOW_OPEN = '', APP_ID = NULL WHERE ID = 'esb-112';
UPDATE afc_menu SET NAME = 'API管理', CODE = 'Manage', RES_ID = NULL, DESCRIPTION = NULL, SORT_NO = 11, IS_LEAF = '0', TREE_LEVEL = 0, SEQ = NULL, PARENT_ID = 'esb-60', TENANT_ID = 'sys_tenant', CREATE_TIME = NULL, UPDATE_TIME = NULL, CREATE_USER = NULL, UPDATE_USER = NULL, IS_FIXED = NULL, OPEN_TYPE = NULL, MENU_ICON = 'kapianxingshi', MENU_TYPE = NULL, BUSINESS_OBJ_ID = NULL, IS_NEW_WINDOW_OPEN = '', APP_ID = NULL WHERE ID = 'esb-114';
UPDATE afc_menu SET NAME = 'API开发', CODE = 'Developer', RES_ID = NULL, DESCRIPTION = NULL, SORT_NO = 12, IS_LEAF = '0', TREE_LEVEL = 0, SEQ = NULL, PARENT_ID = 'esb-60', TENANT_ID = 'sys_tenant', CREATE_TIME = NULL, UPDATE_TIME = NULL, CREATE_USER = NULL, UPDATE_USER = NULL, IS_FIXED = NULL, OPEN_TYPE = NULL, MENU_ICON = 'gift', MENU_TYPE = NULL, BUSINESS_OBJ_ID = NULL, IS_NEW_WINDOW_OPEN = '', APP_ID = NULL WHERE ID = 'esb-83';
UPDATE afc_menu SET NAME = '首页', CODE = 'homepage', RES_ID = 'esb-692', DESCRIPTION = NULL, SORT_NO = 10, IS_LEAF = '0', TREE_LEVEL = 0, SEQ = NULL, PARENT_ID = 'esb-60', TENANT_ID = 'sys_tenant', CREATE_TIME = NULL, UPDATE_TIME = NULL, CREATE_USER = '1', UPDATE_USER = '1', IS_FIXED = NULL, OPEN_TYPE = NULL, MENU_ICON = 'shouye', MENU_TYPE = NULL, BUSINESS_OBJ_ID = NULL, IS_NEW_WINDOW_OPEN = 'fullScreen', APP_ID = NULL WHERE ID = 'esb-88';
UPDATE afc_menu SET NAME = 'API市场', CODE = 'apiMarketplace', RES_ID = 'esb-693', DESCRIPTION = NULL, SORT_NO = 16, IS_LEAF = '0', TREE_LEVEL = 0, SEQ = NULL, PARENT_ID = 'esb-60', TENANT_ID = 'sys_tenant', CREATE_TIME = NULL, UPDATE_TIME = NULL, CREATE_USER = '1', UPDATE_USER = '1', IS_FIXED = NULL, OPEN_TYPE = NULL, MENU_ICON = 'kapianxingshi', MENU_TYPE = NULL, BUSINESS_OBJ_ID = NULL, IS_NEW_WINDOW_OPEN = 'fullScreen', APP_ID = NULL WHERE ID = 'esb-89';
INSERT INTO afc_menu (ID, NAME, CODE, RES_ID, DESCRIPTION, SORT_NO, IS_LEAF, TREE_LEVEL, SEQ, PARENT_ID, TENANT_ID, CREATE_TIME, UPDATE_TIME, CREATE_USER, UPDATE_USER, IS_FIXED, OPEN_TYPE, MENU_ICON, MENU_TYPE, BUSINESS_OBJ_ID, IS_NEW_WINDOW_OPEN, APP_ID) VALUES ('esb-60', '服务门户', 'servicePortal', NULL, NULL, 10, '0', 0, NULL, 'root', 'sys_tenant', NULL, NULL, '1', '1', NULL, NULL, 'shouye', NULL, NULL, 'fullScreen', NULL);

# 2. 修改iPaaS应用配置

修改应用配置文件中的应用名相关配置:
资产 stadnalone 应用默认端口为 28084,如果修改.则将其修改为对应端口. 如果应用没有部署在同一台服务器上.也需要将 ip 修改为资产应用部署服务器的真实 ip

application-afc.properties

# 原配置
afc.application.name=AFCENTER

# 修改为Standalone后端地址
afc.application.name=127.0.0.1:28084

# 3. 修改DAMP套件应用配置

需要修改资产套件下config/DAMP/config/user-config.xml，在接口白名单中增加“/api/eos/tools/actions/call-method”配置/

<group name="Login-Filter">
   <configValue key="Exclude">/api/lowcode/models/actions/third/download,/api/afc/sso/redirect-url/default,/api/afc/validation-code,/api/afc/login,/api/afc/login/password/key,/api/afc/user/validation-code,/api/afc/login/clientId,/api/afc/login/third-party/qrConnect,/api/afc/login/third-party/mobile/authorize,/api/afc/login/third-party/auth,/api/afc/login/web/third-party/auth,/api/afc/login/third-party/types,/api/afc/login/third-party/validate,*.gif,*.svg,.ttf,*.woff2,*.woff,*.jpg,*.json,*.ico,*.js,*.css,*.png,*.html,/api/afc/oauth2/*,/swagger-ui.html,/v2/api-docs,/webjars/*,/swagger-resources/*,/api/afc/job/api/*,/api/afc/preferences/info/*,/api/lowcode/resources/*/runtimes,/api/taskcenter/push-task/*,/api/lowcode/shares/actions/*,/api/afc/materials/font/*,/api/afc/components/*,/actuator/*,/api/afc/component-centers,/api/eos/tools/actions/call-method</configValue>
   <configValue key="Include">/*</configValue>
   <!-- the page to display when user not login -->
   <configValue key="LoginPage"></configValue>
</group>

# 第二步、前端部署

# 1. 准备工作

获取 iPaaS 前端介质 Primeton_iPaaS_9.1.0_Portal_UI.tar

# 2. 部署到前端部署目录

在套件前端afcenter目录下新建 esb 目录，将 iPaaS 前端介质复制到esb目录下并进行解压

${standalone_path}/web/afcenter/esb

# 3. 配置 DAMP 代理

编辑配置文件：

${standalone_path}/web/conf/damp.conf

添加以下配置：

location /api/esb/ {
  proxy_pass http://127.0.0.1:28088/api/esb/;# 修改为iPaaS-Portal的后端IP和端口
}

# 4. 重载 Nginx 配置

# 重载配置
./nginx -s reload

# 5. 配置门户

修改${standalone_path}/web/afcenter/config/app-config.json 在 settingMenuList 中添加 iPaaS 服务门户对应信息 servicePortal

{
  "settingMenuList": [
    {
      "name": "业务门户",
      "url": "/#/module/formDesigner/page/render?resourceType=form&resourceCode=portal.index&appName=DAMP"
    },
    {
      "code": "dam_portal_manage",
      "name": "管理门户"
    },
    {
      "code": "dam_portal_tech",
      "name": "技术门户"
    },
    {
      "code": "servicePortal",
      "name": "服务门户"
    }
  ]
}

# 第三步、启动服务

分别启动 DAMP 的相关服务，iPaaS Portal Server 服务和 iPaaS ESB Server 服务，启动成功后浏览器访问 http://nginx-ip，使用 manager 用户登录。

# iPaaS集成数据服务配置说明

数据服务支持系统配置双环境，针对生产环境（prod）和开发环境（dev）分别设置对应配置项。所有配置项均遵循统一命名规则，通过在配置项末尾添加环境标识符（.prod 或.dev）进行区分，系统将根据该环境标识符自动识别并加载对应环境的配置信息，确保不同环境下业务运行所需的参数独立且准确。本文档以 prod 做实例。如果需要测试环境,则修改对应 dev 的配置即可。

# iPaaS-创建服务器组

使用 manager 账号（默认密码：000000）登录系统，单击"管理门户->资源管理->服务器管理"，进入服务器组及服务器管理页面。
选中右侧显示的"服务器组管理"界面，点击“新增”按钮，输入相关参数，新增服务器组。
新增类型为“ESB”的服务器组。

# iPaaS-创建服务器

单击"管理门户->资源管理->服务器管理"，选中右侧显示的"服务器管理"界面，点击“新增”按钮，输入相关参数，增加服务器。
新增类型为“ESB”的服务器，配置安装的ESB Server的 IP和端口。

# iPaaS-创建域

单击"管理门户->资源管理->域管理"，右侧显示域管理界面，点击“新增”按钮，弹出新增域界面。
在“新增域”界面，输入域相关参数。
单击“确定”，提示“保存成功”。

# iPaaS-为域分配服务器组

只有给域分配了可用的服务器组，域下的接口在发布时才能选择服务器并进行正常的接口发布操作。若新增域时未关联服务器组，则可在域创建后，在域展示列表中选择需要关联服务器组的域，在操作列点击“添加服务器组”按钮，弹出添加服务器组页面。
在左侧选择未分配的服务器组，点击“＞”按钮，为域分配服务器组，每个域下的接口只能发布到已分配的服务器组。

# iPaaS-创建系统

单击"管理门户->资源管理->系统管理"，右侧显示系统管理界面，点击“新增”按钮，进入“新增系统”界面。
在“新增系统”界面，输入相关参数。
单击“确定”按钮，提示“保存成功”。
将系统编码填入 esb.appCode.prod 对应配置

# iPaaS-创建服务

单击"开发门户->资源管理->服务管理"，右侧显示服务管理界面，点击“新增”按钮，弹出新增服务界面。
在“新增服务”界面，输入相关参数。
单击“确定”按钮，提示“保存成功”。
将服务编码填入 esb.serviceCode.prod 对应配置

# iPaaS-创建业务地址

单击"开发门户->资源管理->业务地址"，右侧显示业务地址界面，点击“新增”按钮，弹出新增业务地址界面。
在“新增业务地址”界面，输入相关参数。
单击“确定”按钮，提示“保存成功”。
将业务地址的业务 IP 和业务端口分别填入 esb.businessServiceIp.prod 和 esb.businessServicePort.prod 对应配置

# DAMP-集成参数调整

在资产平台中平台参数页面完成最终的集成配置更新。下文主要介绍生成环境（prod）的配置说明，开发环境（dev）和生成环境参考配置即可。

参数名称	参数说明	参考示例
esb.enable.prod	是否集成 iPaaS ,设置为 true,服务发布时会推送接口至 iPaaS	true
esb.ip.prod	iPaaS Portal 后端应用部署服务器的 IP	192.168.2.121
esb.port.prod	iPaaS Portal 后端应用端口	20888
esb.mircoAppIntegration.prod	iPaaS 集成方式，套件集成方式默认填true	true
esb.userName.prod	iPaaS 平台登录用户名，套件集成中不使用，可以忽略	..
esb.password.prod	iPaaS 平台登录密码，套件集成中不使用，可以忽略	..
esb.httpPort.prod	端口管理中 http 对应端口，默认是10001	10001
esb.serviceCode.prod	服务编码，通过上文操作手动注册	primeton.dam.data.engine
esb.appCode.prod	应用编码，通过上文操作手动注册	primeton.dam.data
esb.businessServiceIp.prod	业务 IP，配置服务引擎IP	192.168.2.121
esb.businessServicePort.prod	业务端口，配置服务引擎端口，默认是10010	10010
esb.token.prod	套件集成模式下不需要填写，可以忽略	..
esb.proxyUrl.prod	代理后的http服务地址,用于数据服务详情页面显示服务地址	http://192.168.2.121:10001
esb.proxyPrefix.prod	iPaaS 地址前缀 ,如有需求则填写	prod

← 元数据集成说明主数据微服务版集成说明 →