Azure Migrate-toepassings- en code-evaluatie voor Java-versie 7 (preview)

2025-06-12

Notitie

Dit artikel is bedoeld voor de volgende generatie Azure Migrate-toepassings- en code-evaluatie voor Java, versie 7.x. Deze versie is in voorbeeldweergave. Voor de vorige stabiele versie, versie 6.x, raadpleegt u de Azure Migrate-toepassing en code-evaluatie voor Java.

In dit artikel leest u hoe u het azure Migrate-toepassings- en code-evaluatieprogramma voor Java gebruikt om elk type Java-toepassing te evalueren en opnieuw te platformen. Met het hulpprogramma kunt u de gereedheid van toepassingen evalueren voor het opnieuw platformen en migreren naar Azure. Dit hulpprogramma wordt aangeboden als een opdrachtregelinterface (CLI) en evalueert binaire java-toepassingsbestanden en broncode om herplatforming en migratiemogelijkheden voor Azure te identificeren. Hiermee kunt u grootschalige Java-toepassingen moderniseren en opnieuw platformen door veelvoorkomende use cases en codepatronen te identificeren en aanbevolen wijzigingen voor te stellen.

Het hulpprogramma detecteert het gebruik van toepassingstechnologie via statische codeanalyse, levert een schatting van de inspanningen en versnelt het overzetten van code naar nieuwe platforms. Deze evaluatie helpt u bij het prioriteren en verplaatsen van Java-toepassingen naar Azure. Met een set engines en regels kan het hulpprogramma verschillende technologieën ontdekken en beoordelen, zoals Java 11, Java 17, Jakarta EE, Spring, Sluimerstand, Java Message Service (JMS) en meer. Het hulpprogramma helpt u vervolgens de Java-toepassing te migreren naar verschillende Azure-doelen - Azure App Service, Azure Kubernetes Service en Azure Container Apps - met specifieke herplatformingsregels voor Azure.

Het hulpprogramma is gebaseerd op een set onderdelen in het Cloud Native Computing Foundation-project Konveyor, gemaakt en geleid door Red Hat.

Overzicht

Het hulpprogramma is ontworpen om organisaties te helpen hun Java-toepassingen te moderniseren op een manier die de kosten verlaagt en snellere innovatie mogelijk maakt. Het hulpprogramma maakt gebruik van geavanceerde analysetechnieken om inzicht te hebben in de structuur en afhankelijkheden van elke Java-toepassing en biedt richtlijnen voor het herstructureren en migreren van de toepassingen naar Azure.

Hiermee kunt u de volgende taken uitvoeren:

Ontdek technologiegebruik: snel zien welke technologieën een toepassing gebruikt. Detectie is handig als u verouderde toepassingen hebt met niet veel documentatie en wilt weten welke technologieën ze gebruiken.
Evalueer de code naar een specifiek doel: Evalueer een toepassing voor een specifiek Azure-doel. Controleer de inspanningen en de wijzigingen die u moet uitvoeren om uw toepassingen opnieuw te platformen naar Azure.

Ondersteunde doelen

Het hulpprogramma bevat regels voor het opnieuw platformen van uw toepassingen, zodat u verschillende Azure-services kunt implementeren en gebruiken.

De regels die worden gebruikt door azure Migrate-toepassings- en code-evaluatie, worden gegroepeerd op basis van een doel. Een doel is waar of hoe de toepassing wordt uitgevoerd, en algemene behoeften en verwachtingen. Bij het beoordelen van een toepassing kunt u meerdere doelen kiezen. In de volgende tabel worden de beschikbare doelen beschreven:

Doelnaam	Beschrijving	Doel
Azure App Service	Aanbevolen procedures voor het implementeren van een app in Azure-app Service.	`azure-appservice`
Azure Kubernetes Service	Aanbevolen procedures voor het implementeren van een app in Azure Kubernetes Service.	`azure-aks`
Azure Container Apps - een dienst van Microsoft waarmee je containers kunt uitvoeren en beheren in de cloud.	Aanbevolen procedures voor het implementeren van een app in Azure Container Apps.	`azure-container-apps`
Gereedheid voor de cloud	Algemene aanbevolen procedures voor het voorbereiden van een toepassingscloud (Azure).	`cloud-readiness`
Linux	Algemene aanbevolen procedures voor het voorbereiden van een toepassing op Linux.	`linux`
OpenJDK 11	Algemene aanbevolen procedures voor het uitvoeren van een Java 8-toepassing met Java 11.	`openjdk11`
OpenJDK 17	Algemene aanbevolen procedures voor het uitvoeren van een Java 11-toepassing met Java 17.	`openjdk17`
OpenJDK 21	Algemene aanbevolen procedures voor het uitvoeren van een Java 17-toepassing met Java 21.	`openjdk21`

