Visual Studio Code 扩展指南

Migration Toolkit for Applications 6.0

使用 Visual Studio Code 的 Migration Toolkit for Applications 扩展来分析应用程序并解决迁移问题。

Red Hat Customer Content Services

摘要

本指南介绍了如何在 Red Hat OpenShift 的混合云环境中使用 Migration Toolkit for Applications 扩展来加快大型应用程序现代化工作。

使开源包含更多
复制链接

红帽承诺替换我们的代码、文档和网页属性中存在问题的语言。我们从这四个术语开始： master、slave、blacklist 和 whitelist。这些更改将在即将发行的几个发行本中逐渐实施。有关更多详情，请参阅我们的首席技术官 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 使用一个非常具体的问题调查，作为评估应用程序的基础，使您能够估计准备应用进行容器化所需的难度、时间和其他资源。您可以使用评估结果作为与利益相关者进行的讨论基础，以确定哪些应用程序可以被容器化，哪些需要大量的准备工作，哪些不适用于容器化。

MTA 会根据一个或多个规则集来对应用程序进行分析，并找出应用程序的哪些部分需要进行修改才可以对其进行现代化。

MTA 检查应用程序工件，包括项目源目录和应用程序存档，然后生成 HTML 报告突出显示需要更改的区域。MTA 支持许多迁移路径，包括：

升级至 Red Hat JBoss Enterprise Application Platform 的最新版本
从 Oracle WebLogic 或 IBM WebSphere Application Server 迁移到 Red Hat JBoss Enterprise Application Platform
容器化应用程序并使之成为云就绪
从 Java Spring Boot 迁移到 Quarkus
从 OpenJDK 8 升级到 OpenJDK 11
从 OpenJDK 11 升级到 OpenJDK 17
将 EAP Java applicatons 迁移到 Azure App Service
将 Spring Boot Java 应用程序迁移到 Azure 应用程序服务

有关用例和迁移路径的更多信息，请参阅适用于开发人员网页的 MTA。

Migration Toolkit for Applications 如何简化迁移？

Migration Toolkit for Applications 会查找常见资源和在迁移应用程序时的已知问题。它为应用程序使用的技术提供了高级视图。

MTA 生成详细的报告，评估迁移或现代化路径。此报告可帮助您估算大型项目所需的工作量，并减少涉及的工作。

第 2 章为 Visual Studio Code 安装 MTA 扩展
复制链接

您可以为 Visual Studio Code (VS Code) 安装 MTA 扩展。

先决条件

安装了 Java 开发套件 (JDK)。MTA 支持以下 JDK：
- OpenJDK 11
- Oracle JDK 11
8 GB RAM
macOS 安装： maxproc 的值必须是 2048 或更高版本。

流程

设置环境变量 JAVA_HOME ：
```
export JAVA_HOME=jdk11
```
```
$ export JAVA_HOME=jdk11
```
Copy to Clipboard Toggle word wrap
在 VS Code 中，单击 Activity 栏中的 Extensions 图标，以打开 Extensions 视图。
在 Search 字段中输入 Migration Toolkit for Applications。
选择 Migration Toolkit for Applications extension 并点 Install。
MTA 扩展图标显示在 Activity 栏中。

第 3 章使用 MTA 扩展分析项目
复制链接

您可以通过创建正在运行的配置并运行分析，通过 MTA 扩展来分析您的项目。

3.1. MTA 扩展接口
复制链接

Migration Toolkit for Applications (MTA) 扩展的接口旨在让您更轻松地查找信息并执行操作：

在左侧窗格中，您可以使用其顶部的报告图标查看名为 Analysis Results 的目录树。您可以点该图标在浏览器中打开 MTA 报告。报告图标下是树的其它元素：MTA 分析的应用程序、使用的规则集以及分析发现的问题。
在右窗格中，您可以配置分析。
在右下角的窗格中，您可以看到配置的设置，包括源、目标和高级选项。您可以在此窗格中查看分析的进度。分析完成后，您可以点 Open Report 按钮以打开 MTA 报告，该报告描述了迁移或现代化应用程序前需要解决的所有问题。如需更多信息，请参阅 CLI 指南中的检查报告。

图 3.1. MTA 扩展接口

3.2. 配置运行配置
复制链接

您可以配置多个运行配置，以针对您导入到 VS Code 的每个项目运行。

先决条件

已安装 windup-cli 可执行文件。您可以从 mta 下载下载 windup-cli 可执行文件。

流程

在 Extensions 视图中，点 Activity 栏中的 Migration Toolkit for Applications 图标( )。
点 Migration Toolkit for Applications 旁边的 + (加号) 来添加运行配置。
完成以下配置字段：
- 名称：为分析配置输入一个有意义的名称，或者接受默认设置。
- cli: 输入到 cli 执行文件的路径。例如：$HOME/mta-cli-6.0.1.GA-redhat/bin/windup-cli。
- 输入：点 Add 并执行以下操作之一来设置为您在 IDE 中打开的项目的路径：
  - 输入输入文件或目录，然后按 Enter 键。
  - 点 Open File Explorer，再选择目录。
- 目标：选择一个或多个目标迁移路径。
右键单击运行配置并选择运行。
分析完成后，您可以点 Open Report 按钮以打开 MTA 报告，该报告描述了迁移或现代化应用程序前需要解决的所有问题。如需更多信息，请参阅 CLI 指南中的检查报告。

第 4 章检查并解决迁移问题
复制链接

您可以在左侧窗格中查看并解决由 MTA 扩展确定的迁移问题。

4.1. 检查问题
复制链接

您可以使用 MTA 扩展图标根据问题的严重性确定优先级。您还可以查看哪些问题有快速修复自动代码替换。

流程

选择左侧窗格中的运行配置目录。
展开其文件夹以查看为每个应用程序文件生成的 Hints。
选择一个 hint 来查看源代码。
右键点提示并选择 View Details 以查看规则 ID 和其他信息。
根据以下图标排序问题，这些图标会显示在每个提示旁边：
- : 必须解决这个问题才能成功迁移。
- : 此问题可能需要在迁移过程中解决。
- : 这个问题对于迁移来说是可选的。此图标还可用于指明所有可用于此问题的快速修复。

4.2. 解决问题
复制链接

您可以通过执行以下操作之一解决问题：

使用 快速修复 自动代码替换
使用 hint 编辑文件代码

您可以使用 Delete 或 Mark as Complete 选项来跟踪已解决的问题。在下次分析包含它们的项目时，将再次分析标记为已删除或完成的文件。

4.2.1. 使用快速修复
复制链接

您可以使用快速修复自动代码替换来节省时间并确保解决重复性问题的一致性。

流程

在左侧窗格中，右键单击具有快速修复图标的问题，然后选择 Preview Quick Fix。
要接受推荐的修复，请再次单击问题并选择 Apply Quick Fix。
可选：在问题右键并选择 Mark as Complete 或 Delete。

4.2.2. 编辑文件代码
复制链接

您可以编辑导入到 VS Code 的项目的文件。

流程

在左侧窗格中，在问题上单击鼠标右键，然后选择打开代码。
进行代码所需的任何更改，并保存文件。
可选：在问题右键并选择 Mark as Complete 或 Delete。

法律通告
复制链接

The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.

Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.

Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

Visual Studio Code 扩展指南

使用 Visual Studio Code 的 Migration Toolkit for Applications 扩展来分析应用程序并解决迁移问题。

使开源包含更多
复制链接

第 1 章简介
复制链接

1.1. 关于 Microsoft Visual Studio Code 的 MTA 扩展
复制链接