用户界面指南

流程

1. 在 OpenShift Container Platform web 控制台中，点 Operators → OperatorHub。
2. 使用 Filter by keyword 字段搜索 MTA。
3. 点 Migration Toolkit for Applications Operator，然后点 Install。
4. 在 Install Operator 页面中，点 Install。
5. 点 Operators → Installed Operators 来验证 MTA Operator 是否出现在 openshift-mta 项目中，状态为 Succeeded。
6. 点 MTA Operator。

7. 在 Provided APIs 下，找到 Tackle，然后点 Create Instance。

   Create Tackle 窗口在 Form 视图中打开。

8. 查看 CR 设置。默认的选择应该可以被接受，但请确保检查系统对存储、内存和内核的要求。

9. 要直接使用 YAML 文件，请点击 YAML 视图，并查看 YAML 文件的 spec 部分中列出的 CR 设置。

   这个表中列出了最常用的 CR 设置：

   Expand

   表 3.2. Tackle CR 设置

   Name	默认	描述
   cache_data_volume_size	100 GiB	为缓存卷请求的大小；当 rwx_supported=false 时会被忽略
   cache_storage_class	默认存储类	用于缓存卷的存储类 ; 当 rwx_supported=false 时会被忽略
   feature_auth_required	True	用于指明是否需要 keycloak 授权（单用户/"noauth"）的标记
   feature_isolate_namespace	True	指定是否启用使用网络策略进行命名空间隔离的标志
   hub_database_volume_size	5 GiB	为 Hub 数据库卷请求的大小
   hub_bucket_volume_size	100 GiB	为 Hub 存储桶卷请求的大小
   hub_bucket_storage_class	默认存储类	用于存储桶卷的存储类
   keycloak_database_data_volume_size	1 GiB	为 Keycloak 数据库卷请求的大小
   pathfinder_database_data_volume_size	1 GiB	为 Pathfinder 数据库卷请求的大小
   maven_data_volume_size	100 GiB	为 Maven m2 缓存卷请求的大小；在 MTA 6.0.1 中弃用
   rwx_storage_class	不适用	为 Tackle RWX 卷请求的存储类；在 MTA 6.0.1 中弃用
   rwx_supported	True	指明集群存储是否支持 RWX 模式的标记
   rwo_storage_class	不适用	为 Tackle RW0 卷请求的存储类
   rhsso_external_access	False	指明是否创建了专用路由来访问 MTA 受管 RHSSO 实例的标志
   windup_container_limits_cpu	1	pod 允许使用的最大 CPU 数量
   windup_container_limits_memory	6Gi	pod 允许使用的最大内存量。如果 pod 显示 OOMKilled 错误，您可以增加这个限制。
   windup_container_requests_cpu	1	pod 需要运行的最少 CPU 数量
   windup_container_requests_memory	4Gi	pod 需要运行的最小内存量

   Show more

   YAML 文件示例

   kind: Tackle
   apiVersion: tackle.konveyor.io/v1alpha1
   metadata:
     name: mta
     namespace: openshift-mta
   spec:
     hub_bucket_volume_size: "25Gi"
     maven_data_volume_size: "25Gi"
     rwx_supported: "false"

   Copy to Clipboard Toggle word wrap

10. 如果需要，编辑 CR 设置，然后点 Create。
11. 在管理视图中，点 Workloads → Pods 来验证 MTA Pod 是否正在运行。
12. 使用 OpenShift 中的 mta-ui 应用公开的路由，从浏览器访问用户界面。

13. 使用以下凭证登录：

    • 用户名 ：admin
    • 密码 ： Passw0rd!
14. 出现提示时，创建新密码。

流程

1. 在 Administration 视图中，点 Proxy。
2. 使用 HTTP 代理或 HTTPS 代理以启用代理连接。

3. 输入以下信息：

   • 代理主机
   • 代理端口
