Ocena aplikacji i kodu usługi Azure Migrate dla języka Java w wersji 7 (wersja zapoznawcza)

2025-06-12

Uwaga

Ten artykuł dotyczy następnej generacji aplikacji usługi Azure Migrate i oceny kodu dla języka Java w wersji 7.x. Ta wersja jest dostępna w wersji zapoznawczej. Aby uzyskać poprzednią stabilną wersję 6.x, zobacz ocenę aplikacji i kodu usługi Azure Migrate dla języka Java (Azure Migrate application and code assessment for Java).

W tym artykule pokazano, jak za pomocą narzędzia do oceny aplikacji i kodu usługi Azure Migrate dla języka Java ocenić i ponownie utworzyć dowolny typ aplikacji Java. Narzędzie umożliwia ocenę gotowości aplikacji do ponownego tworzenia i migracji na platformę Azure. To narzędzie jest oferowane jako interfejs wiersza polecenia i ocenia pliki binarne aplikacji Java i kod źródłowy w celu zidentyfikowania możliwości ponownego tworzenia i migracji dla platformy Azure. Pomaga to zmodernizować i ponownieplatformować aplikacje Java na dużą skalę, identyfikując typowe przypadki użycia i wzorce kodu oraz proponując zalecane zmiany.

Narzędzie odnajduje użycie technologii aplikacji za pomocą statycznej analizy kodu, zapewnia szacowanie nakładu pracy i przyspiesza ponowne tworzenie kodu. Ta ocena ułatwia ustalanie priorytetów i przenoszenie aplikacji Java na platformę Azure. Dzięki zestawowi silników i reguł narzędzie może odkrywać i oceniać różne technologie, takie jak Java 11, Java 17, Jakarta EE, Spring, Hibernate, Java Message Service (JMS) i nie tylko. Następnie narzędzie ułatwia przekształcenie aplikacji Java na różne docelowe platformy Azure - Usługa aplikacji Azure, Azure Kubernetes Service i Aplikacje kontenerowe Azure - przy użyciu określonych reguł migracji platformy Azure.

Narzędzie jest oparte na zestawie składników w projekcie Cloud Native Computing Foundation Konveyor utworzonym i prowadzonym przez firmę Red Hat.

Omówienie

Narzędzie zostało zaprojektowane w celu ułatwienia organizacjom modernizacji aplikacji Java w sposób, który zmniejsza koszty i umożliwia szybsze innowacje. Narzędzie używa zaawansowanych technik analizy do zrozumienia struktury i zależności dowolnej aplikacji Java oraz zawiera wskazówki dotyczące refaktoryzacji i migrowania aplikacji na platformę Azure.

Za jego pomocą można wykonywać następujące zadania:

Odkrywanie użycia technologii: Szybko sprawdź, które technologie używa aplikacja. Odnajdywanie jest przydatne, jeśli masz starsze aplikacje z nie dużą ilością dokumentacji i chcesz wiedzieć, które technologie używają.
Ocena kodu do określonego celu: Ocena aplikacji pod kątem określonego celu platformy Azure. Sprawdź nakład pracy i modyfikacje, które należy wykonać, aby ponownieplatformować aplikacje na platformie Azure.

Obsługiwane obiekty docelowe

Narzędzie zawiera reguły ułatwiające ponowne splatformowania aplikacji, dzięki czemu można wdrażać i używać różnych usług platformy Azure.

Reguły używane przez aplikację Azure Migrate i ocenę kodu są grupowane w oparciu o cel. Element docelowy to miejsce, w którym działa aplikacja, oraz ogólne potrzeby i oczekiwania. Podczas oceniania aplikacji można wybrać wiele obiektów docelowych. W poniższej tabeli opisano dostępne elementy docelowe:

Nazwa docelowa	opis	Obiekt docelowy
Azure App Service	Najlepsze praktyki dotyczące wdrażania aplikacji w usłudze Azure App Service.	`azure-appservice`
Azure Kubernetes Service	Najlepsze rozwiązania dotyczące wdrażania aplikacji w usłudze Azure Kubernetes Service.	`azure-aks`
Azure Container Apps (aplikacje kontenerowe Azure)	Najlepsze rozwiązania dotyczące wdrażania aplikacji w usłudze Azure Container Apps.	`azure-container-apps`
Gotowość do chmury	Ogólne najlepsze rozwiązania dotyczące przygotowania chmury aplikacji (Azure).	`cloud-readiness`
Linuxa	Ogólne najlepsze rozwiązania dotyczące przygotowania aplikacji do systemu Linux.	`linux`
OpenJDK 11	Ogólne najlepsze rozwiązania dotyczące uruchamiania aplikacji Java 8 z językiem Java 11.	`openjdk11`
OpenJDK 17	Ogólne najlepsze rozwiązania dotyczące uruchamiania aplikacji Java 11 z językiem Java 17.	`openjdk17`
OpenJDK 21	Ogólne najlepsze rozwiązania dotyczące uruchamiania aplikacji Java 17 z językiem Java 21.	`openjdk21`

