红帽全球峰会2.2. 运行 CLI
您可以针对您的应用程序运行 MTR。
流程
-
打开一个终端，进入到
<MTR_HOME>/bin/目录。 执行
windup-cli脚本，或为 Windows 执行windup-cli.bat，并指定适当的参数：./windup-cli --input /path/to/jee-example-app-1.0.0.ear \ --output /path/to/output --source weblogic --target eap:6 \ --packages com.acme org.apache$ ./windup-cli --input /path/to/jee-example-app-1.0.0.ear \ --output /path/to/output --source weblogic --target eap:6 \ --packages com.acme org.apacheCopy to Clipboard Copied! Toggle word wrap Toggle overflow -
--input：要评估的应用程序。 -
--output：所生成的报告的输出目录。 -
--source：应用程序迁移的源技术。 -
--target：应用程序迁移的目标技术。 -
--packages：要评估的软件包。强烈建议您使用这个参数提高性能。
-
- 访问报告。
2.2.1. MTR 命令示例
在应用程序存档中运行 MTR
以下命令分析 jee-example-app-1.0.0.ear 示例 EAR 存档从 JBoss EAP 5 迁移到 JBoss EAP 7 的 com.acme 和 org.apache 软件包：
<MTR_HOME>/bin/windup-cli \
$ <MTR_HOME>/bin/windup-cli \
--input /path/to/jee-example-app-1.0.0.ear \
--output /path/to/report-output/ --source eap:5 --target eap:7 \
--packages com.acme org.apache在源代码中运行 MTR
以下命令分析 seam-booking-5.2 示例源代码中的 org.jboss.seam 软件包，以迁移到 JBoss EAP 6。
<MTR_HOME>/bin/windup-cli --sourceMode --input /path/to/seam-booking-5.2/ \
$ <MTR_HOME>/bin/windup-cli --sourceMode --input /path/to/seam-booking-5.2/ \
--output /path/to/report-output/ --target eap:6 --packages org.jboss.seam运行云就绪规则
以下命令分析 jee-example-app-1.0.0.ear 示例 EAR 归档（用于迁移到 JBoss EAP 7）的 com.acme 和 org.apache 软件包。它还评估了云就绪情况：
<MTR_HOME>/windup-cli --input /path/to/jee-example-app-1.0.0.ear \
$ <MTR_HOME>/windup-cli --input /path/to/jee-example-app-1.0.0.ear \
--output /path/to/report-output/ \
--target eap:7 --target cloud-readiness --packages com.acme org.apache覆盖 MTR 属性
要覆盖默认的 Fernflower decompiler，请在命令行上传递 -Dwindup.decompiler 参数。例如，要使用 Procyon decompiler，请使用以下语法：
<MTR_HOME>/bin/windup-cli -Dwindup.decompiler=procyon \
--input <INPUT_ARCHIVE_OR_DIRECTORY> --output <OUTPUT_REPORT_DIRECTORY> \
--target <TARGET_TECHNOLOGY> --packages <PACKAGE_1> <PACKAGE_2>
$ <MTR_HOME>/bin/windup-cli -Dwindup.decompiler=procyon \
--input <INPUT_ARCHIVE_OR_DIRECTORY> --output <OUTPUT_REPORT_DIRECTORY> \
--target <TARGET_TECHNOLOGY> --packages <PACKAGE_1> <PACKAGE_2>2.2.2. MTR CLI Bash 补全
MTR CLI 提供了一个选项，可为 Linux 系统启用 Bash 补全功能，允许在输入命令时按 Tab 键自动完成 MTR 命令行参数。例如，在启用 Bash 完成时，输入以下内容会显示可用参数的列表：
<MTR_HOME>/bin/windup-cli [TAB]
$ <MTR_HOME>/bin/windup-cli [TAB]启用 Bash 完成
要为当前 shell 启用 Bash 完成，请执行以下命令：
source <MTR_HOME>/bash-completion/windup-cli
$ source <MTR_HOME>/bash-completion/windup-cli启用持久性 Bash 完成
以下命令允许 Bash 完成在重启后保留：
要在系统重启后为特定用户启用 Bash 完成，请在该用户的
~/.bashrc文件中包括以下行：source <MTR_HOME>/bash-completion/windup-cli
source <MTR_HOME>/bash-completion/windup-cliCopy to Clipboard Copied! Toggle word wrap Toggle overflow 要为系统重启后所有用户启用 Bash 完成，请以 root 用户身份将运行时 CLI 的 Migration Toolkit for Runtimes CLI completion 文件复制到
/etc/bash_completion.d/目录中。cp <MTR_HOME>/bash-completion/windup-cli /etc/bash_completion.d/
# cp <MTR_HOME>/bash-completion/windup-cli /etc/bash_completion.d/Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.2.3. 访问 MTR 帮助
要查看 windup-cli 命令可用参数的完整列表，请打开终端，进入 <MTR_HOME> 目录，并执行以下命令：
<MTR_HOME>/bin/windup-cli --help
$ <MTR_HOME>/bin/windup-cli --help2.2.4. 使用 OpenRewrite methods
OpenRewrite method 支持仅作为技术预览提供。技术预览功能不包括在红帽生产服务级别协议（SLA）中，且其功能可能并不完善。因此，红帽不建议在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。
如需有关技术预览功能支持范围 的信息，请参阅红帽客户门户网站中的技术预览功能支持范围。
您可以通过 MTR CLI 使用 OpenRewrite 方法来重构 Java 应用程序的源代码。
例如，OpenRewrite method org.jboss.windup.JavaxToJakarta 将导入的 javax 软件包重命名为其对于的 jakarta。
流程
运行
windup-cli，指定方法名称、配置文件的路径和应用程序：./windup-cli --openrewrite --input </path/to/source/project> \ "-Drewrite.configLocation=<path/to/rewrite.yaml>" \ "-DactiveRecipes=<recipe_name>" --goal dryRun
$ ./windup-cli --openrewrite --input </path/to/source/project> \ "-Drewrite.configLocation=<path/to/rewrite.yaml>" \ "-DactiveRecipes=<recipe_name>" --goal dryRunCopy to Clipboard Copied! Toggle word wrap Toggle overflow -
"-DactiveRecipes=<recipe name>": 指定 OpenRewrite recipe，例如org.jboss.windup.JavaxToJakarta。 -
--input：指定要重构的应用程序。该应用必须是包含 Maven 项目对象模型(POM) XML 文件pom.xml的源代码项目的顶部。 -
-Drewrite.configLocation=<path/to/rewrite.yaml>: 要使用的rewrite.yaml配置文件的位置。提供的rewrite.yaml配置文件位于<MTR_HOME>/rules/openrewrite子文件夹中，例如" -Drewrite.configLocation=<MTR_HOME>/rules/openrewrite/jakarta/javax/imports/rewrite.yaml"。 "-DactiveRecipes=<recipe name>": 指定 OpenRewrite recipe，例如org.jboss.windup.JavaxToJakarta。您可以通过在
activeRecipes参数中指定每个方法包含多个方法。例如，要包含方法org.jboss.windup.JavaxInjectToJakartaInject和org.jboss.windup.JavaxEjbToJakartaEjb"，为"-DactiveRecipes=<recipes=<recipe name>"输入以下内容 ："-DactiveRecipes=org.jboss.windup.JavaxInjectToJakartaInject, \ org.jboss.windup.JavaxEjbToJakartaEjb""-DactiveRecipes=org.jboss.windup.JavaxInjectToJakartaInject, \ org.jboss.windup.JavaxEjbToJakartaEjb"Copy to Clipboard Copied! Toggle word wrap Toggle overflow --goal：可选：要运行的 OpenRewrite Maven 目标。-
dryRun：该脚本返回提议的更改列表。忽略"Run 'mvn rewrite:run' to apply the recipes"信息。 -
run： 脚本应用更改。
-
-
使用
--goal run运行windup-cli以应用方法：./windup-cli --openrewrite --input </path/to/source/project> \ "-Drewrite.configLocation=<path/to/rewrite.yaml>" \ "-DactiveRecipes=<recipe_name>" --goal run
$ ./windup-cli --openrewrite --input </path/to/source/project> \ "-Drewrite.configLocation=<path/to/rewrite.yaml>" \ "-DactiveRecipes=<recipe_name>" --goal runCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.2.4.1. 可用的 OpenRewrite recipes
| 迁移路径 | 用途 | rewrite.configLocation | activeRecipes |
|---|---|---|---|
| Java EE 到 Jakarta EE |
使用对等的
将 |
|
|
| Java EE 到 Jakarta EE | 重命名 bootstrap 文件 |
|
|
| Java EE 到 Jakarta EE |
转换 |
|
|
| Spring Boot 到 Quarkus |
在文件中替换 |
|
|
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}