4. 可选：切换 HTTP 代理凭证 或 HTTPS 代理凭证来启用身份验证。
5. 点 Insert。

1. 创建 stakeholder 组
2. 创建作业功能
3. 创建利益相关者

1. 创建标签类别
2. 创建标签

流程

1. 在 Migration 视图中，点 Application inventory。

2. 选择您要评估的应用程序。

   注意

   一次只能评估一个应用程序。

3. 点 Assess。

4. 从列表中选择 Stakeholders 和 Stakeholder groups 来跟踪为未来参考提供评估的人员。

   注意

   您可以在 Migration 视图的 Controls 屏幕中添加 Stakeholder Groups 或 Stakeholders。

5. 点 Next。
6. 回答每个问题，然后单击下一步。
7. 点 Save and Review 查看评估。

流程

1. 在 Migration 视图中，点 Application inventory。

2. 选择您要查看的应用程序。

   注意

   一次只能检查一个应用程序。

3. 点 Review。
4. 从列表中选择 Proposed action 和 Effort estimate。设置 Business criticality 和 Work priority。

5. 点 Submit review。

   Review 中的字段现在在 Application details 页面中填充。

流程

1. 在 Migration 视图中，点 Application inventory。
2. 点 Analysis 选项卡。
3. 选择您要分析的应用程序。
4. 检查分配给应用程序的凭据。
5. 点 Analyze。

6. 从列表中选择 Analysis mode。有效选项有：

   • 二进制。
   • 源代码。
   • 源代码和依赖项。
   • 上传本地二进制文件。只有在分析单个应用程序时会出现这个选项。
7. 如果选择了 Upload a local binary，会打开一个窗口，您会被提示 Upload a local binary。将文件拖放到提供的区域，或者点 Upload，然后选择要上传的文件。
8. 点 Next。

9. 为分析选择一个或多个目标选项：

   • 应用程序服务器迁移到：

     • JBoss EAP 7
     • JBoss EAP 6
   • 容器化
   • Quarkus
   • OracleJDK 到 OpenJDK

   • OpenJDK - 升级到以下 JDK 版本之一：

     • OpenJDK 11
     • OpenJDK 17
   • Linux - 确保没有将 Microsoft Windows 路径硬编码到应用程序中
   • Jakarta EE 9 - 从 Java EE 8 迁移到 Jakarta EE 9
   • Spring Boot on Red Hat Runtimes
   • Open Liberty
   • Camel - 从 Apache Camel 2 迁移到 Apache Camel 3

   • Azure

     • Azure 应用程序服务
10. 点 Next。

11. 选择以下范围选项之一以更好地关注分析：

    • 仅限应用和内部依赖项。
    • 应用程序及所有依赖项，包括已知的开源库。
    • 选择要手动分析的软件包列表。如果选择了这个选项，请键入文件名并点添加。
    • 排除软件包。如果选择了这个选项，请输入软件包名称的名称并点 Add。
12. 点 Next。

13. 在 Advanced 中，您可以将额外的自定义规则附加到分析中。选择 Manual 或 Repository。

    注意

    如果您已将迁移目标附加到分析中，附加自定义规则是可选的。如果您还没有附加任何迁移目标，则必须附加规则。

    • 在 Manual 模式中，点 Add Rules。然后拖放相关文件，或从其目录中选择这些文件并点 Add。
    • 在 Repository 模式中，您可以从 Git 或 Subversion 存储库添加规则文件。

14. 如果需要，设置以下选项：

    • 目标
    • 源
    • 排除的规则标签：没有处理这些标签的规则。根据需要添加或删除。
    • 启用事务报告：选择复选框来生成 DIVA 报告，该报告显示调用堆栈，该堆栈对关系数据库表执行操作。

    • 启用自动标记 ：选择复选框来自动将标签附加到应用程序。默认选择此复选框。

      注意

      事务报告只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

      注意

      请注意，只有在运行分析后才会显示自动附加的标签。

      您可以手动将标签附加到应用程序，而不是启用自动标记或额外启用。

      注意

      分析引擎将标准规则用于一组全面的迁移目标，但如果目标未包含或是自定义框架，则可以添加自定义规则。验证自定义规则文件。

