恢复/迁移ROMA Connect实例资产

业务场景

ROMA Connect支持把实例的应用和任务以资产文件形式导出，也可以把资产文件导入ROMA Connect，实现集成资产的快速恢复或迁移，资产文件的导入导出操作请参见导入导出ROMA Connect实例资产。

• 资产恢复：从ROMA Connect实例导出集成资产进行数据备份，若后续因实例故障或数据丢失需要恢复资产数据，可将备份的资产文件再导入实例进行资产恢复。

  建议定期导出资产文件进行数据备份（如按月导出资产文件），以供数据恢复使用。

• 资产迁移：把其他ROMA Connect实例导出的集成资产文件导入新建的实例，实现集成资产的快速部署和使用。

ROMA Connect的资产导入功能仅支持集成资产数据导入，不支持资产相关的实例配置数据导入。在完成集成资产的导入后，还需要完成资产相关的实例配置。

业务流程

集成资产的恢复/迁移流程如下表所示。

准备工作

在进行集成资产的恢复或迁移前，您需要做如下准备：

• 准备集成资产包。

  获取用于导入的集成资产包。

• 获取资产包所属源实例的配置信息，仅资产迁移场景需要。

  主要包括实例的安全组配置、实例配置参数和数据字典信息。

• 获取周边系统的对接信息，仅资产迁移场景需要。

  系统	数据项	用途
  数据源	数据源的访问IP、用户名和密码。	用于ROMA Connect对接数据源。
  业务应用	业务应用的网段信息。	用于打通ROMA Connect到业务应用的网络。

修改实例配置

在导入集成资产前，需要修改要导入集成资产实例参数配置，包括安全组、路由、实例配置参数、数据字典等。

在资产迁移场景，实例配置参数应与资产包所属的源实例一致，否则会导致资产导入失败。

1. 登录ROMA Connect控制台，在左侧导航栏选择“资源管理”，在实例页面单击实例，进入实例控制台。
2. 修改安全组配置，仅资产迁移场景需要，否则跳过此步。
   1. 在“实例信息”页面的“基本信息”页签下，单击安全组的名称。
   2. 在安全组配置页面中，根据准备工作中获取的源实例安全组信息和新实例的实际组网需求，修改安全组的规则配置。
3. 修改实例路由信息，仅资产迁移场景需要，否则跳过此步。

   在“实例信息”页面的“基本信息”页签下，更改路由信息。

4. 修改实例配置参数，仅资产迁移场景需要，否则跳过此步。

   在“实例信息”页面的“配置参数”页签下，根据准备工作中获取的源实例配置参数信息，修改配置参数。

5. 添加数据字典配置。

   在“实例信息”页面的“数据字典”页签下，根据准备工作中获取的源实例数据字典信息，添加数据字典配置。

   具体创建字典的操作请参见创建ROMA Connect实例数据字典。

导入集成资产

通过ROMA Connect的资产导入功能，把获取到的集成资产包快速导入ROMA Connect实例。

1. 在实例控制台的“实例信息”页面，单击右上角的“导入资产”。
2. 在“导入资产”弹窗中根据实际情况选择“新增导入”或“覆盖导入”。
   • 资产恢复场景，选择“覆盖导入”。
   • 资产迁移场景，选择“新增导入”。
3. 当选择“覆盖导入”时，根据是否需要覆盖环境配置选择“覆盖”或“不覆盖”。
   • 覆盖：当导入的数据源存在同名数据源时，选择更新数据源。
   • 不覆盖：当导入的数据源存在同名数据源时，不做更新。
4. 输入前缀。

   同一实例的数据集成任务名不可以重复，如含有相同名称的FDI任务，请输入前缀。

5. 在弹窗中选择本地保存的资产文件，并导入。

6. 完成后单击“关闭”，您可以在实例中查看已导入的资产。

修改集成应用配置

集成应用的用户授权信息为非资产数据，在导入集成资产后根据需要重新配置。

