Azure Migrate uygulaması ve Java sürüm 7 kodu için değerlendirme (önizleme)

2025-06-12

Uyarı

Bu makale, Java sürüm 7.x için yeni nesil Azure Geçişi uygulaması ve kod değerlendirmesine yöneliktir. Bu sürüm önizleme aşamasındadır. Önceki kararlı sürüm olan sürüm 6.x için bkz. Java için Azure Geçişi uygulaması ve kod değerlendirmesi.

Bu makalede, her tür Java uygulamasını değerlendirmek ve yeniden düzenlemek için Java için Azure Geçişi uygulaması ve kod değerlendirme aracının nasıl kullanılacağı gösterilmektedir. Araç, yeniden platform oluşturma ve Azure'a geçiş için uygulama hazırlığını değerlendirmenizi sağlar. Bu araç bir komut satırı arabirimi (CLI) olarak sunulur ve Azure için yeniden platform oluşturma ve geçiş fırsatlarını belirlemek üzere Java uygulama ikili dosyalarını ve kaynak kodunu değerlendirir. Yaygın kullanım örneklerini ve kod desenlerini belirleyerek ve önerilen değişiklikleri önererek büyük ölçekli Java uygulamalarını modernleştirmenize ve yeniden oluşturmanıza yardımcı olur.

Araç, statik kod analizi aracılığıyla uygulama teknolojisi kullanımını bulur, efor tahmini sağlar ve kod yeniden platformunu hızlandırır. Bu değerlendirme, Java uygulamalarının önceliklerini belirlemenize ve Azure'a taşımanıza yardımcı olur. Bir dizi altyapı ve kuralla, araç Java 11, Java 17, Jakarta EE, Spring, Hibernate, Java Message Service (JMS) ve daha fazlası gibi farklı teknolojileri keşfedebilir ve değerlendirebilir. Araç daha sonra Java uygulamasını farklı Azure hedeflerine (Azure Uygulaması Hizmeti, Azure Kubernetes Service ve Azure Container Apps) belirli Azure yeniden hazırlama kurallarıyla yeniden hazırlamanıza yardımcı olur.

Araç, Red Hat tarafından oluşturulan ve yönetilen Cloud Native Computing Foundation projesi Konveyor'daki bir bileşen kümesini temel alır.

Genel bakış

Araç, kuruluşların Java uygulamalarını maliyetleri düşürecek ve daha hızlı yeniliklere olanak sağlayacak şekilde modernleştirmelerine yardımcı olmak için tasarlanmıştır. Araç, herhangi bir Java uygulamasının yapısını ve bağımlılıklarını anlamak için gelişmiş analiz tekniklerini kullanır ve uygulamaları yeniden düzenleme ve Azure'a geçirme konusunda rehberlik sağlar.

Bununla, aşağıdaki görevleri gerçekleştirebilirsiniz:

Teknoloji kullanımını keşfedin: Bir uygulamanın hangi teknolojileri kullandığını hızla görün. Çok fazla belge olmayan eski uygulamalarınız varsa ve hangi teknolojileri kullandıklarını öğrenmek istiyorsanız bulma yararlı olur.
Kodu belirli bir hedefe değerlendirme: Belirli bir Azure hedefi için bir uygulamayı değerlendirme. Uygulamalarınızı Azure'a yeniden eklemek için yapmanız gereken çabayı ve değişiklikleri denetleyin.

Desteklenen hedefler

Araç, farklı Azure hizmetlerine dağıtabilmeniz ve kullanabilmeniz için uygulamalarınızı yeniden oluşturmanıza yardımcı olacak kurallar içerir.

Azure Geçişi uygulaması ve kod değerlendirmesi tarafından kullanılan kurallar bir hedefe göre gruplandırılır. Hedef, uygulamanın nerede veya nasıl çalıştığı ile genel ihtiyaçlar ve beklentilerdir. Bir uygulamayı değerlendirirken birden çok hedef seçebilirsiniz. Aşağıdaki tabloda kullanılabilir hedefler açıklanmaktadır:

Hedef adı	Açıklama	Hedef
Azure App Service	Bir uygulamayı Azure Uygulaması Hizmetine dağıtmak için en iyi yöntemler.	`azure-appservice`
Azure Kubernetes Service	Azure Kubernetes Service'e uygulama dağıtmak için en iyi yöntemler.	`azure-aks`
Azure Konteyner Uygulamaları	Azure Container Apps'e uygulama dağıtmaya yönelik en iyi yöntemler.	`azure-container-apps`
Bulut Hazırlığı	Bir uygulamayı Bulut (Azure) için hazır hale getirmek için genel en iyi yöntemler.	`cloud-readiness`
Linux işletim sistemi	Bir uygulamayı Linux'a hazır hale getirmek için genel en iyi yöntemler.	`linux`
OpenJDK 11	Java 11 ile Java 8 uygulaması çalıştırmaya yönelik genel en iyi yöntemler.	`openjdk11`
OpenJDK 17	Java 17 ile Java 11 uygulaması çalıştırmaya yönelik genel en iyi yöntemler.	`openjdk17`
OpenJDK 21	Java 21 ile Java 17 uygulaması çalıştırmaya yönelik genel en iyi yöntemler.	`openjdk21`

