Red Hat Summit2.2. CLI の実行
アプリケーションに対して MTA を実行できます。
手順
-
ターミナルを開き、
<MTA_HOME>/bin/ディレクトリーに移動します。 Windows の場合は
windup-cliスクリプトまたは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. MTA コマンドの例
アプリケーションアーカイブでの MTA の実行
次のコマンドは、JBoss EAP 5 から JBoss EAP 7 に移行するための サンプル EAR アーカイブ jee-example-app-1.0.0.ear の com.acme パッケージおよび org.apache パッケージを解析します。
<MTA_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
$ <MTA_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ソースコードでの MTA の実行
次のコマンドは、JBoss EAP 6 に移行するための seam-booking-5.2 サンプルソースコードの org.jboss.seam パッケージを分析します。
<MTA_HOME>/bin/windup-cli --sourceMode --input /path/to/seam-booking-5.2/ \
--output /path/to/report-output/ --target eap:6 --packages org.jboss.seam
$ <MTA_HOME>/bin/windup-cli --sourceMode --input /path/to/seam-booking-5.2/ \
--output /path/to/report-output/ --target eap:6 --packages org.jboss.seamcloud-readiness ルールの実行
次のコマンドは、JBoss EAP 7 に移行するためのサンプル EAR アーカイブ jee-example-app-1.0.0.ear の com.acme パッケージおよび org.apache パッケージを解析します。また、クラウドの準備ができるかどうかも評価します。
<MTA_HOME>/bin/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
$ <MTA_HOME>/bin/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.apacheMTA プロパティーの上書き
デフォルトの Fernflower デコンパイラーを上書きするには、コマンドラインで -Dwindup.decompiler 引数を渡します。たとえば、Procyon デコンパイル機能を使用する場合は、以下の構文を使用します。
<MTA_HOME>/bin/windup-cli -Dwindup.decompiler=procyon \
--input <INPUT_ARCHIVE_OR_DIRECTORY> --output <OUTPUT_REPORT_DIRECTORY> \
--target <TARGET_TECHNOLOGY> --packages <PACKAGE_1> <PACKAGE_2>
$ <MTA_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. MTA CLI Bash の完了
MTA CLI は、Linux システムの Bash 補完を有効にするオプションを提供し、コマンドを入力した時に Tab キーを押して MTA コマンドライン引数を自動化できます。たとえば、bash 補完を有効にすると、以下のように利用可能な引数のリストが表示されます。
<MTA_HOME>/bin/windup-cli [TAB]
$ <MTA_HOME>/bin/windup-cli [TAB]bash 補完の有効化
現在のシェルで bash 補完を有効にするには、以下のコマンドを実行します。
source <MTA_HOME>/bash-completion/windup-cli
$ source <MTA_HOME>/bash-completion/windup-cli永続的な bash 補完の有効化
以下のコマンドを使用すると、再起動後も bash 補完が維持されます。
システムを再起動しても特定のユーザーの bash 補完を有効にするには、そのユーザーの
~/.bashrcファイルに以下の行を追加します。source <MTA_HOME>/bash-completion/windup-cli
source <MTA_HOME>/bash-completion/windup-cliCopy to Clipboard Copied! Toggle word wrap Toggle overflow システムの再起動後すべてのユーザーの bash 補完を有効にするには、root ユーザーで Migration Toolkit for Applications CLI Bash 補完ファイルを
/etc/bash_completion.d/ディレクトリーにコピーします。cp <MTA_HOME>/bash-completion/windup-cli /etc/bash_completion.d/
# cp <MTA_HOME>/bash-completion/windup-cli /etc/bash_completion.d/Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.2.3. MTA ヘルプへのアクセス
windup-cli コマンドで利用可能な引数の完全な一覧を表示するには、ターミナルを開き、<MTA_HOME> ディレクトリーに移動して、以下のコマンドを実行します。
<MTA_HOME>/bin/windup-cli --help
$ <MTA_HOME>/bin/windup-cli --help2.2.4. OpenRewrite レシピの使用
OpenRewrite レシピのサポートはテクノロジープレビュー機能としてのみ提供されます。テクノロジープレビュー機能は、Red Hat の実稼働環境でのサービスレベルアグリーメント (SLA) ではサポートされていないため、Red Hat では実稼働環境での使用を推奨していません。テクノロジープレビューの機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行いフィードバックを提供していただくことを目的としています。
テクノロジープレビュー機能のサポート範囲については、Red Hat カスタマーポータルの テクノロジープレビュー機能のサポート範囲 を参照してください。
MTA CLI で OpenRewrite レシピを使用すると、Java アプリケーションのソースコードをリファクタリングできます。
たとえば、OpenRewrite レシピの 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 Project Object Model (POM) XML ファイルpom.xmlを含むソースコードプロジェクトの最上位にある必要があります。 -
-Drewrite.configLocation=<path/to/rewrite.yaml>: 使用するrewrite.yaml設定ファイルの場所。同梱のrewrite.yaml設定ファイルは、<MTA_HOME>/rules/openrewriteサブフォルダーにあります (例:" -Drewrite.configLocation=<MTA_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=<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 レシピ
| 移行パス | 目的 | rewrite.configLocation | activeRecipes |
|---|---|---|---|
| Java EE から Jakarta EE |
|
|
|
| Java EE から Jakarta EE | ブートストラップファイルの名前を変更する |
|
|
| 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}