評估是否要翻新 Java 應用程式

本頁面說明如何使用Google Cloud 控制台中的 Google Cloud Modernization Hub,評估企業 Java 應用程式是否適合 Linux 容器化,以及是否能翻新為 Google Cloud上的跨平台 Java 長期支援 (LTS) 版本 (例如 Java 17 或 Java 21)。

許多企業 Java 應用程式都依賴舊版 Java EE API、專屬應用程式伺服器設定 (例如 WebLogic、WebSphere 或 JBoss),或過時的第三方程式庫,因此無法直接部署至 Linux 容器。Modernization Hub 的自動化評估功能會分析原始碼、找出遷移阻礙、評估 Maven 或 Gradle 依附元件相容性,並建議 Cloud Run 或 Google Kubernetes Engine 的重構路徑。

如要從本機電腦執行評估,或使用獨立 codmod CLI 自訂報表區段,請參閱「建立應用程式現代化評估」。

Java 應用程式評估的適用時機

如果您打算執行下列任一操作,請執行 Java 應用程式評估:

  • 將平台轉換為 Linux 容器:先找出環境專屬的依附元件 (例如本機檔案系統存取權、JNI 程式庫或專屬應用程式伺服器 API),再將應用程式容器化,以便在 Cloud Run 或 GKE 中執行。
  • 升級 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) 權限、註冊工作區設定 bucket,並將原始碼封存檔上傳至 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 的兩個身分,指派不同的 IAM 權限:

  • 已驗證的控制台使用者 (啟動工作及存取 bucket):
    • 儲存空間管理員 (roles/storage.admin)
    • 服務帳戶使用者 (roles/iam.serviceAccountUser)
    • Cloud Build 編輯者 (roles/cloudbuild.builds.editor)
  • 專用服務帳戶 (執行評估容器):
    • Agent Platform 使用者 (roles/aiplatform.user)
    • Storage 物件使用者 (roles/storage.objectUser) 或 Storage 管理員 (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)

如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這些預先定義的角色具備啟動評估及執行分析容器所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

您必須具備下列權限,才能啟動評估作業及執行分析容器:

  • 使用者 (Cloud Storage、Cloud Build 和 IAM):
    • storage.objects.get (下載或讀取檔案)
    • storage.objects.list (列出 bucket 中的檔案)
    • storage.objects.create (上傳或建立新檔案)
    • storage.objects.update (修改現有檔案的中繼資料)
    • storage.objects.delete (刪除或覆寫檔案)
    • storage.buckets.get (查看 bucket 層級設定)
    • 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 (刪除暫存檔案)

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

設定工作區設定 bucket

在「Modernization Hub」>「設定」頁面註冊指定的 Cloud Storage bucket (例如 gs://PROJECT_ID-modernization-hub),用於儲存工作區二進位狀態檔案 (dotnet_jobs.pb、java_jobs.pb 和 mainframe_jobs.pb)。

查看程式碼集大小限制

為維持最佳效能,codmod 評估引擎會強制執行下列規模和封存指南:

  • 程式碼集大小上限:每項評估工作約 600 萬行程式碼 (LOC)。如果存放區超過 600 萬行程式碼,請先將程式碼集分割成較小的獨立模組或服務,再上傳。
  • 乾淨的封存結構:從 ZIP 檔案中排除已編譯的二進位檔、套件快取和版本管控中繼資料 (例如 target/、build/、bin/、node_modules/ 和 .git/),只分析來源檔案和建構設定。

準備並上傳 Java 來源封存檔

將 Java 程式碼集封裝為 ZIP 檔案 (不含建構輸出內容),然後上傳至專案中的 Cloud Storage bucket。

  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 bucket:

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

    將 INPUT_BUCKET 替換為目標 Cloud Storage bucket 的名稱。

執行評估作業

如要在 Modernization Hub 啟動評估工作,請按照下列步驟操作:

  1. 前往控制台的「Modernization Hub」頁面。

    前往 Modernization Hub

  2. 在到達網頁中,找到「Java Workloads」(Java 工作負載) 資訊卡,然後按一下「Start assessment」(開始評估)。

  3. 在「Job name」(工作名稱) 欄位中,輸入評估工作的專屬名稱。

  4. 在「Source code location」(原始碼位置) 欄位中,選取包含原始碼 (ZIP 檔案) 的 Cloud Storage bucket。

  5. 在「Report location」(報表位置) 欄位中,選取要儲存產生的評估報表的 Cloud Storage bucket。

  6. 從「Modernization recipe」(現代化方案) 清單中選取現代化方案。

  7. 從「Location」(位置) 清單中,選取評估工作的區域。

  8. 在「Service account」(服務帳戶) 欄位中,選取具備「必要角色」一節所列 IAM 角色的專屬服務帳戶。Cloud Build 會以這個服務帳戶執行評估工作,該帳戶須具備 Agent Platform 使用者和 Cloud Storage 權限。

  9. 按一下「產生報表」。

    控制台會啟動背景評估容器,執行 codmod 引擎來分析專案。工作狀態會顯示在「Assessment history」(評估記錄) 表格中。

查看評估報表

視程式碼集大小而定,評估工作通常會在幾分鐘內完成。背景容器會在處理完畢後自動終止。

如要查看評估結果,請按照下列步驟操作:

  1. 在「Modernization Hub」頁面的「Assessment history」(評估記錄) 表格中,找出評估工作。
  2. 當「Status」(狀態) 欄變更為「Completed」(已完成) 時,請按一下「Download Report」(下載報表)。
  3. 選取偏好的輸出格式:
    • HTML 報表:互動式摘要,可讓您篩選不相容的 API、逐一檢查檔案封鎖清單,以及查看修正建議。
    • Markdown 報表:格式化的內容提要,適合與利害關係人和架構審查委員會分享。

查看評估報表

產生的評估報告會將應用程式的遷移準備程度分為幾個主要領域:

  • 整體相容性分數:可直接遷移至目標 Java 執行階段,不需修改的來源行和依附元件百分比。
  • 阻礙細目:需要重構的特定舊版 Java 依附元件或環境限制,例如:
    • Java EE (javax.*) 至 Jakarta EE (jakarta.*) 命名空間變更。
    • 已移除或淘汰的 JDK 內部 API (例如 sun.misc.* 套件或 CORBA 模組)。
    • 專屬應用程式伺服器設定或 API (例如 WebLogic、WebSphere 或 JBoss deployment descriptor)。
  • 依附元件分析:詳細列出現有的 Maven 或 Gradle 依附元件,指出各個程式庫是否支援目標 Java 執行階段版本,或是否需要升級。
  • 建議動作:codmod 產生的建議程式碼轉換、AI 輔助重構配方和遷移路徑,可協助您準備應用程式,以便在 Google Cloud上容器化。

後續步驟