Araç Bulut Hazırlığı ve ilgili Azure hizmetlerini değerlendirdiğinde, farklı Azure hizmetlerinin olası kullanımına yönelik yararlı bilgiler de bildirebilir. Aşağıdaki listede kapsanan hizmetlerden birkaçı gösterilmektedir:

Azure Veritabanları
Azure Hizmet Otobüsü
Azure Depolama
Azure Content Delivery Network
Azure Event Hubs
Azure Key Vault
Azure Ön Kapı

İndirme ve kurma

CLI'yı appcat kullanmak için, paketi ortamınıza özgü olarak indirmeniz ve ortamınızda gerekli bağımlılıklara sahip olmanız gerekir. appcat CLI, Intel, Arm veya Apple Silicon donanımı kullanarak Windows, Linux veya Mac gibi herhangi bir ortamda çalışır. JDK gereksinimi için OpenJDK'nin Microsoft Derlemesi'ni kullanmanızı öneririz.

İşletim Sistemi	Mimari	Bağlantıyı İndir	Diğer dosyalar
x64
Windows	x64	İndirmek	sha256 / Sıg
macOS	x64	İndirmek	sha256 / Sıg
Linux işletim sistemi	x64	İndirmek	sha256 / Sıg
AArch64
Windows	AArch64 / ARM64	İndirmek	sha256 / Sıg
macOS	Apple Silicon	İndirmek	sha256 / Sıg
Linux işletim sistemi	AArch64 / ARM64	İndirmek	sha256 / Sıg

Önkoşullar

OpenJDK 17'nin Microsoft Derlemesi'ni indirin ve yükleyin. Ortam değişkeninin ayarlandığından JAVA_HOME emin olun.

AppCAT'i yükleme

appcat uygulamasını yüklemek için platformunuza uygun zip dosyasını indirin. Dosyayı indirdikten sonra, işletim sisteminize bağlı olarak bir .tar.gz (Linux/macOS) veya .zip dosyası (Windows) bulmanız gerekir.

İndirilen dosyadan ikili dosyasını ayıklayın. Aşağıdaki klasör yapısını görmeniz gerekir:

/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

AppCAT'i çalıştırma

Terminalinizde appcat'ı herhangi bir konumdan çalıştırmak için arşivi istediğiniz konuma ayıklayın. Ardından ortam değişkenini PATH , arşivi ayıkladığınız dizini içerecek şekilde güncelleştirin.

Uyarı

