Azure Migrate-program och kodutvärdering för Java version 7 (förhandsversion)

2025-06-12

Kommentar

Den här artikeln gäller nästa generations Azure Migrate-program och kodutvärdering för Java, version 7.x. Den här versionen är i förhandsversion. För den tidigare stabila versionen, version 6.x, se Azure Migrate-applikationer och kodutvärdering för Java.

Den här artikeln visar hur du använder Azure Migrate-programmet och kodutvärderingsverktyget för Java för att utvärdera och omplatforma alla typer av Java-program. Med verktyget kan du utvärdera programberedskapen för omplatformning och migrering till Azure. Det här verktyget erbjuds som ett kommandoradsgränssnitt (CLI) och utvärderar Java-programbinärfiler och källkod för att identifiera omplatformnings- och migreringsmöjligheter för Azure. Det hjälper dig att modernisera och omplatforma storskaliga Java-program genom att identifiera vanliga användningsfall och kodmönster och föreslå rekommenderade ändringar.

Verktyget identifierar användning av programteknik via statisk kodanalys, ger uppskattning av arbete och påskyndar kodomläggning. Den här utvärderingen hjälper dig att prioritera och flytta Java-program till Azure. Med en uppsättning motorer och regler kan verktyget identifiera och utvärdera olika tekniker som Java 11, Java 17, Jakarta EE, Spring, Hibernate, Java Message Service (JMS) med mera. Verktyget hjälper dig sedan att omplatforma Java-programmet till olika Azure-mål – Azure App Service, Azure Kubernetes Service och Azure Container Apps – med specifika Azure-omplatformningsregler.

Verktyget baseras på en uppsättning komponenter i Cloud Native Computing Foundation-projektet Konveyor, som skapats och leds av Red Hat.

Översikt

Verktyget är utformat för att hjälpa organisationer att modernisera sina Java-program på ett sätt som minskar kostnaderna och möjliggör snabbare innovation. Verktyget använder avancerade analystekniker för att förstå strukturen och beroendena för alla Java-program och ger vägledning om hur du omstrukturerar och migrerar programmen till Azure.

Med den kan du utföra följande uppgifter:

Identifiera teknikanvändning: Se snabbt vilka tekniker ett program använder. Upptäckt är användbart om du har äldre applikationer med begränsad dokumentation och vill veta vilka teknologier de använder.
Utvärdera koden till ett specifikt mål: Utvärdera ett program för ett specifikt Azure-mål. Kontrollera arbetet och de ändringar du måste göra för att omplatforma dina program till Azure.

Mål som stöds

Verktyget innehåller regler som hjälper dig att formatera om dina program så att du kan distribuera till och använda olika Azure-tjänster.

De regler som används av Azure Migrate-programmet och kodutvärderingen grupperas baserat på ett mål. Ett mål är var eller hur programmet körs och allmänna behov och förväntningar. När du utvärderar ett program kan du välja flera mål. I följande tabell beskrivs tillgängliga mål:

Målnamn	beskrivning	Mål
Служб	Metodtips för att distribuera en app till Azure App Service.	`azure-appservice`
Azure Kubernetes Service	Metodtips för att distribuera en app till Azure Kubernetes Service.	`azure-aks`
Azure Container-applikationer	Metodtips för att distribuera en app till Azure Container Apps.	`azure-container-apps`
Molnberedskap	Allmänna metodtips för att göra ett programmoln (Azure) redo.	`cloud-readiness`
Linux	Allmänna metodtips för att göra ett program i Linux redo.	`linux`
OpenJDK 11	Allmänna metodtips för att köra ett Java 8-program med Java 11.	`openjdk11`
OpenJDK 17	Allmänna metodtips för att köra ett Java 11-program med Java 17.	`openjdk17`
OpenJDK 21	Allmänna metodtips för att köra ett Java 17-program med Java 21.	`openjdk21`

När verktyget utvärderas för molnberedskap och relaterade Azure-tjänster kan det också rapportera användbar information för potentiell användning av olika Azure-tjänster. I följande lista visas några av de tjänster som omfattas:

Azure-databaser
Azure Service Bus (Azure-tjänstbuss)
Azure Storage
Azure Content Delivery Network
Azure Event Hubs
Azure 密钥保管库
Azure Front Door-tjänsten

Ladda ned och installera

Om du vill använda appcat CLI måste du ladda ned paketet som är specifikt för din miljö och ha de beroenden som krävs i din miljö. appcat CLI körs i alla miljöer, till exempel Windows, Linux eller Mac, med intel, arm eller Apple Silicon-maskinvara. För JDK-kravet rekommenderar vi att du använder Microsoft Build of OpenJDK.

Olympiska Spelen (OS)	Arkitektur	Ladda ned länk	Andra filer
x64
Windows	x64	Ladda ned	sha256 / sig
macOS	x64	Ladda ned	sha256 / sig
Linux	x64	Ladda ned	sha256 / sig
AArch64
Windows	AArch64 / ARM64	Ladda ned	sha256 / sig
macOS	Apple Silicon	Ladda ned	sha256 / sig
Linux	AArch64 / ARM64	Ladda ned	sha256 / sig

Förutsättningar

Ladda ned och installera Microsoft Build of OpenJDK 17. Kontrollera att JAVA_HOME miljövariabeln har angetts.

Installera AppCAT

Om du vill installera appcatladdar du ned lämplig zip-fil för din plattform. När du har laddat ned filen bör du, beroende på ditt operativsystem, antingen hitta en .tar.gz (Linux/macOS) eller .zip fil (Windows).

Extrahera binärfilen från den nedladdade filen. Du bör se följande mappstruktur:

/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

Kör AppCAT