• 对于资产恢复场景，需要对导入的集成应用进行配置。
• 对于资产迁移场景，可根据实际使用逐步配置。

1. 在实例控制台的“集成应用”页面，单击集成应用右侧的“应用授权管理”。
2. 在应用授权管理弹窗中，配置应用的授权信息。

   具体的授权配置操作和权限说明请参见配置ROMA Connect集成应用授权。

3. 完成后单击“确认”。

修改数据源配置

数据源的连接信息包括地址、账号和密码，为非资产数据，在导入集成资产后需要重新配置。

1. 在实例控制台的“数据源管理”页面，单击数据源右侧的“编辑”。
2. 在编辑数据源页面修改数据源的连接信息配置。
   • 对于资产恢复场景，修改密码配置。
   • 对于资产迁移场景，修改实际数据源的地址、用户名和密码配置。

   具体的数据源配置参数说明请参见接入数据源概述。

3. 修改完成后，单击“开始检测”，验证ROMA Connect和数据源的连通性。
4. 完成后单击“保存”。

修改API配置

API的环境类信息、控制策略信息、密钥类信息、API授权的黑白名单以及未发布到RELEASE环境的API，为非资产数据，在导入集成资产后需要重新配置。

• 环境类信息包括独立域名、环境变量、负载通道的云服务器信息、非默认的环境。
• 控制策略信息包括流量控制策略、访问控制策略、客户端访问控制策略和客户端配额策略。
• 密钥类信息包括客户端的AppCode、自定义后端的密码和证书类型配置值。

配置环境类信息

1. 绑定独立域名。
   1. 在实例控制台的“服务集成 APIC > API分组”页面，单击API分组的名称进入API运行页面。
   2. 在页面左上角选择“分组信息”页签，在“域名管理”下单击“绑定独立域名”，为API分组绑定独立域名。

      具体配置参数说明请参见为API分组绑定域名。

   3. 完成后单击“确定”。
2. 新建发布环境。
   1. 在实例控制台的“服务集成 APIC > API策略”页面，选择“环境管理”页签。
   2. 单击“创建环境”，新建API的发布环境。
   3. 完成后单击“确定”。
3. 添加环境变量。
   1. 在实例控制台的“服务集成 APIC > API分组”页面，单击API分组的名称进入API运行页面。
   2. 在页面左上角选择“分组信息”页签，在“环境变量”下的“环境”参数中选择要添加变量的环境，然后单击“添加环境变量”。

      具体配置参数说明请参见创建环境变量。

   3. 完成后单击“确定”。
4. 修改负载通道的服务器信息。
   1. 在实例控制台的“服务集成 APIC > API策略”页面，选择“负载通道”页签。
   2. 单击负载通道右侧的“编辑”。
   3. 在编辑负载通道页面，修改通道内服务器配置。
      • 对于“服务器添加方式”为“选择云服务器”的负载通道，单击“添加云服务器”，添加负载通道内的服务器。
      • 对于“服务器添加方式”为“指定服务器地址”的负载通道，根据实际使用的后端服务器，修改后端服务地址。

      具体配置参数说明请参见创建API的负载通道（可选）。

   4. 完成后单击“完成”。

配置控制策略信息

1. 配置流量控制策略。
   1. 在实例控制台的“服务集成 APIC > API策略”页面，选择“策略管理”页签。
   2. 单击“创建策略”，在选择策略类型弹窗中选择“传统策略 > 流量控制”。

      具体配置参数说明请参见创建流量控制策略。

   3. 完成后单击“确定”。
   4. 参考配置API的流量控制为API、应用或租户绑定流量控制策略。
2. 配置访问控制策略。
   1. 在实例控制台的“服务集成 APIC > API策略”页面，选择“策略管理”页签。
   2. 单击“创建策略”，在选择策略类型弹窗中选择“传统策略 > 访问控制”。

      具体配置参数说明请参见创建访问控制策略。

   3. 完成后单击“确定”。
   4. 参考配置API的访问控制为API绑定访问控制策略。
