Penilaian aplikasi dan kode Azure Migrate untuk Java versi 7 (pratinjau)

Catatan

Artikel ini untuk generasi berikutnya dari aplikasi Azure Migrate dan penilaian kode untuk Java, versi 7.x. Versi ini sedang dalam pratinjau. Untuk versi stabil sebelumnya, versi 6.x, lihat Aplikasi Azure Migrate dan penilaian kode untuk Java.

Artikel ini memperlihatkan kepada Anda cara menggunakan aplikasi Azure Migrate dan alat penilaian kode untuk Java untuk menilai dan mereplatformasi semua jenis aplikasi Java. Alat ini memungkinkan Anda mengevaluasi kesiapan aplikasi untuk mereplatformasi dan migrasi ke Azure. Alat ini ditawarkan sebagai antarmuka baris perintah (CLI), dan menilai biner aplikasi Java dan kode sumber untuk mengidentifikasi peluang replatforming dan migrasi untuk Azure. Ini membantu Anda memodernisasi dan mereplatformasi aplikasi Java skala besar dengan mengidentifikasi kasus penggunaan umum dan pola kode dan mengusulkan perubahan yang direkomendasikan.

Alat ini menemukan penggunaan teknologi aplikasi melalui analisis kode statis, memberikan estimasi upaya, dan mempercepat replatforming kode. Penilaian ini membantu Anda memprioritaskan dan memindahkan aplikasi Java ke Azure. Dengan seperangkat mesin dan aturan, alat ini dapat menemukan dan menilai berbagai teknologi seperti Java 11, Java 17, Jakarta EE, Spring, Hibernate, Java Message Service (JMS), dan banyak lagi. Alat ini kemudian membantu Anda mereplatformasi aplikasi Java ke target Azure yang berbeda - Azure App Service, Azure Kubernetes Service, dan Azure Container Apps - dengan aturan replatformasi Azure tertentu.

Alat ini didasarkan pada serangkaian komponen dalam proyek Cloud Native Computing Foundation Konveyor, yang dibuat dan dipimpin oleh Red Hat.

Gambaran Umum

Alat ini dirancang untuk membantu organisasi memodernisasi aplikasi Java mereka dengan cara yang mengurangi biaya dan memungkinkan inovasi yang lebih cepat. Alat ini menggunakan teknik analisis tingkat lanjut untuk memahami struktur dan dependensi aplikasi Java apa pun, dan memberikan panduan tentang cara merefaktor dan memigrasikan aplikasi ke Azure.

Dengan itu, Anda dapat melakukan tugas-tugas berikut:

Temukan penggunaan teknologi: Lihat teknologi mana yang digunakan aplikasi dengan cepat. Penemuan berguna jika Anda memiliki aplikasi warisan dengan dokumentasi yang tidak banyak dan ingin mengetahui teknologi mana yang mereka gunakan.
Menilai kode ke target tertentu: Menilai aplikasi untuk target Azure tertentu. Periksa upaya dan modifikasi yang harus Anda lakukan untuk mereplatformasi aplikasi Anda ke Azure.

Target yang didukung

Alat ini berisi aturan untuk membantu Anda mereplatformasi aplikasi sehingga Anda dapat menyebarkan, dan menggunakan layanan Azure yang berbeda.

Aturan yang digunakan oleh aplikasi Azure Migrate dan penilaian kode dikelompokkan berdasarkan target. Target adalah tempat atau bagaimana aplikasi berjalan, dan kebutuhan dan harapan umum. Saat menilai aplikasi, Anda dapat memilih beberapa target. Tabel berikut ini menjelaskan target yang tersedia:

Nama target	Deskripsi	Sasaran
Azure App Service	Praktik terbaik untuk menyebarkan aplikasi ke Azure App Service.	`azure-appservice`
Azure Kubernetes Service	Praktik terbaik untuk menyebarkan aplikasi ke Azure Kubernetes Service.	`azure-aks`
Aplikasi Kontainer Azure	Praktik terbaik untuk menyebarkan aplikasi ke Azure Container Apps.	`azure-container-apps`
Kesiapan Cloud	Praktik umum terbaik untuk persiapan aplikasi Cloud (Azure).	`cloud-readiness`
Linux	Praktik terbaik umum untuk membuat aplikasi Linux siap.	`linux`
OpenJDK 11	Praktik terbaik umum untuk menjalankan aplikasi Java 8 dengan Java 11.	`openjdk11`
OpenJDK 17	Praktik terbaik umum untuk menjalankan aplikasi Java 11 dengan Java 17.	`openjdk17`
OpenJDK 21	Praktik terbaik umum untuk menjalankan aplikasi Java 17 dengan Java 21.	`openjdk21`

Saat alat menilai kesiapan Cloud dan layanan Azure terkait, alat ini juga dapat melaporkan informasi yang berguna untuk potensi penggunaan layanan Azure yang berbeda. Daftar berikut ini memperlihatkan beberapa layanan yang tercakup:

Azure Databases
Azure Service Bus (Layanan Bus oleh Azure)
Azure Storage
Jaringan Pengiriman Konten Azure
Azure Event Hubs
Azure Key Vault
Azure Front Door (layanan pengiriman konten dari Microsoft)

Unduh dan instal

Untuk menggunakan appcat CLI, Anda harus mengunduh paket khusus untuk lingkungan Anda, dan memiliki dependensi yang diperlukan di lingkungan Anda. appcat CLI berjalan di lingkungan apa pun seperti Windows, Linux, atau Mac, menggunakan perangkat keras Intel, Arm, atau Apple Silicon. Untuk persyaratan JDK, kami sarankan Anda menggunakan Microsoft Build of OpenJDK.

Sistem Operasi	Arsitektur	Tautan unduhan	File lain
x64
Windows	x64	Mengunduh	sha256 / Sig
macOS	x64	Mengunduh	sha256 / Sig
Linux	x64	Mengunduh	sha256 / Sig
AArch64
Windows	AArch64 / ARM64	Mengunduh	sha256 / Sig
macOS	Apple Silicon	Mengunduh	sha256 / Sig
Linux	AArch64 / ARM64	Mengunduh	sha256 / Sig

Prasyarat

Unduh dan instal Microsoft Build of OpenJDK 17. Pastikan variabel JAVA_HOME lingkungan diatur.

Menginstal AppCAT

Untuk menginstal appcat, unduh file zip yang sesuai untuk platform Anda. Setelah mengunduh file, tergantung pada sistem operasi, Anda harus menemukan file .tar.gz (Linux/macOS) atau .zip (Windows).

Ekstrak biner dari file yang diunduh. Anda akan melihat struktur folder berikut:

/azure-migrate-appcat-for-java-cli-<OS>-<architecture>-<release-version>-preview/
├── appcat.exe (Windows) / appcat (Linux/macOS)
├── samples/
├── fernflower.jar
├── LICENSE
├── NOTICE.txt
├── maven.default.index
├── jdtls/
├── static-report/
├── rulesets/
├── readme.md
└── readme.html

Jalankan AppCAT

Untuk menjalankan appcat dari lokasi mana pun di terminal Anda, ekstrak arsip ke lokasi yang Anda inginkan. Kemudian, perbarui PATH variabel lingkungan untuk menyertakan direktori tempat Anda mengekstrak arsip.

Catatan

Ketika biner appcat dijalankan, biner pertama-tama mencari dependensinya di folder eksekusi yang ditentukan dalam variabel lingkungan PATH. Jika dependensi tidak ditemukan, dependensi akan kembali ke direktori beranda pengguna - ~/.appcat di Linux/Mac atau %USERPROFILE%\.appcat di Windows.

Penggunaan

Subperintah

AppCAT menyediakan dua sub-perintah untuk penggunaan:

analyze: Jalankan analisis kode sumber pada kode sumber input atau biner.
transform: Konversi aturan XML dari versi sebelumnya (6 dan yang lebih lama) ke format YAML yang digunakan oleh versi ini.

Catatan

