Visual Studio Code エクステンションガイド
Visual Studio Code の Migration Toolkit for Applications エクステンションでアプリケーションの分析および移行の問題特定をして解決する
概要
多様性を受け入れるオープンソースの強化 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、用語の置き換えは、今後の複数のリリースにわたって段階的に実施されます。詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。
第1章 はじめに リンクのコピーリンクがクリップボードにコピーされました!
1.1. Microsoft Visual Studio Code の MTA エクステンションについて リンクのコピーリンクがクリップボードにコピーされました!
Microsoft Visual Studio Code 用の Migration Toolkit for Applications (MTA) エクステンションを使用して、アプリケーションを移行および最新化できます。
MTA エクステンションはカスタマイズ可能なルールセットを使用してプロジェクトを分析し、ソースコード内の問題をマークし、問題を修正するためのガイダンスを提供し、可能な場合は自動コードの置き換えを提供します。
MTA エクステンションは、Microsoft クラウドでホストされる開発環境である Visual Studio Codespaces とも互換性があります。
1.2. Migration Toolkit for Applications の概要 リンクのコピーリンクがクリップボードにコピーされました!
Migration Toolkit for Applications とは
Migration Toolkit for Applications (MTA) は、Red Hat OpenShift 上のハイブリッドクラウド環境全体で大規模なアプリケーションモダナイゼーションに対する取り組みを促進します。このソリューションは、導入プロセス全体を通じて、ポートフォリオレベルとアプリケーションレベルの詳細情報を提供します。ユーザーインターフェイスを使用して、アプリケーションのインベントリー作成、評価、分析、および管理を行い、OpenShift Container Platform への移行をより短期間で行うことができます。
MTA 7.1 以降では、アプリケーションを Application Inventory に追加すると、MTA が言語検出タスクとテクノロジー検出タスクを自動的に作成して実行します。言語の検出では、アプリケーションで使用されているプログラミング言語が識別されます。テクノロジーの検出では、Enterprise Java Beans (EJB)、Spring などのテクノロジーが識別されます。その後、各タスクによってアプリケーションに適切なタグが割り当てられるため、アプリケーションに手動でタグを付ける時間と労力が削減されます。
MTA は、アプリケーションを評価するための基礎として広範にわたるデフォルトの質問リストを使用します。または、独自のカスタム質問リストを作成して、アプリケーションのコンテナー化の準備に必要な難易度、時間、およびその他のリソースを見積もることもできます。ステークホルダー間の議論の基礎として評価の結果を使用して、どのアプリケーションがコンテナー化に適しているか、どのアプリケーションが最初に多大な作業を必要とするか、どのアプリケーションがコンテナー化に適していないかを判断できます。
MTA は、対象のアプリケーションごとに 1 つ以上のルールセットを適用してアプリケーションを分析し、モダナイゼーションする前に、そのアプリケーションに含まれるどの行を変更するかを判断します。
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 Development Kit (JDK) がインストールされている。MTA がサポートしているのは以下の JDK です。
- Oracle JDK 17 以降
- Eclipse Temurin™ JDK 17 以降
- OpenJDK 17 以降
- MTA には 8 GB のメモリーが必要です。
-
macOS のインストール:
maxprocの値が2048以上である。
手順
環境変数
JAVA_HOMEを設定します。export JAVA_HOME=jdk11
$ export JAVA_HOME=jdk11Copy to Clipboard Copied! Toggle word wrap Toggle overflow - VS Code で Activity バーの Extensions アイコンをクリックして、Extensions ビューを開きます。
-
Search フィールドに
Migration Toolkit for Applicationsと入力します。 Migration Toolkit for Applications 拡張を選択し、Install をクリックします。
MTA 拡張アイコン (
) が Activity バーに表示されます。
第3章 .kantra ディレクトリーの設定 リンクのコピーリンクがクリップボードにコピーされました!
Migration Toolkit for Applications (MTA) 7.2.0 以降では、コンテナーレスモードでアプリケーション分析を実行できます。分析を実行する前に、.kantra ディレクトリーを作成して設定する必要があります。
前提条件
- システムに MTA 拡張バージョン 7.2.0 以降がインストールされている。詳細は、Visual Studio Code 用 MTA 拡張のインストール を参照してください。
- MTA ディストリビューションバージョン 7.2.0 以降がインストールされている。詳細は、CLI .zip ファイルのインストール を参照してください。
手順
$HOMEディレクトリーに.kantraという名前のディレクトリーを作成します。mkdir ~/.kantra/
$ mkdir ~/.kantra/Copy to Clipboard Copied! Toggle word wrap Toggle overflow mta-cliバイナリーを除くすべてのファイルを 展開した MTA ディレクトリー から~/.kantraディレクトリーに移動します。mv !(mta-cli) ~/.kantra/
$ mv !(mta-cli) ~/.kantra/Copy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
-
アプリケーション分析を実行して、
.kantraディレクトリーを正しく作成および設定していることを確認します。詳細は、MTA 拡張機能を使用したプロジェクトの分析 を参照してください。
第4章 MTA エクステンションを使用したプロジェクトの分析 リンクのコピーリンクがクリップボードにコピーされました!
実行設定を作成し、分析を実行して、MTA エクステンションでプロジェクトを分析できます。
4.1. MTA エクステンションインターフェイス リンクのコピーリンクがクリップボードにコピーされました!
Migration Toolkit for Applications (MTA) エクステンションのインターフェイスは、情報の検索とアクションの実行を容易にするように設計されています。
- 左側のペインに、上部にレポートアイコンが付いた Analysis Results という名前のディレクトリーツリーが表示されます。アイコンをクリックして、ブラウザーで MTA レポートを開きます。レポートアイコンの下には、ツリーの他の要素 (MTA が分析したアプリケーション、使用されるルールセット、分析で検出された問題) が表示されます。
- 右上のペインで、分析を設定できます。
- 右下のペインで、ソース、ターゲット、高度なオプションなど、設定の設定が表示されます。このペインで分析の進捗状況を表示できます。分析が完了したら、Open Report ボタンをクリックして MTA レポートを開くことができます。これは、アプリケーションの移行またはモダナイゼーションの前に対処する必要がある問題を記述します。詳細は、CLI ガイド の レポートの確認 を参照してください。
4.2. 実行設定の設定 リンクのコピーリンクがクリップボードにコピーされました!
MTA エクステンションインターフェイス
複数の実行設定を設定して、VS Code にインポートする各プロジェクトに対して実行できます。
前提条件
-
mta-cli実行可能ファイルがインストールされている。mta-cli実行可能ファイルは mta のダウンロード からダウンロードできます。
手順
-
Extensions ビューで、アクティビティーバーの Migration Toolkit for Applications アイコン (
) をクリックします。
- Migration Toolkit for Applications の横にある + (上向き記号) をクリックして、実行設定を追加します。
以下の設定フィールドに入力します。
- Name: 分析設定に意味のある名前を入力するか、デフォルトを受け入れます。
-
cli: cli 実行ファイルへのパスを入力します。例:
$HOME/mta-cli-7.2.3.GA-redhat/bin/mta-cli。 Input: Add をクリックして次のいずれかを実行することにより、IDE 内で開いているプロジェクトのパスに設定します。
- 入力ファイルまたはディレクトリーを入力して、Enter を押します。
- Open File Explorer をクリックし、ディレクトリーを選択します。
- Target: 1 つ以上のターゲット移行パスを選択します。
実行設定を右クリックし、Run を選択します。
分析が完了したら、Open Report ボタンをクリックして MTA レポートを開くことができます。これは、アプリケーションの移行またはモダナイゼーションの前に対処する必要がある問題を記述します。詳細は、CLI ガイド の レポートの確認 を参照してください。
第5章 移行の問題の確認および解決 リンクのコピーリンクがクリップボードにコピーされました!
左側のペインで MTA エクステンションで識別される移行の問題を確認し、解決できます。
5.1. 問題の確認 リンクのコピーリンクがクリップボードにコピーされました!
MTA 拡張アイコンを使用して、重大度に基づいて問題の優先順位付けができます。
手順
- 左側のペインで、実行設定ディレクトリーを選択します。
- そのフォルダーをデプロイメントし、各アプリケーションファイルに生成された Hints を表示します。
- ソースコードを表示するヒントを選択します。
- ヒントを右クリックし、View Details を選択して Rule ID およびその他の情報を表示します。
各ヒントの横に表示される以下のアイコンに基づいて、問題の優先順位付けを行います。
-
: 移行を成功させるには、この問題を修正する必要があります。
-
: この問題は、移行時に解決する必要がある場合があります。
-
5.2. 問題の解決 リンクのコピーリンクがクリップボードにコピーされました!
ヒントを含むファイルのコードを編集することで問題を解決できます。
5.2.1. ファイルのコードの編集 リンクのコピーリンクがクリップボードにコピーされました!
VS Code にインポートしたプロジェクトのファイルを編集できます。
手順
- 左側のペインで、問題を右クリックし、Open Code を選択します。
- コードに必要な変更を加え、ファイルを保存します。
- オプション: 問題を右クリックし、Mark as Complete または Delete を選択します。