İkili appcat çağrıldığında, ilk olarak ortam değişkeninde PATH belirtilen yürütülebilir klasörde bağımlılıklarını arar. Bağımlılıklar bulunamazsa, kullanıcının giriş dizinine ( Linux/Mac üzerinde ~/.appcat veya Windows'da \.appcat%USERPROFILE% ) geri döner.

Kullanım

Alt Komutlar

AppCAT, kullanım için iki alt komut sağlar:

analyze: Giriş kaynak kodunda ya da bir ikili dosyada kaynak kod analizi yapın.
transform: XML kurallarını önceki sürümlerden (6 ve üstü) bu sürüm tarafından kullanılan YAML biçimine dönüştürün.

Uyarı

macOS kullanıcıları için: Uygulamayı çalıştırmaya çalışırken bir hatayla Apple could not verify karşılaşırsanız aşağıdaki komutu kullanarak bu hatayı düzeltebilirsiniz:

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

Örneğin:

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

Alt komutu analiz etme

Alt analyze komut, kaynak kodu ve ikili analizi çalıştırmanızı sağlar.

Uygulama kaynak kodunu analiz etmek için aşağıdaki komutu kullanın:

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

Bayrağın --input bir kaynak kod dizinine veya ikili dosyaya işaret etmesi ve --output çözümleme sonuçlarını depolamak için bir dizine işaret etmesi gerekir.

Analiz bayrakları hakkında daha fazla bilgi için aşağıdaki komutu kullanın:

Linux / macOS
Windows

./appcat analyze --help

.\appcat.exe analyze --help

AppCAT için kullanılabilir hedefleri denetlemek için aşağıdaki komutu kullanın:

Linux / macOS
Windows

./appcat analyze --list-targets

.\appcat.exe analyze --list-targets

Bu komut aşağıdaki çıkışı oluşturur:

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

Birden çok uygulamayı analiz etme

AppCAT, komut yürütme başına birden çok uygulama çözümlemesini destekler. Tek bir komutta birden çok uygulamayı analiz etmek için bayrağının giriş yollarının --input virgülle ayrılmış bir listesini sağlayabilirsiniz. Çıkış dizini ve statik rapor, tüm uygulamalar için birleşik analiz sonuçlarını içerir.

Birden çok uygulamayı analiz etmek için aşağıdaki komutu kullanın:

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 ayrıca mevcut bir çıkış dizinine ve statik rapora artımlı olarak daha fazla uygulama analizi eklemek için seçeneğini kullanmanıza --bulk olanak tanır. --bulk seçeneğini kullandığınızda, aynı çıktıya yazan tüm komut yürütmelerinde onu tutarlı bir şekilde kullanmalısınız.

Uyarı

Birden çok giriş yolu sağladığınızda, --bulk varsayılan olarak etkinleştirilir.

Mevcut statik rapora artımlı olarak daha fazla uygulama analizi eklemek için aşağıdaki komutu kullanın:

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>

Alt komutu dönüştür

Alt komut, transform 6.x sürümünde kullanılan önceki appcat XML kurallarını bu sürüm 7.x tarafından kullanılan yeni YAML biçimine dönüştürmenizi sağlar.

Kuralları dönüştürmek için aşağıdaki komutu kullanın:

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>

Bayrağın --input XML kuralları içeren bir dosya veya dizine işaret etmesi ve bayrağının --output dönüştürülen YAML kuralları için çıkış dizinine işaret etmesi gerekir.

Örnekler

Uyarı

Ayıklanan klasördeki betikler için dosya izinlerinin yürütmeye izin verecek şekilde ayarlandığından emin olun.

Samples dizininde, farklı çözümleme türlerini çalıştırmak için aşağıdaki betikleri bulabilirsiniz:

çalıştırma değerlendirmesi: Kod değerlendirmesi ve Airsonic'i Tomcat üzerinde Azure App Service'e geçirme adımlarını içeren bir rapor sağlar.
run-assessment-transform-rules: Windup XML kurallarını analyzer-lsp uyumlu YAML kurallarına dönüştürür.
run-assessment-custom-rules: Özel kurallar (XML'yi YAML'ye dönüştürme) kullanarak bir kod değerlendirme raporu sağlar.
run-assessment-openjdk21: Kod değerlendirmesi ve Airsonic'i OpenJDK 21'e geçirme adımlarını içeren bir rapor oluşturur.
run-assessment-package-only: Belirli paketleri değerlendirerek bir rapor oluşturur.

Bu betikler, müzik koleksiyonunuza erişmenizi ve bunları paylaşmanızı sağlayan topluluk odaklı, web tabanlı bir medya aktarıcı olan Airsonic-Advanced örnek projesiyle birlikte kullanılmak üzere tasarlanmıştır.

Aşağıdaki komutu kullanarak uygulama deposunu el ile kopyalayabilirsiniz:

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

Kopyalamadan sonra, değerlendirme betiklerini çalıştırırken kopyalanan klasörün yolunu sağlayın. İşletim sisteminize bağlı olarak, aşağıdaki örnekte gösterildiği gibi uygun betiği çalıştırın:

Uyarı

Betikleri çalıştırmadan önce Airsonic Advanced projesini yerel bir yola kopyaladığınızdan emin olun.

Linux / macOS
Windows

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

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

Raporlar otomatik olarak oluşturulur ve başlatılır. Raporları ../samples/report-* (Linux/macOS) veya ..\samples\report-* (Windows) altında bulabilirsiniz.

Analizin özeti

Raporun giriş sayfasında tüm analiz edilen uygulamaların özet görünümü gösterilir. Buradan, ayrıntılı bulguları keşfetmek için tek tek uygulama raporlarına gidebilirsiniz.

Sağ üst köşedeki Copilot'a Sorun düğmesi sizi Visual Studio Code'daki GitHub Copilot App Modernization for Java uzantısına yönlendirir. Bu uzantı, AppCAT ve GitHub Copilot'un yapay zeka özellikleriyle desteklenen Java uygulamalarını Azure'a geçirmek için temel özellikleri olarak hem uygulama değerlendirmesi hem de kod düzeltmesi sağlar.

Değerlendirme raporu

Değerlendirme raporu, uygulamayı Azure'a başarıyla geçirmek için ele almanız gereken Azure hazırlığı, bulut yerel ve Java modernleştirmesinin çeşitli yönlerini içeren kategorilere ayrılmış bir sorun listesi sağlar.

Her Sorun önem derecesine ( Zorunlu, İsteğe Bağlı veya Potansiyel ) göre kategorilere ayrılmıştır ve etkilenen kod satırlarının sayısını içerir.

Bağımlılıklar ve Teknolojiler sekmeleri, uygulama içinde kullanılan kitaplıkları ve teknolojileri görüntüler.

Belirli bir sorun için ayrıntılı bilgi

Her sorun için, yalnızca seçerek daha fazla bilgi (sorun ayrıntıları, kuralın içeriği vb.) alabilirsiniz. Bu sorundan etkilenen tüm dosyaların listesini de alırsınız.

Ardından, sorundan etkilenen her dosya veya sınıf için kaynak koda atlayarak sorunu oluşturan kod satırını vurgulayabilirsiniz.