Gdy narzędzie oceni gotowość do chmury i powiązane usługi platformy Azure, może również zgłosić przydatne informacje dotyczące potencjalnego użycia różnych usług platformy Azure. Poniższa lista zawiera kilka omówionych usług:

Bazy danych platformy Azure
Usługa Azure Service Bus
Azure Storage
Azure Content Delivery Network
Azure Event Hubs
Azure Key Vault
Usługa Azure Front Door

Pobierz i zainstaluj

Aby użyć interfejsu appcat wiersza polecenia, musisz pobrać pakiet odpowiedni dla twojego środowiska i mieć wymagane zależności w swoim środowisku. Interfejs appcat wiersza polecenia działa w dowolnym środowisku, takim jak Windows, Linux lub Mac, przy użyciu sprzętu Intel, Arm lub Apple Silicon. Dla wymagań dotyczących JDK zalecamy użycie Microsoft Build of OpenJDK.

System operacyjny	Architektura	Link pobierania	Inne pliki
x64
Windows	x64	Pobierz	sha256 / Sig
macOS	x64	Pobierz	sha256 / Sig
Linuxa	x64	Pobierz	sha256 / Sig
AArch64
Windows	AArch64 / ARM64	Pobierz	sha256 / Sig
macOS	Apple Silicon	Pobierz	sha256 / Sig
Linuxa	AArch64 / ARM64	Pobierz	sha256 / Sig

Wymagania wstępne

Pobierz i zainstaluj program Microsoft Build of OpenJDK 17. Upewnij się, że zmienna środowiskowa jest ustawiona JAVA_HOME .

Instalowanie usługi AppCAT

Aby zainstalować appcatprogram , pobierz odpowiedni plik zip dla swojej platformy. Po pobraniu pliku w zależności od systemu operacyjnego należy znaleźć .tar.gz (Linux/macOS) lub plik.zip (Windows).

Wyodrębnij plik binarny z pobranego pliku. Powinna zostać wyświetlona następująca struktura folderów:

/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

Uruchamianie usługi AppCAT

Aby uruchomić appcat z dowolnego miejsca w terminalu, wyodrębnij archiwum do żądanej lokalizacji. Następnie zaktualizuj zmienną PATH środowiskową, aby uwzględnić katalog, w którym wyodrębniono archiwum.

Uwaga

Po wywołaniu appcat pliku binarnego najpierw wyszukuje jego zależności w folderze wykonywalny określonym w zmiennej środowiskowej PATH . Jeśli zależności nie są znalezione, wraca do katalogu macierzystego użytkownika — ~/.appcat w systemie Linux/Mac lub %USERPROFILE%\.appcat w systemie Windows.

Użycie

Podpolecenia

Usługa AppCAT udostępnia dwa polecenia podrzędne do użycia:

analyze: Uruchom analizę kodu na wejściowym kodzie źródłowym lub na pliku binarnym.
transform: przekonwertuj reguły XML z poprzednich wersji (6 i starszych) na format YAML używany przez tę wersję.

Uwaga

W przypadku użytkowników systemu macOS: jeśli podczas próby uruchomienia aplikacji wystąpi błąd Apple could not verify , możesz rozwiązać ten błąd przy użyciu następującego polecenia:

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

Na przykład:

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

Analiza podpolecenia

Podpolecenia analyze umożliwia uruchamianie kodu źródłowego i analizy binarnej.

Aby przeanalizować kod źródłowy aplikacji, użyj następującego polecenia:

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

Flaga --input musi wskazywać katalog kodu źródłowego lub plik binarny i --output musi wskazywać katalog w celu przechowywania wyników analizy.

Aby uzyskać więcej informacji na temat flag analizy, użyj następującego polecenia:

Linux/macOS
Windows

./appcat analyze --help

.\appcat.exe analyze --help

Aby sprawdzić dostępne cele dla usługi AppCAT, użyj następującego polecenia:

Linux/macOS
Windows

./appcat analyze --list-targets

.\appcat.exe analyze --list-targets

To polecenie generuje następujące dane wyjściowe:

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

Analizowanie wielu aplikacji

Aplikacja AppCAT obsługuje wiele analiz aplikacji w każdym wykonaniu polecenia. Możesz podać rozdzieloną przecinkami listę ścieżek wejściowych flagi, --input aby analizować wiele aplikacji w jednym poleceniu. Katalog wyjściowy i raport statyczny zawierają połączone wyniki analizy dla wszystkich aplikacji.