3. 配置凭据访问控制策略。
   1. 在实例控制台的“服务集成 APIC > 凭据管理”页面，选择“凭据管理”页签。
   2. 在凭据右侧单击“设置访问控制”，设置凭据的访问控制策略。

      具体配置参数说明请参见配置API的凭据访问控制。

   3. 完成后单击“确定”。
4. 配置凭据配额策略。
   1. 在实例控制台的“服务集成 APIC > 凭据管理”页面，选择“凭据配额策略”页签。
   2. 单击“创建凭据配额策略”，添加凭据配额策略。

      具体配置参数说明请参见创建凭据配额策略。

   3. 完成后单击“确定”。
   4. 参考配置API的凭据配额控制为凭据绑定配额策略。

配置密钥类信息

1. 添加简易认证凭据。
   1. 在实例控制台的“服务集成 APIC > 凭据管理”页面，选择“凭据管理”页签。
   2. 单击凭据的名称，进入凭据详情页面。
   3. 在“AppCodes”下，单击“添加AppCode”，为凭据添加AppCode。
   4. 完成后单击“确定”。
2. 配置自定义后端的密码和证书类型配置的值。
   1. 在实例控制台的“服务集成 APIC > 自定义后端”页面，选择“配置管理”页签。
   2. 单击配置右侧的“编辑”。
      • 密码类型配置需要修改密码的配置值。
      • 证书类型配置需要修改证书内容和私钥。
   3. 完成后单击“确定”。

修改API授权的黑白名单

仅“APP认证”类型的API支持进行授权配置。

1. 在实例控制台的“服务集成 APIC > API列表”页面，单击API右侧的“更多 > 授权”。
2. 在“授权历史”弹窗中，单击授权凭据右侧的“绿色通道 > 编辑”，根据实际需要修改黑白名单。
3. 完成后单击“确定”。

创建API并发布到非RELEASE环境

1. 在实例控制台的“服务集成 APIC > API列表”页面，单击“创建API”，根据实际需要新建API。

   具体配置过程和参数说明请参见通过APIC创建RESTful API。

2. 完成后参考发布APIC创建的API，把API发布到环境。

修改设备配置

设备信息和设备的规则信息为非资产数据，在导入集成资产后需要重新配置。可通过设备导入和规则导入功能，批量恢复或新建设备和规则信息。

1. （可选）准备设备列表和规则列表文件。

   从资产包所属的源实例获取导出的设备列表和规则列表文件。

2. 创建设备。
   1. 在实例控制台的“设备集成 LINK > 设备管理”页面。
      • 若获取到设备列表文件，则单击“导入设备”，通过导入设备列表文件创建设备。
      • 若未获取到设备列表文件，则单击“创建设备”，手动创建设备。

        具体配置参数说明请参见创建设备。

   2. 完成后，在页面的设备列表中可查看创建的设备。
3. 创建规则。
   1. 在实例控制台的“设备集成 LINK > 规则引擎”页面。
      • 若获取到规则列表文件，则单击“导入规则”，通过导入规则列表文件创建规则。
      • 若未获取到规则列表文件，则单击“创建规则”，手动创建规则。

        具体配置参数说明请参见创建规则。

   2. 完成后，在页面的规则列表中可查看创建的规则。

业务对接适配和验证

在ROMA Connect实例中完成集成资产的恢复或迁移后，周边对接的业务应用也需要完成相应的对接适配，才能正常处理业务。

与ROMA Connect对接的业务应用或设备，需要修改如下对接配置。

业务应用完成对接适配后，需验证业务是否正常。

• 业务应用调用API是否正常。
• 业务应用向ROMA Connect的Topic收发消息是否正常。
• 设备向ROMA Connect收发数据是否正常，规则引擎是否正常转发数据。