Java アプリケーションのモダナイゼーションを評価する

このページでは、Google Cloud コンソールの Google Cloud Modernization Hub を使用して、Linux コンテナ化と Google Cloudのクロスプラットフォーム Java 長期サポート(LTS)リリース(Java 17 や Java 21 など)へのモダナイゼーションについて、エンタープライズ Java アプリケーションを評価する方法について説明します。

多くのエンタープライズ Java アプリケーションは、レガシー Java EE API、独自のアプリケーション サーバー構成(WebLogic、WebSphere、JBoss など)、または古いサードパーティ ライブラリに依存しているため、Linux コンテナに直接デプロイできません。Modernization Hub の自動評価では、ソースコードを分析し、移行の阻害要因を特定して、Maven または Gradle の依存関係の互換性を評価し、Cloud Run または Google Kubernetes Engine のリファクタリング パスを推奨します。

ローカル コンピュータから評価を実行する場合、またはスタンドアロンの codmod CLI を使用してレポート セクションをカスタマイズする場合は、App Modernization Assessment を作成するをご覧ください。

Java アプリケーション評価を使用するタイミング

次のいずれかを行う予定がある場合は、Java アプリケーション評価を実行します。

  • Linux コンテナへのリプラットフォーム: Cloud Run または GKE 用にアプリケーションをコンテナ化する前に、環境固有の依存関係(ローカル ファイル システム アクセス、JNI ライブラリ、独自のアプリケーション サーバー API など)を特定します。
  • Java ランタイム バージョンをアップグレードする: Java 8 または Java 11 から最新の Java LTS リリース(Java 17 または Java 21)に移行する場合、または Java EE(javax.*)から Jakarta EE(jakarta.*)に移行する場合に、作業量と互換性のギャップを評価します。
  • モノリシック アーキテクチャの分離: 密結合された EJB コンポーネント、JMS メッセージ ブローカー、モノリシック WAR および EAR デプロイを検出し、クラウドネイティブ マイクロサービスまたは Spring Boot アプリケーションにリファクタリングする必要があります。

始める前に

コンソールで Java 評価ジョブを開始する前に、必要な API を有効にし、プロジェクトの Identity and Access Management(IAM)権限を確認し、ワークスペース設定バケットを登録して、ソースコード アーカイブを Cloud Storage にアップロードします。

必要な API の有効化

Modernization Hub を使用するには、プロジェクトで必要な Google Cloudサービス API を有効にします。

gcloud services enable \
    aiplatform.googleapis.com \
    artifactregistry.googleapis.com \
    cloudbuild.googleapis.com \
    cloudresourcemanager.googleapis.com \
    compute.googleapis.com \
    logging.googleapis.com \
    storage.googleapis.com \
    --project=PROJECT_ID

PROJECT_ID は、実際の Google Cloud プロジェクト ID に置き換えます。

必要なロール

評価を実行するには、Cloud Build と Gemini Enterprise Agent Platform を使用する 2 つの ID に個別の IAM 権限が必要です。

  • 認証されたコンソール ユーザー(ジョブを開始してバケットにアクセスする):
    • ストレージ管理者(roles/storage.admin)
    • サービス アカウント ユーザー(roles/iam.serviceAccountUser)
    • Cloud Build 編集者(roles/cloudbuild.builds.editor)
  • 専用サービス アカウント(評価コンテナを実行):
    • Agent Platform ユーザー(roles/aiplatform.user)
    • Storage オブジェクト ユーザー(roles/storage.objectUser)またはストレージ管理者(roles/storage.admin)

評価を開始して分析コンテナを実行するために必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

  • ユーザー - ソース アーカイブとバケット構成を管理する: ストレージ管理者(roles/storage.admin)
  • ユーザー - 専用のサービス アカウントをジョブに接続する: サービス アカウント ユーザー(roles/iam.serviceAccountUser)
  • ユーザー - 評価ジョブを送信(cloudbuild.builds.create)し、ログを表示する: Cloud Build 編集者(roles/cloudbuild.builds.editor)
  • サービス アカウント - codmod コンテナを実行する: Agent Platform ユーザー(roles/aiplatform.user)
  • サービス アカウント - ソース アーカイブの読み取りと評価レポートの書き込み: Storage オブジェクト ユーザー(roles/storage.objectUser)または Storage 管理者(roles/storage.admin)

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

これらの事前定義ロールには、評価を開始して分析コンテナを実行するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

評価を開始して分析コンテナを実行するには、次の権限が必要です。

  • ユーザー(Cloud Storage、Cloud Build、IAM):
    • storage.objects.get(ファイルのダウンロードまたは読み取り)
    • storage.objects.list(バケット内のファイルを一覧表示する)
    • storage.objects.create(新しいファイルをアップロードまたは作成する場合)
    • storage.objects.update(既存のファイルのメタデータを変更する場合)
    • storage.objects.delete(ファイルの削除または上書き)
    • storage.buckets.get(バケットレベルの構成を表示する)
    • cloudbuild.builds.create(評価ジョブを送信するため)
    • iam.serviceAccounts.actAs(サービス アカウントをジョブに接続するため)
  • サービス アカウント(Agent Platform と Cloud Storage):
    • aiplatform.endpoints.predict(AI を活用したコード分析を実行する)
    • storage.objects.get(ソース アーカイブの読み取りまたはダウンロード)
    • storage.objects.list(入力フォルダ内のファイルを一覧表示する)
    • storage.objects.create(評価レポートを作成するため)
    • storage.objects.delete(一時ファイルを削除する場合)

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