15. 点 Next。
16. 在 Review 中，验证分析参数。

17. 点 Run。

    当 MTA 下载要执行的容器，镜像分析状态会变为 Scheduled。下载镜像后，状态会更改为 In-progress。

    注意

    分析需要几分钟的时间根据应用程序的大小以及集群容量和资源来运行。

    提示

    MTA 依赖于 Kubernetes 调度功能来确定基于集群容量创建多少分析器实例。如果选择多个应用程序进行分析，则一次只能置备一个分析器。使用更多集群容量时，可以并行执行更多分析过程。

18. 分析完成后，您可以点 Report 链接来查看分析结果。

流程

1. 在 Administration 视图中，点 Custom migration targets。
2. 点 Create new。
3. 填写目标的名称和描述。
4. 在 Image 部分中，上传目标图标的图形文件。该文件可以是 PNG 或 JPEG 格式，最多为 1 MB。如果您没有上传任何文件，则使用默认图标。

5. 在 Custom rules 部分中，从存储库中选择 Upload manually 或 Retrieve。

   • 如果您选择了 Upload manually，请上传或拖放本地驱动器中所需的规则文件。

   • 如果您选择了 Retrieve from a repository，如下所示进行：

     1. 选择 Git 或 Subversion。
     2. 填写 Source repository、Branch 和 Root path。
     3. 如果存储库需要凭证，请在 Associated credentials 字段中输入它们。

6. 点 Create。

   新迁移目标会出现在 Custom migration targets 页面中。现在，非管理员用户可在 Migration 视图中使用。

流程

1. 在 Migration 视图中，点 Application inventory。
2. 通过完成的分析来扩展应用程序。
3. 点 Reports。
4. 点 dependencies 或 source 链接。
5. 点选项卡查看报告。

流程

1. 在 Migration 视图中，点 Application Inventory。
2. 点 Create new。

3. 输入以下信息或从列表中选择：

   • Name
   • Description（可选）
   • 业务服务（可选）
   • 标签（可选；可选，一个或多个）
   • 注释（可选）
4. 点 Source Code 左侧的箭头。

5. 输入以下信息或从列表中选择：

   • 仓库类型
   • 源存储库
   • 分支
   • 根路径
6. 点 Binary 左侧的箭头。

7. 输入以下信息：

   • 组
   • 工件
   • Version
   • 打包
8. 点 Create。

流程

1. 在 Migration 视图中，点 Application inventory。
2. 点 Analysis 选项卡。
3. 点 分析 右侧的 Options 菜单 并选择 Manage credentials。
4. 从 Source credentials 列表中选择一个凭据，再从 Maven 设置列表中选择一个凭据。
5. 点 Save。

流程

1. 检查导入文件，以确保它包含所有必需的信息（以所需格式表示）。
2. 在 Migration 视图中，点 Application Inventory。
3. 点 Review 右侧的 Options 菜单 。
4. 点 Import。
5. 浏览到所需文件，然后点 打开。
6. 可选： 选择 启用自动创建缺少的实体。默认情况下会选择这个选项。
7. 验证导入已完成，并检查接受或拒绝的行数。

8. 点复选框左侧的箭头来查看导入的应用程序。

   重要

   可接受的行可能与应用程序清单列表中的应用程序数量不匹配，因为某些行是依赖项。要验证，检查 CSV 文件的 Record Type 列，以了解定义为 1 且依赖项定义为 2 的应用程序。

流程

1. 在 Migration 视图中，点 Application inventory。
2. 点 Review 右侧的 Options 菜单 。
3. 点 Manage import 以打开 Application import 页面。
4. 点 Import 右侧的 Options 菜单 ，然后点 Download CSV 模板。