Aby przeanalizować wiele aplikacji, użyj następującego polecenia:

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 umożliwia również użycie opcji --bulk, aby przyrostowo dodawać więcej analiz aplikacji do istniejącego katalogu wyjściowego oraz raportu statycznego. W przypadku korzystania z opcji --bulk należy używać jej spójnie we wszystkich wykonaniach poleceń, które zapisują do tego samego wyjścia.

Uwaga

Po podaniu wielu ścieżek wejściowych, --bulk jest włączona domyślnie.

Aby przyrostowo dodać więcej analizy aplikacji do istniejącego raportu statycznego, użyj następującego polecenia:

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>

Przekształć subkomendę

Podpolecenie transform umożliwia przekonwertowanie poprzednich reguł XML appcat stosowanych w wersji 6.x na nowy format YAML używany w obecnej wersji 7.x.

Aby przekształcić reguły, użyj następującego polecenia:

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>

Flaga --input powinna wskazywać plik lub katalog zawierający reguły XML, a flaga --output powinna wskazywać katalog wyjściowy dla przekonwertowanych reguł YAML.

Przykłady

Uwaga

Upewnij się, że uprawnienia do plików dla skryptów w wyodrębnionym folderze są ustawione na zezwalanie na wykonywanie.

W katalogu samples można znaleźć następujące skrypty do uruchamiania różnych typów analizy:

run-assessment: udostępnia raport z oceną kodu i krokami migracji Airsonic do Azure App Service na platformie Tomcat.
run-assessment-transform-rules: Konwertuje reguły XML Windup na reguły YAML zgodne z analizatorem LSP.
run-assessment-custom-rules: udostępnia raport oceny kodu przy użyciu reguł niestandardowych (przekształcanie kodu XML do YAML).
run-assessment-openjdk21: generuje raport z oceną kodu i krokami migracji Airsonic do openJDK 21.
run-assessment-package-only: tworzy raport, oceniając określone pakiety.

Te skrypty mają być używane z projektem przykładowym Airsonic-Advanced — opartym na społeczności, internetowym streamerze multimediów, który umożliwia dostęp do kolekcji muzyki i udostępnianie jej.

Repozytorium aplikacji można sklonować ręcznie przy użyciu następującego polecenia:

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

Po sklonowaniu podaj ścieżkę do sklonowanego folderu podczas uruchamiania skryptów oceny. W zależności od systemu operacyjnego uruchom odpowiedni skrypt, jak pokazano w poniższym przykładzie:

Uwaga

Upewnij się, że sklonowałeś projekt Airsonic Advanced do ścieżki lokalnej przed uruchomieniem skryptów.

Linux/macOS
Windows

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

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

Raporty są generowane i uruchamiane automatycznie. Raporty można znaleźć w obszarze .. /samples/report-* (Linux/macOS) lub .. \samples\report-* (Windows).

Podsumowanie analizy

Strona docelowa raportu przedstawia widok podsumowania wszystkich analizowanych aplikacji. W tym miejscu możesz przejść do poszczególnych raportów aplikacji, aby zapoznać się ze szczegółowymi ustaleniami.

Przycisk Ask Copilot (Zapytaj copilot ) w prawym górnym rogu przekierowuje Cię do rozszerzenia GitHub Copilot App Modernization for Java w programie Visual Studio Code. To rozszerzenie zapewnia zarówno ocenę aplikacji, jak i korygowanie kodu jako kluczowe możliwości migracji aplikacji Java na platformę Azure — obsługiwane przez aplikacje AppCAT i możliwości sztucznej inteligencji w usłudze GitHub Copilot.

Raport z oceny

Raport oceny zawiera listę problemów podzielonych na kategorie różnych aspektów gotowości na platformę Azure, natywnych dla chmury i modernizacji języka Java, które należy rozwiązać, aby pomyślnie przeprowadzić migrację aplikacji na platformę Azure.

Każdy problem jest klasyfikowany według ważności — obowiązkowe, opcjonalne lub potencjalne — i zawiera liczbę wierszy kodu, których dotyczy problem.

Na karcie Zależności i technologie są wyświetlane biblioteki i technologie używane w aplikacji.

Szczegółowe informacje dotyczące konkretnego problemu

W przypadku każdego problemu możesz uzyskać więcej informacji (szczegóły problemu, zawartość reguły itd.), wybierając ją. Zostanie również wyświetlona lista wszystkich plików, których dotyczy ten problem.

Następnie dla każdego pliku lub klasy, której dotyczy problem, możesz przejść do kodu źródłowego, aby wyróżnić wiersz kodu, który utworzył problem.