ワークスペース設定バケットを構成する

[Modernization Hub > 設定] ページで、ワークスペースのバイナリ状態ファイル(dotnet_jobs.pb、java_jobs.pb、mainframe_jobs.pb)を保存するための指定の Cloud Storage バケット(例: gs://PROJECT_ID-modernization-hub)を登録します。

コードベースのサイズ上限を確認する

最適なパフォーマンスを維持するため、codmod 評価エンジンは次のスケールとアーカイブのガイドラインを適用します。

  • 最大コードベース サイズ: 評価ジョブあたり約 600 万行のコード(LOC)。リポジトリが 600 万 LOC を超える場合は、アップロードする前にコードベースをより小さな独立したモジュールまたはサービスに分割します。
  • クリーンなアーカイブ構造: コンパイル済みのバイナリ、パッケージ キャッシュ、バージョン管理メタデータ(target/、build/、bin/、node_modules/、.git/ など)を zip ファイルから除外して、ソースファイルとビルド構成のみが分析されるようにします。

Java ソース アーカイブを準備してアップロードする

Java コードベースをビルド出力が除外された ZIP ファイルとしてパッケージ化し、プロジェクトの Cloud Storage バケットにアップロードします。

  1. ローカルマシンで、次のいずれかの方法を使用してリポジトリの ZIP ファイルを作成します。

    • Git を使用する(推奨):

      git archive --format=zip -o repository.zip HEAD
      
    • zip CLI を使用する場合:

      zip -r repository.zip . \
          -x "*.git*" "*/target/*" "*/build/*" "*/bin/*" "*/node_modules/*"
      
  2. Google Cloud CLI を使用して、ZIP ファイルをターゲットの Cloud Storage バケットにアップロードします。

    gcloud storage cp repository.zip \
        gs://INPUT_BUCKET/codebase/repository.zip
    

    INPUT_BUCKET は、ターゲット Cloud Storage バケットの名前に置き換えます。

評価を実行する

Modernization Hub で評価ジョブを開始する手順は次のとおりです。

  1. コンソールで、[Modernization Hub] ページに移動します。

    モダナイゼーション ハブに移動

  2. ランディング ページで [Java ワークロード] カードを見つけて、[評価を開始] をクリックします。

  3. [ジョブ名] フィールドに、評価ジョブの一意の名前を入力します。

  4. [ソースコードの場所] フィールドで、ソースコードを ZIP ファイルとして含む Cloud Storage バケットを選択します。

  5. [レポートの場所] フィールドで、生成された評価レポートを保存する Cloud Storage バケットを選択します。

  6. [モダナイゼーション レシピ] リストから、モダナイゼーション レシピを選択します。

  7. [ロケーション] リストから、評価ジョブのリージョンを選択します。

  8. [サービス アカウント] フィールドで、必要なロールセクションに記載されている必要な IAM ロールを持つ専用のサービス アカウントを選択します。Cloud Build は、このサービス アカウントで評価ジョブを実行します。このサービス アカウントには、Agent Platform ユーザー権限と Cloud Storage 権限が必要です。

  9. [レポートを生成] をクリックします。

    コンソールは、codmod エンジンを実行するバックグラウンド評価コンテナを起動して、プロジェクトを分析します。ジョブのステータスが [評価履歴] テーブルに表示されます。

評価レポートを確認する

コードベースのサイズによっては、評価ジョブは通常数分以内に完了します。バックグラウンド コンテナは、処理が完了すると自動的に終了します。

アセスメント結果にアクセスするには:

  1. [Modernization Hub] ページの [評価履歴] テーブルで、評価ジョブを見つけます。
  2. [ステータス] 列が [完了] に変わったら、[レポートをダウンロード] をクリックします。
  3. 優先する出力形式を選択します。
    • HTML レポート: 互換性のない API のフィルタリング、ファイルごとのブロッカー リストの検査、修正の提案の表示を行うことができるインタラクティブな概要。
    • マークダウン レポート: ステークホルダーやアーキテクチャ審査委員会との共有に適した、フォーマットされたエグゼクティブ サマリー。

評価レポートを確認する

生成された評価レポートでは、アプリケーションの移行準備状況がいくつかの主要な領域に分類されます。

  • 全体的な互換性スコア: 変更なしでターゲット Java ランタイムに移行できるソース行と依存関係の割合。
  • ブロッカーの内訳: リファクタリングが必要な特定のレガシー Java 依存関係または環境制約。例:
    • Java EE(javax.*)から Jakarta EE(jakarta.*)への名前空間の変更。
    • 削除または非推奨となった JDK 内部 API(sun.misc.* パッケージや CORBA モジュールなど)。
    • 独自のアプリケーション サーバー構成または API(WebLogic、WebSphere、JBoss のデプロイ記述子など)。
  • 依存関係分析: 既存の Maven または Gradle の依存関係の詳細なインベントリ。各ライブラリがターゲット Java ランタイム バージョンをサポートしているか、アップグレードが必要かを示します。
  • 推奨される対応: codmod によって生成された、推奨されるコード変換、AI を活用したリファクタリング レシピ、移行パス。 Google Cloudでのコンテナ化に備えてアプリケーションを準備します。

次のステップ