Om du vill köra appcat från valfri plats i terminalen extraherar du arkivet till önskad plats. Uppdatera PATH sedan miljövariabeln så att den innehåller katalogen där du extraherade arkivet.

Kommentar

När binärfilen appcat anropas letar den först efter dess beroenden i den körbara mappen som anges i PATH miljövariabeln. Om beroendena inte hittas återgår det till användarens hemkatalog – ~/.appcat på Linux/Mac eller %USERPROFILE%\.appcat i Windows.

Förbrukning

Underkommandon

AppCAT tillhandahåller två underkommandon för användning:

analyze: Kör källkodsanalys på indatakällans kod eller en binär fil.
transform: Konvertera XML-regler från tidigare versioner (6 och äldre) till YAML-format som används av den här versionen.

Kommentar

För macOS-användare: Om du stöter på ett fel som anger Apple could not verify när du försöker köra appen kan du lösa det här felet med hjälp av följande kommando:

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

Till exempel:

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

Analysera underkommando

Med analyze underkommandot kan du köra källkod och binär analys.

Om du vill analysera programkällkoden använder du följande kommando:

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

Flaggan --input måste peka på en källkodskatalog eller en binär fil och --output måste peka på en katalog för att lagra analysresultaten.

Om du vill ha mer information om analysflaggor använder du följande kommando:

Linux/macOS
Windows

./appcat analyze --help

.\appcat.exe analyze --help

Om du vill kontrollera tillgängliga mål för AppCAT använder du följande kommando:

Linux/macOS
Windows

./appcat analyze --list-targets

.\appcat.exe analyze --list-targets

Det här kommandot genererar följande utdata:

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

Analysera flera program

AppCAT stöder flera programanalyser per kommandokörning. Du kan ange en kommaavgränsad lista över indatasökvägar för --input-flaggan att analysera flera program i ett enda kommando. Utdatakatalogen och den statiska rapporten innehåller de kombinerade analysresultaten för alla program.

Om du vill analysera flera program använder du följande kommando:

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>

Med AppCAT kan du också använda --bulk alternativet för att stegvis lägga till mer programanalys i en befintlig utdatakatalog och statisk rapport. När du använder --bulk alternativet måste du använda det konsekvent för alla kommandokörningar som skriver till samma utdata.

Kommentar

När du anger flera indatasökvägar aktiveras --bulk som standard.

Om du vill lägga till mer programanalys i en befintlig statisk rapport stegvis använder du följande kommando:

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>

Transformera underkommando

Med transform underkommandot kan du konvertera tidigare appcat XML-regler som används i 6.x-versionen till det nya YAML-format som används av den här versionen 7.x.

Om du vill transformera regler använder du följande kommando:

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>

Flaggan --input ska peka på en fil eller katalog som innehåller XML-regler och --output flaggan ska peka på utdatakatalogen för de konverterade YAML-reglerna.

Exempel

Kommentar

Kontrollera att filbehörigheterna för skript i den extraherade mappen är inställda för att tillåta att skript kan köras.

I exempelkatalogen hittar du följande skript för att köra olika typer av analys:

run-assessment: Tillhandahåller en rapport med kodutvärdering och steg för migrering av Airsonic till Azure App Service på Tomcat.
run-assessment-transform-rules: Konverterar Windup XML-regler till analyzer-lsp-kompatibla YAML-regler.
run-assessment-custom-rules: Tillhandahåller en kodutvärderingsrapport med anpassade regler (transformera XML till YAML).
run-assessment-openjdk21: Genererar en rapport med kodutvärdering och steg för migrering av Airsonic till OpenJDK 21.
endast run-assessment-package: Skapar en rapport genom att utvärdera specifika paket.

Dessa skript är avsedda att användas med Airsonic-Advanced-exempelprojektet – en communitydriven, webbaserad medieström som gör att du kan komma åt och dela din musiksamling.

Du kan klona programlagringsplatsen manuellt med följande kommando:

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

Efter kloning anger du sökvägen till den klonade mappen när du kör utvärderingsskripten. Beroende på ditt operativsystem kör du rätt skript, som du ser i följande exempel:

Kommentar

Kontrollera att du har klonat Airsonic Advanced-projektet till en lokal sökväg innan du kör skripten.

Linux/macOS
Windows

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

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

Rapporterna genereras och startas automatiskt. Du hittar rapporterna under .. /samples/report-* (Linux/macOS) eller .. \samples\report-* (Windows).

Sammanfattning av analysen

Rapportens landningssida visar en sammanfattningsvy över alla analyserade program. Härifrån kan du gå till enskilda programrapporter för att utforska detaljerade resultat.

Knappen Fråga Copilot i det övre högra hörnet omdirigerar dig till GitHub Copilot App Modernization for Java-tillägget i Visual Studio Code. Det här tillägget tillhandahåller både apputvärdering och kodreparation som viktiga funktioner för att migrera Java-program till Azure – som drivs av AppCAT och GitHub Copilots AI-funktioner.

Utvärderingsrapport

Utvärderingsrapporten innehåller en kategoriserad problemlista över olika aspekter av Azure-beredskap, molnbaserad och Java-modernisering som du behöver åtgärda för att migrera programmet till Azure.

Varje problem kategoriseras efter allvarlighetsgrad – obligatoriskt, valfritt eller potentiellt – och innehåller antalet påverkade kodrader.

Flikarna Beroenden och Tekniker visar de bibliotek och tekniker som används i programmet.

Detaljerad information om ett specifikt problem

För varje problem kan du få mer information (probleminformationen, innehållet i regeln och så vidare) bara genom att välja den. Du får också en lista över alla filer som påverkas av det här problemet.

För varje fil eller klass som påverkas av problemet kan du sedan gå in i källkoden för att markera den kodrad som skapade problemet.