本指南适用于希望使用 Migration Toolkit for Runtimes (MTR) 迁移 Java 应用程序或其他组件的工程师、顾问和其他组件。它描述了如何安装和运行 Maven 插件，检查生成的报告，并利用额外的功能。

什么是 Migration Toolkit for Runtimes?

Migration Toolkit for Runtimes (MTR) 是一个可扩展、可自定义的基于规则的工具，简化了 Java 应用程序的迁移和现代化。 MTR 检查应用程序工件，包括项目源目录和应用程序存档，然后生成 HTML 报告突出显示需要更改的区域。MTR 支持许多迁移路径，包括以下示例： 升级至 Red Hat JBoss Enterprise Application Platform 的最新版本 从 Oracle WebLogic 或 IBM WebSphere Application Server 迁移到 Red Hat JBoss Enterprise Application Platform 容器化应用程序并使之成为云就绪 从 Java Spring Boot 迁移到 Quarkus 从 Oracle JDK 更新至 OpenJDK 从 OpenJDK 8 升级到 OpenJDK 11 从 OpenJDK11 升级到 OpenJDK 17 将 EAP Java applicatons 迁移到 Azure 将 Spring Boot Java 应用程序迁移到 Azure 有关用例和迁移路径的更多信息，请参阅 开发人员网页的 MTR 。

Migration Toolkit for Runtimes 如何简化迁移？

Migration Toolkit for Runtimes 会查找常见资源和在迁移应用程序时的已知问题。它为应用程序使用的技术提供了高级视图。 MTR 生成详细的报告，评估迁移或现代化路径。此报告可帮助您估算大型项目所需的工作量，并减少涉及的工作。

如何了解更多信息？

请参阅 Migration Toolkit for Runtimes 简介 ，了解有关 Migration Toolkit for Runtimes 中的功能、支持的配置、系统要求以及可用工具的更多信息。

Migration Toolkit for Runtimes 的 Maven 插件集成到 Maven 构建流程中，允许开发人员每次执行源代码时持续评估迁移和现代化工作。它提供了大量报告，突出显示分析结果，专为希望更新每个构建的开发人员而设计。

Maven 插件通过包含对应用的 pom.xml 文件中的插件的引用来运行。构建应用程序时，运行 Maven 插件并生成报告进行分析。 安装了 Java 开发套件 (JDK)。MTR 支持以下 JDK： OpenJDK 11 Oracle JDK 11 8 GB RAM macOS 安装： maxproc 的值必须是 2048 或更高版本。 将以下 <plugin> 加入到应用程序的 pom.xml 文件：

[...]
<plugin>
    <groupId>org.jboss.windup.plugin</groupId>
    <artifactId>mtr-maven-plugin</artifactId>
    <version>1.0.2.GA-redhat-00001</version>
    <executions>
        <execution>
            <id>run-windup</id>
            <phase>package</phase>
            <goals>
                <goal>windup</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <target>eap:7</target> 1
    </configuration>
</plugin>
[...]

要在带有多个模块的项目中使用 Maven 插件，请将配置放在父的 pom.xml 中。在执行 Maven 插件期间，将生成单个报告，其中包含父模块和任何子模块的分析。 强烈建议在多模块项目中将 inherited 设置为 false；否则，当每个子编译时，Maven 插件将会在编译每个子时运行，从而导致对子模块进行多个 Maven 插件执行。将 inherited 设置为 false 时，每个项目中都分析一次，并大大减少了启动时间。 若要在带有多个模块的项目中运行 Maven 插件，请执行以下步骤： 在父项目的 pom.xml 中包含以下插件。以下是父模块的 pom.xml 示例。

<plugin>
    <groupId>org.jboss.windup.plugin</groupId>
    <artifactId>mtr-maven-plugin</artifactId>
    <version>1.0.2.GA-redhat-00001</version>
    <inherited>false</inherited>
    <executions>
        <execution>
            <id>run-windup</id>
            <phase>package</phase>
            <goals>
                <goal>windup</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <input>${project.basedir}</input>
        <target>eap:7</target> 1
        <windupHome>>/PATH/TO/CLI/<</windupHome>
    </configuration>
</plugin>

当您运行 Migration Toolkit for Runtimes 时，报告会在使用 pom.xml 中的 outputDirectory 参数指定的 OUTPUT_REPORT_DIRECTORY 中生成。在构建完成后，您会在构建日志中看到以下消息。

Windup report created: <OUTPUT_REPORT_DIRECTORY>/index.html

输出目录包含以下文件和子目录：

<OUTPUT_REPORT_DIRECTORY>/
├── index.html          // Landing page for the report
├── <EXPORT_FILE>.csv     // Optional export of data in CSV format
├── graph/              // Generated graphs used for indexing
├── reports/            // Generated HTML reports
├── stats/              // Performance statistics

有关 MTR 报告和使用方法评估迁移或现代化工作的信息，请参阅 MTR CLI 指南的 审查报告 部分。

要将报告导出为 CSV 文件，请运行将 exportCSV 参数设置为 true 的 MTR。 在由分析的每个应用程序的 --output 参数指定的目录中创建一个 CSV 文件。所有发现的问题（跨越所有分析的应用程序）都包含在 AllIssues.csv 文件中。 CSV 文件导出到由 outputDirectory 参数指定的目录中。

CSV 格式化输出文件包含以下数据字段：