Untuk pengguna macOS: Jika Anda mengalami kesalahan yang menyatakan Apple could not verify saat mencoba menjalankan aplikasi, Anda dapat mengatasi kesalahan ini dengan menggunakan perintah berikut:

xattr -d -r com.apple.quarantine /path/to/appcat_binary

Contohnya:

xattr -d -r com.apple.quarantine $HOME/.appcat/appcat

Analisis subperintah

analyze Sub perintah memungkinkan Anda menjalankan kode sumber dan analisis biner.

Untuk menganalisis kode sumber aplikasi, gunakan perintah berikut:

Linux / macOS
Windows

./appcat analyze --input=<path-to-source-code> --output=<path-to-output-directory> --target=azure-appservice,cloud-readiness --overwrite

.\appcat.exe analyze --input=<path-to-source-code> --output=<path-to-output-directory> --target=azure-appservice,cloud-readiness --overwrite

Bendera --input harus menunjuk ke direktori kode sumber atau file biner, dan --output harus menunjuk ke direktori untuk menyimpan hasil analisis.

Untuk informasi selengkapnya tentang bendera analisis, gunakan perintah berikut:

Linux / macOS
Windows

./appcat analyze --help

.\appcat.exe analyze --help

Untuk memeriksa target yang tersedia untuk AppCAT, gunakan perintah berikut:

Linux / macOS
Windows

./appcat analyze --list-targets

.\appcat.exe analyze --list-targets

Perintah ini menghasilkan output berikut:

available target technologies:
azure-aks
azure-appservice
azure-container-apps
cloud-readiness
linux
openjdk11
openjdk17
openjdk21

Menganalisis beberapa aplikasi

AppCAT mendukung beberapa analisis aplikasi dalam eksekusi per perintah. Anda dapat menyediakan daftar jalur input yang dipisahkan koma untuk --input bendera guna menganalisis beberapa aplikasi dalam satu perintah. Direktori output dan laporan statis mencakup hasil analisis gabungan untuk semua aplikasi.

Untuk menganalisis beberapa aplikasi, gunakan perintah berikut:

Linux / macOS
Windows

./appcat analyze --input=<path-to-source-A>,<path-to-source-B>,<path-to-source-C> --output=<path-to-output-ABC> --target=<target-name>

.\appcat.exe analyze --input=<path-to-source-A>,<path-to-source-B>,<path-to-source-C> --output=<path-to-output-ABC> --target=<target-name>

AppCAT juga memungkinkan Anda menggunakan --bulk opsi untuk menambahkan lebih banyak analisis aplikasi secara bertahap ke direktori output dan laporan statis yang ada. Saat Anda menggunakan opsi --bulk, Anda harus menggunakannya secara konsisten pada semua perintah yang dijalankan yang menulis ke output yang sama.

Catatan

Saat Anda menyediakan beberapa jalur input, --bulk diaktifkan secara default.

Untuk menambahkan lebih banyak analisis aplikasi secara bertahap ke laporan statis yang ada, gunakan perintah berikut:

Linux / macOS
Windows

./appcat analyze --input=<path-to-source-A>,<path-to-source-B>,<path-to-source-C> --output=<path-to-output-ABC> --target=<target-name>
./appcat analyze --bulk --input=<path-to-source-D> --output=<path-to-output-ABC> --target=<target-name>
./appcat analyze --bulk --input=<path-to-source-E> --output=<path-to-output-ABC> --target=<target-name>

.\appcat.exe analyze --input=<path-to-source-A>,<path-to-source-B>,<path-to-source-C> --output=<path-to-output-ABC> --target=<target-name>
.\appcat.exe analyze --bulk --input=<path-to-source-D> --output=<path-to-output-ABC>
.\appcat.exe analyze --bulk --input=<path-to-source-E> --output=<path-to-output-ABC>

Mengubah sub-perintah

transform Sub-perintah memungkinkan Anda mengonversi aturan XML sebelumnya appcat yang digunakan dalam versi 6.x ke dalam format YAML baru yang digunakan oleh versi 7.x ini.

Untuk mengubah aturan, gunakan perintah berikut:

Linux / macOS
Windows

