Visual Studio Code 拡張機能ガイド


Migration Toolkit for Applications 6.0

Visual Studio Code の Migration Toolkit for Applications エクステンションでアプリケーションを分析し、移行の問題を特定し、解決します。

Red Hat Customer Content Services

概要

このガイドでは、Visual Studio Code 用の Migration Toolkit for Applications 拡張機能を使用して、Red Hat OpenShift のハイブリッドクラウド環境全体で大規模なアプリケーションモダナイゼーションの取り組みを促進する方法について説明します。

多様性を受け入れるオープンソースの強化

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 への移行をより短い期間で行うことができます。

MTA は、アプリケーションを評価するための基礎として広範にわたる質問リストを使用して、コンテナー化のアプリケーションの準備に必要な難易度、時間、およびその他のリソースを見積もることができるようにします。ステークホルダー間の議論の基礎として評価の結果を使用して、どのアプリケーションがコンテナー化に適しているか、最初に多大な作業が必要なアプリケーション、およびコンテナー化に適していないアプリケーションを判断できます。

MTA は、考慮された各アプリケーションに 1 つ以上のルールセットを適用してアプリケーションを分析し、最新化する前にそのアプリケーションの中でどの特定の行を変更する必要があるかを判断します。

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 アプリケーションの Azure App Service への移行
  • Spring Boot Java アプリケーションの Azure App Service への移行

ユースケースおよび移行パスの詳細は、開発者向け MTA Web ページを参照してください。

Migration Toolkit for Applications による移行を単純化する方法

Migration Toolkit for Applications は一般的なリソースを探し、アプリケーションを移行する際の既知の問題点を明らかにします。これは、アプリケーションが使用するテクノロジーのハイレベルビューを提供します。

MTA は、移行またはモダナイゼーションパスの評価に関する詳細なレポートを生成します。このレポートは、大規模なプロジェクトに必要な作業を見積もり、関係する作業を減らすのに役立ちます。

第2章 Visual Studio Code 用 MTA 拡張のインストール

Visual Studio Code (VS Code) の MTA 拡張をインストールできます。

前提条件

  • Java Development Kit(JDK) がインストールされている。MTA は以下の JDK をサポートします。

    • OpenJDK 11
    • Oracle JDK 11
  • 8 GB RAM
  • macOS のインストール: maxproc の値は 2048 以上である必要がある。

手順

  1. 環境変数 JAVA_HOME を設定します。

    Copy to Clipboard Toggle word wrap
    $ export JAVA_HOME=jdk11
  2. VS Code で Activity バーの Extensions アイコンをクリックして、Extensions ビューを開きます。
  3. Search フィールドに Migration Toolkit for Applications と入力します。
  4. Migration Toolkit for Applications 拡張を選択し、Install をクリックします。

    MTA 拡張アイコン ( MTA code extension ) が Activity バーに表示されます。

第3章 MTA 拡張機能を使用したプロジェクトの分析

実行設定を作成し、分析を実行して、MTA エクステンションでプロジェクトを分析できます。

3.1. MTA 拡張機能インターフェイス

Migration Toolkit for Applications (MTA) 拡張機能のインターフェイスは、情報の検索とアクションの実行を容易にするように設計されています。

  • 左側のペインに、上部にレポートアイコンが付いたAnalysis Resultsという名前のディレクトリーツリーが表示されます。アイコンをクリックして、ブラウザーで MTA レポートを開きます。レポートアイコンの下には、ツリーの他の要素 (MTA が分析したアプリケーション、使用されるルールセット、分析で検出された問題) です。
  • 右上のペインで、分析を設定できます。
  • 右下のペインで、ソース、ターゲット、高度なオプションなど、設定の設定が表示されます。このペインで分析の進捗状況を表示できます。分析が完了したら、Open Report ボタンをクリックして MTA レポートを開くことができます。これは、アプリケーションの移行またはモダナイゼーションの前に対処する必要がある問題を記述します。詳細は、CLI ガイドレポートの確認 を参照してください。