Wanneer het hulpprogramma beoordeelt op gereedheid voor de cloud en gerelateerde Azure-services, kan het ook nuttige informatie rapporteren voor mogelijk gebruik van verschillende Azure-services. In de volgende lijst ziet u een aantal van de services die worden behandeld:

Azure-databases
Azure Service Bus (een cloud-gebaseerde berichtendienst van Microsoft)
Azure-opslag
Azure-netwerk voor contentlevering
Azure Event Hubs
Azure Key Vault
Azure Front Door (een cloudgebaseerde dienst voor netwerkbeveiliging en contentlevering)

Downloaden en installeren

Als u de appcat CLI wilt gebruiken, moet u het pakket downloaden dat specifiek is voor uw omgeving en over de vereiste afhankelijkheden in uw omgeving beschikken. De appcat CLI wordt uitgevoerd op elke omgeving, zoals Windows, Linux of Mac, met behulp van Intel-, Arm- of Apple Silicon-hardware. Voor de JDK-vereiste raden we u aan de Microsoft Build van OpenJDK te gebruiken.

besturingssysteem	Architectuur	Downloadlink	Andere bestanden
x64
Ramen	x64	Downloaden	sha256 / Sig
macOS	x64	Downloaden	sha256 / Sig
Linux	x64	Downloaden	sha256 / Sig
AArch64
Ramen	AArch64 / ARM64	Downloaden	sha256 / Sig
macOS	Apple Silicon	Downloaden	sha256 / Sig
Linux	AArch64 / ARM64	Downloaden	sha256 / Sig

Vereiste voorwaarden

Download en installeer Microsoft Build van OpenJDK 17. Zorg ervoor dat de JAVA_HOME omgevingsvariabele is ingesteld.

AppCAT installeren

Als u wilt installeren appcat, downloadt u het juiste zip-bestand voor uw platform. Nadat u het bestand hebt gedownload, moet u, afhankelijk van uw besturingssysteem, een .tar.gz (Linux/macOS) of .zip -bestand (Windows) vinden.

Pak het binaire bestand uit het gedownloade bestand. U ziet nu de volgende mapstructuur:

/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 uitvoeren

Als u wilt uitvoeren appcat vanaf elke locatie in uw terminal, extraheert u het archief naar de gewenste locatie. Werk vervolgens de PATH omgevingsvariabele bij zodat deze de map bevat waarin u het archief hebt uitgepakt.

Notitie

Wanneer het appcat binaire bestand wordt aangeroepen, wordt eerst gezocht naar de afhankelijkheden in de uitvoerbare map die is opgegeven in de PATH omgevingsvariabele. Als de afhankelijkheden niet worden gevonden, valt deze terug naar de basismap van de gebruiker - ~/.appcat op Linux/Mac of %USERPROFILE%\.appcat in Windows.

Gebruik

Subopdrachten

AppCAT biedt twee subopdrachten voor gebruik:

analyze: Voer broncodeanalyse uit op invoerbroncode of een binair bestand.
transform: XML-regels van vorige versies (6 en ouder) converteren naar YAML-indeling die door deze versie wordt gebruikt.

Notitie

Voor macOS-gebruikers: als er een fout optreedt die aangeeft Apple could not verify wanneer u de app probeert uit te voeren, kunt u deze fout oplossen met behulp van de volgende opdracht:

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

Voorbeeld:

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

Subopdracht analyseren

Met de analyze subopdracht kunt u broncode en binaire analyse uitvoeren.

Gebruik de volgende opdracht om de broncode van de toepassing te analyseren:

Linux/macOS
Ramen

./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

De --input vlag moet verwijzen naar een broncodemap of een binair bestand en --output moet verwijzen naar een map om de analyseresultaten op te slaan.

Gebruik de volgende opdracht voor meer informatie over de analysevlagmen:

Linux/macOS
Ramen

./appcat analyze --help

.\appcat.exe analyze --help

Gebruik de volgende opdracht om de beschikbare doelen voor AppCAT te controleren:

Linux/macOS
Ramen

./appcat analyze --list-targets

.\appcat.exe analyze --list-targets

Met deze opdracht wordt de volgende uitvoer gegenereerd:

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

Meerdere toepassingen analyseren

AppCAT ondersteunt meerdere toepassingsanalyses in uitvoering per opdracht. U kunt een door komma's gescheiden lijst met invoerpaden opgeven voor de --input vlag om meerdere toepassingen in één opdracht te analyseren. De uitvoermap en het statische rapport bevatten de gecombineerde analyseresultaten voor alle toepassingen.

Gebruik de volgende opdracht om meerdere toepassingen te analyseren:

Linux/macOS
Ramen

./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>

Met AppCAT kunt u ook de optie gebruiken --bulk om incrementeel meer toepassingsanalyse toe te voegen aan een bestaande uitvoermap en statisch rapport. Wanneer u de --bulk optie gebruikt, moet u deze consistent gebruiken voor alle uitvoeringen van opdrachten die naar dezelfde uitvoer schrijven.

Notitie

Wanneer u meerdere invoerpaden opgeeft, --bulk is deze standaard ingeschakeld.

Als u incrementeel meer toepassingsanalyse wilt toevoegen aan een bestaand statisch rapport, gebruikt u de volgende opdracht:

Linux/macOS
Ramen

./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>

Subopdracht transformeren

transform Met de subopdracht kunt u de vorige appcat XML-regels die in de 6.x-versie worden gebruikt, converteren naar de nieuwe YAML-indeling die door deze versie 7.x wordt gebruikt.

Gebruik de volgende opdracht om regels te transformeren:

Linux/macOS
Ramen

./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>

De --input vlag moet verwijzen naar een bestand of map met XML-regels en de --output vlag moet verwijzen naar de uitvoermap voor de geconverteerde YAML-regels.

Voorbeelden

Notitie

Zorg ervoor dat de bestandsmachtigingen voor scripts in de uitgepakte map zijn ingesteld om uitvoering toe te staan.

In de map met voorbeelden vindt u de volgende scripts om verschillende soorten analyse uit te voeren:

run-assessment: biedt een rapport met code-evaluatie en stappen voor het migreren van Airsonic naar Azure App Service op Tomcat.
run-assessment-transform-rules: Converteert Windup XML-regels naar yamL-regels die compatibel zijn met analyzer-lsp.
run-assessment-custom-rules: biedt een code-evaluatierapport met behulp van aangepaste regels (XML transformeren naar YAML).
run-assessment-openjdk21: genereert een rapport met code-evaluatie en stappen voor het migreren van Airsonic naar OpenJDK 21.
run-assessment-package-only: Produceert een rapport door specifieke pakketten te beoordelen.

Deze scripts zijn bedoeld om te worden gebruikt met het Airsonic-Advanced-voorbeeldproject : een communitygestuurde, webmediastreamer waarmee u toegang kunt krijgen tot uw muziekverzameling en deze kunt delen.

U kunt de toepassingsopslagplaats handmatig klonen met behulp van de volgende opdracht:

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

Geef na het klonen het pad op naar de gekloonde map bij het uitvoeren van de evaluatiescripts. Voer, afhankelijk van uw besturingssysteem, het juiste script uit, zoals wordt weergegeven in het volgende voorbeeld:

Notitie

Zorg ervoor dat u het Airsonic Advanced-project hebt gekloond naar een lokaal pad voordat u de scripts uitvoert.

Linux/macOS
Ramen

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

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

De rapporten worden automatisch gegenereerd en gestart. U vindt de rapporten onder .. /samples/report-* (Linux/macOS) of .. \samples\report-* (Windows).

Samenvatting van de analyse

De landingspagina van het rapport geeft een overzichtsweergave weer van alle geanalyseerde toepassingen. Hier kunt u navigeren naar afzonderlijke toepassingsrapporten om gedetailleerde bevindingen te verkennen.

Met de knop Ask Copilot in de rechterbovenhoek wordt u omgeleid naar de GitHub Copilot App Modernization for Java-extensie in Visual Studio Code. Deze extensie biedt zowel app-evaluatie als codeherstel als de belangrijkste mogelijkheden voor het migreren van Java-toepassingen naar Azure, mogelijk gemaakt door de AI-mogelijkheden van AppCAT en GitHub Copilot.

Evaluatierapport

Het evaluatierapport bevat een gecategoriseerde lijst met problemen met verschillende aspecten van Azure-gereedheid, cloudeigen en Java-modernisering die u moet aanpakken om de toepassing naar Azure te migreren.

Elk probleem wordt gecategoriseerd naar ernstigheid - verplicht, optioneel of potentieel - en bevat het aantal getroffen regels code.

Op de tabbladen Afhankelijkheden en Technologieën worden de bibliotheken en technologieën weergegeven die in de toepassing worden gebruikt.

Gedetailleerde informatie voor een specifiek probleem

Voor elk probleem krijgt u meer informatie (de details van het probleem, de inhoud van de regel, enzovoort) door deze te selecteren. U krijgt ook de lijst met alle bestanden die worden beïnvloed door dit probleem.

Vervolgens kunt u voor elk bestand of elke klasse die wordt beïnvloed door het probleem, naar de broncode springen om de coderegel te markeren die het probleem heeft gemaakt.