./appcat transform rules --input=<path-to-xml-rules> --output=<path-to-output-directory>

.\appcat.exe transform rules --input=<path-to-xml-rules> --output=<path-to-output-directory>

Bendera --input harus menunjuk ke file atau direktori yang berisi aturan XML, dan --output bendera harus menunjuk ke direktori output untuk aturan YAML yang dikonversi.

Contoh

Catatan

Pastikan bahwa izin file untuk skrip di folder yang diekstrak diatur untuk memungkinkan eksekusi.

Dalam direktori sampel , Anda dapat menemukan skrip berikut untuk menjalankan berbagai jenis analisis:

run-assessment: Menyediakan laporan dengan penilaian kode dan langkah-langkah untuk memigrasikan Airsonic ke Azure App Service di Tomcat.
run-assessment-transform-rules: Mengonversi aturan XML Windup ke aturan YAML yang kompatibel dengan analyzer-lsp.
run-assessment-custom-rules: Menyediakan laporan penilaian kode menggunakan aturan kustom (mengubah XML ke YAML).
run-assessment-openjdk21: Menghasilkan laporan dengan penilaian kode dan langkah-langkah untuk memigrasikan Airsonic ke OpenJDK 21.
run-assessment-package-only: Menghasilkan laporan dengan menilai paket tertentu.

Skrip ini dimaksudkan untuk digunakan dengan proyek sampel Airsonic-Advanced - streamer media berbasis komunitas berbasis web yang memungkinkan Anda mengakses dan berbagi koleksi musik Anda.

Anda dapat mengkloning repositori aplikasi secara manual menggunakan perintah berikut:

git clone https://github.com/airsonic-advanced/airsonic-advanced.git

Setelah mengkloning, berikan jalur ke folder kloning saat menjalankan skrip penilaian. Bergantung pada sistem operasi Anda, jalankan skrip yang sesuai, seperti yang ditunjukkan dalam contoh berikut:

Catatan

Pastikan Anda telah mengkloning proyek Airsonic Advanced ke jalur lokal sebelum menjalankan skrip.

Linux / macOS
Windows

./samples/run-assessment <path-to-airsonic-advanced>

.\samples\run-assessment.bat <path-to-airsonic-advanced>

Laporan dibuat dan diluncurkan secara otomatis. Anda dapat menemukan laporan di bawah .. /samples/report-* (Linux/macOS) atau .. \samples\report-* (Windows).

Ringkasan analisis

Halaman arahan laporan menyajikan tampilan ringkasan semua aplikasi yang dianalisis. Dari sini, Anda dapat menavigasi ke laporan aplikasi individual untuk menjelajahi temuan terperinci.

Tombol Tanya Copilot di pojok kanan atas akan mengarahkan Anda ke ekstensi GitHub Copilot App Modernization for Java di Visual Studio Code. Ekstensi ini menyediakan penilaian aplikasi dan remediasi kode sebagai kemampuan utamanya untuk memigrasikan aplikasi Java ke Azure - didukung oleh kemampuan AI AppCAT dan GitHub Copilot.

Laporan penilaian

Laporan penilaian menyediakan daftar masalah yang dikategorikan dari berbagai aspek kesiapan Azure, cloud native, dan modernisasi Java yang perlu Anda atasi agar berhasil memigrasikan aplikasi ke Azure.

Setiap Masalah dikategorikan berdasarkan tingkat keparahan - Wajib, Opsional, atau Potensi - dan mencakup jumlah baris kode yang terkena dampak.

Tab Dependensi dan Teknologi menampilkan pustaka dan teknologi yang digunakan dalam aplikasi.

Informasi terperinci untuk masalah tertentu

Untuk setiap masalah, Anda bisa mendapatkan informasi lebih lanjut (detail masalah, konten aturan, dan sebagainya) hanya dengan memilihnya. Anda juga mendapatkan daftar semua file yang terpengaruh oleh masalah ini.

Kemudian, untuk setiap file atau kelas yang terpengaruh oleh masalah ini, Anda dapat melompat ke kode sumber untuk menyoroti baris kode yang membuat masalah.