Menilai aplikasi Java untuk modernisasi

Halaman ini menunjukkan cara menggunakan Google Cloud Modernization Hub di konsolGoogle Cloud untuk menilai aplikasi Java perusahaan untuk containerization dan modernisasi Linux ke rilis Java Long-Term Support (LTS) lintas platform (seperti Java 17 atau Java 21) di Google Cloud.

Banyak aplikasi Java perusahaan bergantung pada API Java EE lama, konfigurasi server aplikasi eksklusif (seperti WebLogic, WebSphere, atau JBoss), atau library pihak ketiga yang sudah tidak berlaku, sehingga mencegah deployment langsung ke container Linux. Penilaian otomatis di Modernization Hub menganalisis kode sumber Anda, mengidentifikasi pemblokir migrasi, mengevaluasi kompatibilitas dependensi Maven atau Gradle, dan merekomendasikan jalur refaktorisasi untuk Cloud Run atau Google Kubernetes Engine.

Untuk menjalankan penilaian dari komputer lokal atau menyesuaikan bagian laporan menggunakan codmod CLI mandiri, lihat Membuat Penilaian Modernisasi Aplikasi.

Kapan harus menggunakan penilaian aplikasi Java

Jalankan penilaian aplikasi Java saat Anda berencana melakukan salah satu tindakan berikut:

  • Melakukan replatform ke container Linux: identifikasi dependensi khusus lingkungan (seperti akses sistem file lokal, library JNI, atau API server aplikasi eksklusif) sebelum melakukan containerisasi aplikasi untuk Cloud Run atau GKE.
  • Mengupgrade versi runtime Java: mengevaluasi upaya dan kesenjangan kompatibilitas saat bermigrasi dari Java 8 atau Java 11 ke rilis LTS Java modern (Java 17 atau Java 21), atau bertransisi dari Java EE (javax.*) ke Jakarta EE (jakarta.*).
  • Memisahkan arsitektur monolitik: temukan komponen EJB yang terkait erat, broker pesan JMS, atau deployment WAR dan EAR monolitik yang memerlukan pemfaktoran ulang menjadi microservice berbasis cloud atau aplikasi Spring Boot.

Sebelum memulai

Sebelum memulai tugas penilaian Java di konsol, aktifkan API yang diperlukan, verifikasi izin Identity and Access Management (IAM) project Anda, daftarkan bucket setelan ruang kerja, dan upload arsip kode sumber Anda ke Cloud Storage.

Aktifkan API yang diperlukan

Untuk menggunakan Modernization Hub, aktifkan API layanan Google Cloud yang diperlukan di project Anda:

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

Ganti PROJECT_ID dengan project ID Google Cloud Anda.

Peran yang diperlukan

Menjalankan penilaian memerlukan izin IAM yang berbeda untuk dua identitas yang menggunakan Cloud Build dan Gemini Enterprise Agent Platform:

  • Pengguna konsol yang diautentikasi (memulai tugas dan mengakses bucket):
    • Storage Admin (roles/storage.admin)
    • (roles/iam.serviceAccountUser) Pengguna Akun Layanan
    • (roles/cloudbuild.builds.editor) Cloud Build Editor
  • Akun layanan khusus (mengeksekusi container penilaian):
    • Pengguna Agent Platform (roles/aiplatform.user)
    • Storage Object User (roles/storage.objectUser) atau Storage Admin (roles/storage.admin)

