资源迁移
目录
一、功能概述
二、使用指南
一、功能概述
资源迁移的主要目的在于，当用户进行服务升级、系统更新或更换服务器等操作时，能够快速、高效地恢复原有的系统运行环境与业务功能。通过将原有系统中的数据、配置、应用程序及相关资源完整地迁移至新的服务环境，资源迁移不仅最大限度地减少了因硬件更换或服务调整带来的业务中断时间，还能确保系统在新环境中保持一致性与稳定性。此外，良好的资源迁移策略还能提升系统的可维护性和扩展性，为后续的运维管理与技术演进提供有力支持。因此，资源迁移是保障业务连续性、提升系统灵活性和实现平滑过渡的关键环节。
资源迁移包括二十种资源类型：
- 用户：系统内的用户管理。
- 角色：管理系统内的角色。
- 机构：是指组织架构的管理单元。
- 门户：API门户（开发者门户），是一个统一的API管理平台，用于集中管理、发布、监控和治理企业的各类API接口。它为不同类型的应用系统提供标准化的API接入服务。
- 开发者：指门户管理的用户。
- 项目：对应服务提供方的的实际业务系统，归属于服务提供方的某个业务部门。
- 应用系统：在API门户中，应用系统对应服务调用方的的实际业务系统，归属于服务调用方的某个业务部门。
- 资源组：资源组是一种逻辑分组方式，用于将相关的资源（如数据连接、集成流程、数据服务、API等）组织在一起进行统一管理。
- 数据连接：TUS采用以数据为中心的命名方式，将所有与外部系统的交互统称为"数据连接"。从数据流动的角度来看：系统集成的目的是实现数据交换和共享，无论是SOAP、REST、数据库连接还是文件传输，最终都是为了交换数据。虽然连接的技术和协议不同，但都涉及数据传输，因此从功能性和最终目的 的角度，将各种类型的连接统一命名为"数据连接"。
- API：API（应用程序编程接口）是允许不同软件系统之间进行通信的标准化的接口，用于实现系统间的数据交换和功能调用。
- 集成流程：集成流程是一种连接不同应用系统、数据源和服务的方法，用于设计、构建和管理系统间的数据流和业务流程。它通过可视化的流程设计工具，将各种组件（如API调用、数据转换、业务规则等）进行编排。在TUS平台中，集成流程作为ESB（企业服务总线）的核心部分，负责系统间的消息处理和业务流转。
- 数据服务：数据服务是指将各种异构数据源和系统中的数据通过标准化接口进行封装、转换和发布的一种机制，使各种数据可以被统一访问和使用。
- 集群：当业务系统需要保证高可用性，或者需要将工作负载分布到多个节点，需要使用集群管理。集群分为网关集群和ESB集群。
- 负载均衡：用于在多个计算资源之间分配工作负载。其主要目的是优化资源使用、最大化吞吐量、最小化响应时间、避免过载，并提高系统的整体性能和可靠性。
- 告警规则：是指在系统、应用或服务运行过程中，根据预设的条件对监控数据进行实时分析，当数据满足某些异常或阈值条件时，自动触发告警通知相关人员或系统，以便及时发现和处理潜在问题。
- 流控规则：对系统的访问流量进行监控和限制，防止因流量过大导致系统资源耗尽或服务不可用。流控规则用于限制API、应用或者集成的访问频率。
- 访问控制规则：用于对系统资源的访问进行精细化管理，主要包括IP控制和时间控制两种类型。通过配置访问控制规则，可以实现对特定IP或特定时间段的访问权限进行允许或拒绝操作，从而提升系统的安全性和灵活性。
- HTTP/REST API数据处理规则：API网关系统中预置的标准化处理单元，用于实现特定的数据处理、转换或验证功能。每个功能组件专注于单一职责，可在API请求或响应的处理流程中被配置和组合，以实现复杂的业务逻辑。通过可视化界面进行配置，无需编写代码。
- HTTPS证书：HTTPS证书管理模块提供全面的HTTPS证书生命周期管理功能，用于建立API网关与后端服务之间的安全通信通道。通过强加密机制，确保API传输过程中的数据完整性和保密性。
- 标签：标签管理系统提供全面的标签创建与维护功能。支持标签数据的导出和导入，便于批量维护和跨系统迁移。可设置标签启用/停用状态，灵活控制标签在系统中的可见性。
二、使用指南
（一）资源导出
-
资源类型：显示当前可导出的资源类型，及每个类型的数据总数。
-
资源列表：资源分页数据，用于显示每个资源的详细信息。
-
导出选中：将选中资源类型的数据导出为zip文件。
-
导出全部：无需勾选，将全部资源数据导出为zip文件。
1.告警规则
-
导出说明
数据范围：当前登录用户所属租户的所有告警规则。
-
搜索：根据规则名称进行规则检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
2.HTTPS证书
-
导出说明
数据范围：当前登录用户所属租户的所有HTTPS证书。
-
搜索：根据证书名称进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
3.HTTP/REST API数据处理规则
-
导出说明
数据范围：当前登录用户所属租户的所有HTTP/REST API数据处理规则。
-
搜索：根据规则名称进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
4.项目
-
导出说明
数据范围：当前登录用户所属租户的所有项目数据。
-
搜索：根据项目名称和项目负责人进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
5.API
-
导出说明
数据范围：当前登录用户所拥有的API数据权限，各租户内的admin用户可以查看当前租户的所有API数据。如果存在多版本，则导出当前正在使用版本。
-
搜索：根据API名称和所属项目进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
6.数据服务
-
导出说明
数据范围：当前登录用户所拥有的数据服务的数据权限，各租户内的admin用户可以查看当前租户的所有数据服务的数据。如果存在多版本，则导出所有版本。
-
搜索：根据数据服务名称和所属项目进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
7.应用系统
-
导出说明
数据范围：当前登录用户所属租户的所有应用系统数据。
-
搜索：根据应用名称和应用系统负责人进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
8.用户
-
导出说明
数据范围：当前登录用户所属租户的所有用户数据。
-
搜索：根据用户名和用户昵称进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
9.数据连接
-
导出说明
数据范围：当前登录用户所拥有的数据连接的数据权限，各租户内的admin用户可以查看当前租户的所有数据连接数据。如果存在多版本，则导出当前正在使用版本。
-
搜索：根据连接名称和所属项目进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
10.门户
-
导出说明
数据范围：当前登录用户所属租户的所有门户数据。
-
搜索：根据门户名称进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
11.角色
-
导出说明
数据范围：当前登录用户所属租户的所有角色数据。
-
搜索：根据角色名称进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
12.机构
-
导出说明
数据范围：当前登录用户所属租户的所有机构数据。
-
搜索：根据机构名称和组织机构代码进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
13.资源组
-
导出说明
数据范围：当前登录用户所属租户的所有资源组。
-
搜索：根据资源组名称进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
14.集成流
-
导出说明
数据范围：当前登录用户所拥有的集成流数据权限，各租户内的admin用户可以查看当前租户的所有集成流数据。如果存在多版本，则导出所有版本。
-
搜索：根据集成流名称和项目名称进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
15.负载均衡
-
导出说明
数据范围：当前登录用户所属租户的所有负载均衡数据。
-
搜索：根据负载均衡名称进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
16.流控规则
-
导出说明
数据范围：当前登录用户所属租户的所有流控规则。
-
搜索：根据规则名称进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
17.标签
-
导出说明
数据范围：当前登录用户所属租户的所有标签数据。
-
搜索：根据标签名称进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
18.开发者
-
导出说明
数据范围：当前登录用户所属租户的所有开发者数据。
-
搜索：根据用户邮箱、公司名、用户名进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
19.集群
-
导出说明
数据范围：当前登录用户所属租户的所有集群数据。
-
搜索：根据集群名称进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
20.访问控制规则
-
导出说明
数据范围：当前登录用户所属租户的所有访问控制规则。
-
搜索：根据规则名称进行检索。
-
重置：清空搜索条件，并将分页数据置为初始状态。
（二）资源导入
- 搜索：可根据操作人和导入时间检索导入历史。
- 重置：清空搜索条件，并将分页数据置为初始状态。
- 资源导入：将导出的资源数据导入到当前租户。
- 导入历史列表：资源导入分页数据，记录导入的资源数据及结果。
1.导入说明：
导入新系统时，需要在新系统“租户管理”功能中创建对应租户后，使用对应的租户登录后导入资源数据。程序会根据登录用户获取租户信息。
点击或拖拽导出的资源文件，严格校验zip格式。点击下一步进入资源预览数据页。
在预览数据页可查看导入的资源数据，点击左侧资源类型切换不同的资源数据详情。
- 取消： 取消当前上传操作。
- 上一步： 返回资源上传页。
- 导入： 进行导入操作。 资源导入不支持选择导入，程序会根据上传资源文件中包含的所有资源类型数据进行解析并导入。
2.导入规则：
无特殊说明的资源类型，导入时，在数据解析阶段会进行数据校验，根据不同的条件会被标记为以下两种状态，并在数据预览中展示：
- 新建： 当所有校验全部通过之后，当条数据会被标记为NEW，导入时会按正常逻辑插入数据。
- 无效： 如果数据的id在数据库中已存在，当条数据会被标记为INVALID，导入时会被直接放入错误列表。
特别说明：
数据连接： 导入时，在数据解析阶段会进行数据校验，根据不同的条件会被标记为以下三种状态，并在数据预览中展示。
- 新建： 当所有校验全部通过之后，当条数据会被标记为NEW，导入时会按正常逻辑插入数据。
- 更新： 当前系统中存在名称相同且未启动过的一个数据连接时，当条数据会被标记为UPDATE；导入后会覆盖系统中已存在的同名数据连接。
- 变更： 当前系统中存在名称相同且已启动过的一个数据连接时，当条数据会被标记为CHANGE；导入后会为系统中已存在的同名数据连接增加一个状态为草稿且版本号为当前的最大版本号+1的版本。
API： 导入时，在数据解析阶段会进行数据校验，根据不同的条件会被标记为以下四种状态，并在数据预览中展示。
- 新建： 当所有校验全部通过之后，当条数据会被标记为NEW，导入时会按正常逻辑插入数据。
- 更新： 当前系统中存在名称相同且未部署过的一个API时，当条数据会被标记为UPDATE；导入后会覆盖系统中已存在的同名API。
- 变更： 当前系统中存在名称相同且已部署过的一个API时(不含已卸载)，当条数据会被标记为CHANGE；导入后会为系统中已存在的同名API增加一个状态为变更待审批且版本号为当前的最大版本号+1的版本。
- 路径重复： 当前系统中存在请求路径相同且名称不同的一个API时，当条数据会被标记为PATH_REPETITION，导入时会被直接放入错误列表。可以于错误列表中进行修改请求路径后重试导入。
集成流、数据服务： 导入时，在数据解析阶段会进行数据校验，根据不同的条件会被标记为以下四种状态，并在数据预览中展示。
-
新建： 当所有校验全部通过之后，当条数据会被标记为NEW，导入时会按正常逻辑插入数据。
-
更新： 当前数据在数据库中存在相同的唯一标识的数据时，当条数据会被标记为UPDATE。
导入时被标记为UPDATE的数据，如果已存在的数据未部署，则直接将当条数据覆盖导入，即当条导入数据的属性会将已存在于数据库中的数据的属性覆盖；
如果已存在数据已部署，则会进行变更导入，即将现有数据库中的已存在的相同唯一标识的数据的最大版本+1后作为最新版本导入。
-
路径重复： 当前导入数据的第一个步骤中如果存在请求路径参数，并且该参数和数据库中已存在的数据中的路径参数相同，则当条数据会被标记为PATH_REPETITION （匹配规则为前缀包含匹配），导入时会被直接放入错误列表。可以于错误列表中进行修改PATH后重试导入。
-
无效： 当导入的数据缺乏必要参数、缺少流程、步骤少于两个、批量导入中存在重复id的数据，连接校验失败的数据，流程存在已变更未部署版本的数据等时，当条数据会被标记为INVALID，导入时会被直接放入错误列表。 特别注意1： 如果集成流导入时步骤中存在数据连接，导入时会进行数据连接校验，如果数据连接已经在当前租户中存在（判断依据为：数据连接名称+数据连接类型与当前租户已存在的数据连接一致，则认为该数据连接已存在），则导入时会沿用已经存在的数据连接的属性。
-
场景说明： 一个包含数据连接步骤的集成流被导入后，这时数据连接已经被创建，如果在原流程中修改了数据连接属性，这时候再将流程导出，再进行导入时，因为数据连接已存在，这时二次导入的集成流会沿用之前导入的数据连接属性，新修改的数据连接属性将不会被更新。
-
解决方法： 如果数据连接修改后，不要直接导出相关的集成流再经行导入，正确的做法是：将修改后的数据连接属性直接导出，并在迁移环境中进行导入。修改后的数据连接属性将会按照数据连接导规则进行处理。 特别注意2： 集成流导入后会保持和原业务系统中相同的工作状态，虽然状态为启动，但是实际并没有部署，需要手动点击部署。
（三）失败列表
失败重试主要应对于导入时意外原因导致导入失败的资源进行重试。
- 搜索：可资源类型、资源名称、上传路径进行检索。
- 重置：清空搜索条件，并将分页数据置为初始状态。
- 批量重试：可以选择不同的批次上传的错误数据进行重试。
1.错误类型说明：
- 运行中异常或者未标注错误类型显示为“-”： 导入时意外原因或在运行过程中未通过前置校验的而导致失败的数据。
- 无效： 在上传解析过程中未通过前置校验的错误数据。
- 路径重复： 只有数据连接、API、集成流、数据服务的资源导入时，发生路径重复时，会被标记为路径重复，其余资源类型无此错误类型。关于路径重复的定义请查看导入规则中各资源的描述。
2.重试规则：
- 运行中异常或者未标注错误类型显示为“-”： 对于此类错误数据，可进行重试，重试时，程序会重新进行数据解析和校验，如果重新解析和校验成功，则数据会重新导入，导入成功后，将该条数据从错误列表中移除；如果失败，则数据会重新放入错误列表。
- 无效： 所有被标记为无效的数据，全部为前置校验未通过的数据，此类型数据重试时直接放入错误列表，不执行重试逻辑。
- 路径重复： 对于路径重复的数据，点击重试时会弹出修改PATH的对话框，用户可修改PATH并通过校验后重试导入，未修改PATH时，不允许重试导入。 数据连接、API、集成流、数据服重试成功的数据，项目为默认项目，资源组为对应类型的公共资源组。
（四）最佳实践
资源迁移功能提供一键导出，一键导入功能，用户可一键导出当前租户下所有资源，一键导入到新环境中。但是需注意以下几点：
1.对于数据连接、API、集成流、数据服务，导出时，如果登录用户为非当前租户的admin用户，则会根据拥有的数据权限获取导出数据。当前租户的admin用户可获取所有数据。
2.对于所有资源类型，导入时，租户默认为当前登录用户的租户，不可选择其他租户。
3.对于数据连接、API、集成流、数据服务，导入时，会有大量的查询和计算逻辑，当数据量过大时，可能会导致导入失败，请根据实际情况进行选择。
综上所述，整体环境的资源迁移到新环境时，当数据连接、API、集成流、数据服务数据量较大时，为了减少数据导入时失败的概率，建议将数据连接、API、集成流、数据服务，进行单独迁移。