Visual Studio Code 扩展指南
使用 Visual Studio Code 的 Migration Toolkit for Applications 扩展来分析应用程序并解决迁移问题。
摘要
使开源包含更多
红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。有关更多详情,请参阅我们的首席技术官 Chris Wright 提供的消息。
第 1 章 简介
1.1. 关于 Microsoft Visual Studio Code 的 MTA 扩展
您可以使用 Microsoft Visual Studio Code 的 Migration Toolkit for Applications (MTA)扩展来迁移和现代化应用程序。
MTA 扩展利用自定义规则集来分析您的项目,标记源代码中的问题,提供指导来修复问题,并提供自动代码替换(如果可能)。
该 MTA 扩展还可与 Microsoft 托管的开发环境 Visual Studio Code 空间兼容。
1.2. 关于 Migration Toolkit for Applications
什么是 Migration Toolkit for Applications?
Migration Toolkit for Applications (MTA) 在 Red Hat OpenShift 的混合云环境中加速大规模应用程序现代化的过程。此解决方案会考虑整个迁移过程的详细情况,包括产品组合和应用程序级别的信息:库存、评估、分析和管理应用程序,以便更快地通过用户界面迁移到 OpenShift。
在 MTA 7.1 及更高版本中,当您将应用程序添加到应用程序清单中时,MTA 会自动创建并执行语言和技术发现任务。语言发现标识了应用中使用的编程语言。技术发现可识别技术,如企业 Java Bean (EJB)、Spring 等。然后,每个任务会为应用程序分配适当的标签,从而减少了手动标记应用程序的时间和工作量。
MTA 使用大量默认问题作为评估应用程序的基础,或者您可以创建自己的自定义问题,使您能够估算准备容器化应用程序所需的难度、时间和其他资源。您可以使用评估结果作为与利益相关者进行的讨论基础,以确定哪些应用程序可以被容器化,哪些需要大量的准备工作,哪些不适用于容器化。
MTA 会根据一个或多个规则集来对应用程序进行分析,并找出应用程序的哪些部分需要进行修改才可以对其进行现代化。
MTA 检查应用程序工件,包括项目源目录和应用程序存档,然后生成 HTML 报告突出显示需要更改的区域。
Migration Toolkit for Applications 如何简化迁移?
Migration Toolkit for Applications 会查找常见资源和在迁移应用程序时的已知问题。它为应用程序使用的技术提供了高级视图。
MTA 生成详细的报告,评估迁移或现代化路径。此报告可帮助您估算大型项目所需的工作量,并减少涉及的工作。
第 2 章 为 Visual Studio Code 安装 MTA 扩展
您可以为 Visual Studio Code (VS Code) 安装 MTA 扩展。
先决条件
以下是 Migration Toolkit for Applications (MTA)安装的先决条件:
已安装 Java 开发套件(JDK)。MTA 支持以下 JDK:
- OpenJDK 11
- OpenJDK 17
- Oracle JDK 11
- Oracle JDK 17
- Eclipse Temurin™ JDK 11
- Eclipse Temurin™ JDK 17
- 8 GB RAM
-
macOS 安装:
maxproc
的值必须是2048
或更高版本。
流程
设置环境变量
JAVA_HOME
:$ export JAVA_HOME=jdk11
- 在 VS Code 中,单击 Activity 栏中的 Extensions 图标,以打开 Extensions 视图。
-
在 Search 字段中输入
Migration Toolkit for Applications
。 选择 Migration Toolkit for Applications extension 并点 Install。
在活动栏中显示 MTA 扩展图标(
)。
第 3 章 使用 MTA 扩展分析项目
您可以通过创建正在运行的配置并运行分析,通过 MTA 扩展来分析您的项目。
3.1. MTA 扩展接口
Migration Toolkit for Applications (MTA) 扩展的接口旨在让您更轻松地查找信息并执行操作:
- 在左侧窗格中,您可以使用其顶部的报告图标查看名为 Analysis Results 的目录树。您可以点该图标在浏览器中打开 MTA 报告。报告图标下是树的其它元素:MTA 分析的应用程序、使用的规则集以及分析发现的问题。
- 在右窗格中,您可以配置分析。
- 在右下角的窗格中,您可以看到配置的设置,包括源、目标和高级选项。您可以在此窗格中查看分析的进度。分析完成后,您可以点 Open Report 按钮以打开 MTA 报告,该报告描述了迁移或现代化应用程序前需要解决的所有问题。如需更多信息,请参阅 CLI 指南中的检查报告。https://access.redhat.com/documentation/zh-cn/migration_toolkit_for_applications/7.2/html-single/cli_guide#review-reports_cli-guide
3.2. 配置运行配置
MTA 扩展接口
您可以配置多个运行配置,以针对您导入到 VS Code 的每个项目运行。
先决条件
-
已安装了
mta-cli
可执行文件。您可以从 mta 下载 下载mta-cli
可执行文件。https://developers.redhat.com/products/mta/download
流程
-
在 Extensions 视图中,点 Activity 栏中的 Migration Toolkit for Applications 图标(
)。
- 点 Migration Toolkit for Applications 旁边的 + (加号) 来添加运行配置。
完成以下配置字段:
- 名称 :为分析配置输入一个有意义的名称,或者接受默认设置。
-
cli: 输入到 cli 执行文件的路径。例如:
$HOME/mta-cli-7.2.0.GA-redhat/bin/mta-cli
。 输入 :点 Add 并执行以下操作之一来设置为您在 IDE 中打开的项目的路径:
- 输入输入文件或目录,然后按 Enter 键。
- 点 Open File Explorer,再选择目录。
- 目标 :选择一个或多个目标迁移路径。
右键单击运行配置并选择 运行。
分析完成后,您可以点 Open Report 按钮以打开 MTA 报告,该报告描述了迁移或现代化应用程序前需要解决的所有问题。如需更多信息,请参阅 CLI 指南中的检查报告。https://access.redhat.com/documentation/zh-cn/migration_toolkit_for_applications/7.2/html-single/cli_guide#review-reports_cli-guide
第 4 章 检查并解决迁移问题
您可以在左侧窗格中查看并解决由 MTA 扩展确定的迁移问题。
4.1. 检查问题
您可以使用 MTA 扩展图标根据问题的严重性确定优先级。
流程
- 选择左侧窗格中的运行配置目录。
- 展开其文件夹以查看为每个应用程序文件生成的 Hints。
- 选择一个 hint 来查看源代码。
- 右键点提示并选择 View Details 以查看规则 ID 和其他信息。
根据以下图标排序问题,这些图标会显示在每个提示旁边:
-
: 必须解决这个问题才能成功迁移。
-
: 此问题可能需要在迁移过程中解决。
-
4.2. 解决问题
您可以使用 hint 编辑文件代码来解决问题
4.2.1. 编辑文件代码
您可以编辑导入到 VS Code 的项目的文件。
流程
- 在左侧窗格中,在问题上单击鼠标右键,然后选择打开代码。
- 进行代码所需的任何更改,并保存文件。
- 可选: 在问题右键并选择 Mark as Complete 或 Delete。