Untuk mendapatkan izin yang Anda perlukan untuk memulai penilaian dan menjalankan container analisis, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

  • Pengguna — Mengelola arsip sumber dan konfigurasi bucket: Storage Admin (roles/storage.admin)
  • User — Lampirkan akun layanan khusus ke tugas: Pengguna Akun Layanan (roles/iam.serviceAccountUser)
  • Pengguna — Mengirim tugas penilaian (cloudbuild.builds.create) dan melihat log: Cloud Build Editor (roles/cloudbuild.builds.editor)
  • Akun layanan — Menjalankan container codmod: Agent Platform User (roles/aiplatform.user)
  • Akun layanan — Membaca arsip sumber dan menulis laporan penilaian: Storage Object User (roles/storage.objectUser) atau Storage Admin (roles/storage.admin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk memulai penilaian dan menjalankan container analisis. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk memulai penilaian dan menjalankan container analisis:

  • Pengguna (Cloud Storage, Cloud Build, dan IAM):
    • storage.objects.get (Untuk mendownload atau membaca file)
    • storage.objects.list (Untuk mencantumkan file dalam bucket)
    • storage.objects.create (Untuk mengupload atau membuat file baru)
    • storage.objects.update (Untuk mengubah metadata file yang ada)
    • storage.objects.delete (Untuk menghapus atau menimpa file)
    • storage.buckets.get (Melihat konfigurasi tingkat bucket)
    • cloudbuild.builds.create (Untuk mengirimkan tugas penilaian)
    • iam.serviceAccounts.actAs (Untuk melampirkan akun layanan ke tugas)
  • Akun layanan (Agent Platform dan Cloud Storage):
    • aiplatform.endpoints.predict (Untuk menjalankan analisis kode yang didukung AI)
    • storage.objects.get (Untuk membaca atau mendownload arsip sumber)
    • storage.objects.list (Untuk mencantumkan file dalam folder input)
    • storage.objects.create (Untuk menulis laporan penilaian)
    • storage.objects.delete (Untuk menghapus file sementara)

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Mengonfigurasi bucket setelan ruang kerja

Daftarkan bucket Cloud Storage yang ditentukan di halaman Modernization Hub > Settings (misalnya, gs://PROJECT_ID-modernization-hub) untuk menyimpan file status biner ruang kerja (dotnet_jobs.pb, java_jobs.pb, dan mainframe_jobs.pb).

Meninjau batas ukuran codebase

Untuk mempertahankan performa yang optimal, mesin penilaian codmod menerapkan panduan skala dan pengarsipan berikut:

  • Ukuran codebase maksimum: sekitar enam juta baris kode (LOC) per tugas penilaian. Jika repositori Anda melebihi enam juta LOC, bagi codebase menjadi modul atau layanan yang lebih kecil dan independen sebelum mengupload.
  • Struktur arsip yang bersih: Kecualikan biner yang dikompilasi, cache paket, dan metadata kontrol versi (seperti target/, build/, bin/, node_modules/, dan .git/) dari file zip Anda sehingga hanya file sumber dan konfigurasi build yang dianalisis.

Menyiapkan dan mengupload arsip sumber Java Anda

Kemas codebase Java Anda sebagai file zip yang mengecualikan output build, dan upload file tersebut ke bucket Cloud Storage di project Anda.

  1. Di komputer lokal Anda, buat file zip repositori Anda menggunakan salah satu metode berikut:

    • Menggunakan Git (direkomendasikan):

      git archive --format=zip -o repository.zip HEAD
      
    • Menggunakan zip CLI:

      zip -r repository.zip . \
          -x "*.git*" "*/target/*" "*/build/*" "*/bin/*" "*/node_modules/*"
      
  2. Upload file zip ke bucket Cloud Storage target Anda menggunakan Google Cloud CLI:

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

    Ganti INPUT_BUCKET dengan nama bucket Cloud Storage target Anda.

Menjalankan penilaian

Untuk memulai tugas penilaian di Modernization Hub, ikuti langkah-langkah berikut:

  1. Di konsol, buka halaman Modernization Hub.

    Buka Modernization Hub

  2. Di halaman landing, temukan kartu Java Workloads, lalu klik Start assessment.

  3. Di kolom Job name, masukkan nama unik untuk tugas penilaian Anda.

  4. Di kolom Source code location, pilih bucket Cloud Storage yang berisi kode sumber Anda sebagai file zip.

  5. Di kolom Report location, pilih bucket Cloud Storage untuk menyimpan laporan penilaian yang dihasilkan.

  6. Dari daftar Modernization recipe, pilih resep modernisasi.

  7. Dari daftar Location, pilih region untuk tugas penilaian Anda.

  8. Di kolom Service account, pilih akun layanan khusus dengan peran IAM yang diperlukan yang tercantum di bagian Required roles. Cloud Build menjalankan tugas penilaian di akun layanan ini, yang memerlukan izin Agent Platform User dan Cloud Storage.

  9. Klik Generate Report.

    Konsol akan memulai container penilaian latar belakang yang menjalankan mesin codmod untuk menganalisis project Anda. Status tugas akan muncul di tabel Assessment history.

Meninjau laporan penilaian

Bergantung pada ukuran codebase Anda, tugas penilaian biasanya selesai dalam beberapa menit. Container latar belakang akan otomatis dihentikan setelah selesai diproses.

Untuk mengakses hasil penilaian Anda:

  1. Di tabel Assessment history di halaman Modernization Hub, cari tugas penilaian Anda.
  2. Saat kolom Status berubah menjadi Selesai, klik Download Laporan.
  3. Pilih format output yang Anda inginkan:
    • Laporan HTML: Ringkasan interaktif yang memungkinkan Anda memfilter API yang tidak kompatibel, memeriksa daftar pemblokir file per file, dan melihat saran perbaikan.
    • Laporan Markdown: Ringkasan eksekutif berformat yang cocok untuk dibagikan kepada pemangku kepentingan dan dewan peninjau arsitektur.

Meninjau laporan penilaian

Laporan penilaian yang dihasilkan mengategorikan kesiapan migrasi aplikasi Anda ke dalam beberapa area utama:

  • Skor kompatibilitas keseluruhan: persentase baris sumber dan dependensi yang dapat bermigrasi ke runtime Java target tanpa modifikasi.
  • Perincian pemblokir: dependensi Java lama atau batasan lingkungan tertentu yang memerlukan refaktorisasi, seperti:
    • Perubahan namespace Java EE (javax.*) ke Jakarta EE (jakarta.*).
    • API internal JDK yang dihapus atau tidak digunakan lagi (seperti paket sun.misc.* atau modul CORBA).
    • Konfigurasi atau API server aplikasi eksklusif (seperti deployment descriptor WebLogic, WebSphere, atau JBoss).
  • Analisis dependensi: inventaris mendetail dependensi Maven atau Gradle yang ada, yang menunjukkan apakah setiap library mendukung versi runtime Java target atau memerlukan upgrade.
  • Tindakan yang direkomendasikan: transformasi kode yang disarankan, resep pemfaktoran ulang yang didukung AI, dan jalur migrasi yang dihasilkan oleh codmod untuk menyiapkan aplikasi Anda untuk dimasukkan ke dalam container di Google Cloud.

Langkah berikutnya