図3.1 MTA 拡張機能インターフェイス

MTA 拡張機能インターフェイス

3.2. 実行設定の設定

複数の実行設定を設定して、VS Code にインポートする各プロジェクトに対して実行することができます。

前提条件

  • windup-cli 実行可能ファイルがインストールされています。windup-cli 実行ファイルは mta download からダウンロードできます。

手順

  1. Extensions ビューで、アクティビティーバーの Migration Toolkit for Applications アイコン ( MTA code extension ) をクリックします。
  2. Migration Toolkit for Applications の横にある +(上向き記号) をクリックして、実行設定を追加します。
  3. 以下の設定フィールドに入力します。

    • 名前: 分析設定に意味のある名前を入力するか、デフォルトを受け入れます。
    • cli: cli 実行ファイルへのパスを入力します。たとえば、$HOME/mta-cli-6.0.1.GA-redhat/bin/windup-cli です。
    • 入力: Add をクリックして次のいずれかを実行することにより、IDE 内で開いているプロジェクトのパスに設定します。

      • 入力ファイルまたはディレクトリーを入力して、Enter を押します。
      • Open File Explorer をクリックし、ディレクトリーを選択します。
    • Target: 1 つ以上のターゲット移行パスを選択します。
  4. 実行設定を右クリックし、Run を選択します。

    分析が完了したら、Open Report ボタンをクリックして MTA レポートを開くことができます。これは、アプリケーションの移行またはモダナイゼーションの前に対処する必要がある問題を記述します。詳細は、CLI ガイドレポートの確認 を参照してください。

第4章 移行の問題の確認および解決

左側のペインで MTA エクステンションで識別される移行の問題を確認し、解決できます。

4.1. 問題の確認

MTA 拡張アイコンを使用して、重大度に基づいて問題の優先順位付けができます。また、クイック修正の自動コード置換がある問題を確認することもできます。

手順

  1. 左側のペインで、実行設定ディレクトリーを選択します。
  2. そのフォルダーを展開し、各アプリケーションファイルに生成された Hints を表示します。
  3. ソースコードを表示するヒントを選択します。
  4. ヒントを右クリックし、View Details を選択して Rule ID およびその他の情報を表示します。
  5. 各ヒントの横に表示される以下のアイコンに基づいて、問題の優先順位付けを行います。

    • Mandatory : 移行を成功させるには、この問題を修正する必要があります。
    • Warning : この問題は、移行時に対処する必要がある場合があります。
    • Optional or Quick Fix : 移行については、この問題の修正は任意です。このアイコンは、問題に利用できるクイック修正を示すためにも使用されます。

4.2. 問題の解決

以下のいずれかを実行して問題を解決できます。

  • クイック修正 の自動コードの置き換えの使用
  • ヒントを使用したファイルのコードの編集

Delete または Mark as Complete オプションを使用して、解決された問題を追跡できます。削除済みまたは完了とマークされたファイルは、次回それらを含むプロジェクトを分析する際に再度分析されます。

4.2.1. クイック修正の使用

クイック修正の自動コード置換を使用して、時間を節約し、繰り返し発生する問題を解決する際の一貫性を確保できます。

手順

  1. 左側のペインで、クイック修正アイコン ( Optional or Quick Fix ) の問題を右クリックし、Preview Quick Fix を選択します。
  2. 推奨の修正を受け入れるには、もう一度問題を右クリックし、Apply Quick Fix を選択します。
  3. オプション: 問題を右クリックし、Mark as Complete または Delete を選択します。

4.2.2. ファイルのコードの編集

VS Code にインポートしたプロジェクトのファイルを編集できます。

手順

  1. 左側のペインで、問題を右クリックし、Open Code を選択します。
  2. コードに必要な変更を加え、ファイルを保存します。
  3. オプション: 問題を右クリックし、Mark as Complete または Delete を選択します。

法律上の通知

Copyright © 2023 Red Hat, Inc.
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.
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat, Inc.