Aplikace Azure Migrate a posouzení kódu pro Javu verze 7 (Preview)

Poznámka:

Tento článek je určený pro novou generaci aplikace Azure Migrate a posouzení kódu pro Javu verze 7.x. Tato verze je ve verzi Preview. Předchozí stabilní verzi verze 6.x najdete v tématu o aplikaci Azure Migrate a posouzení kódu pro Javu.

V tomto článku se dozvíte, jak pomocí nástroje pro posouzení kódu a aplikace Azure Migrate pro Javu vyhodnotit a znovu vytvořit jakýkoli typ aplikace v Javě. Nástroj umožňuje vyhodnotit připravenost aplikací na opětovné vytvoření a migraci do Azure. Tento nástroj se nabízí jako rozhraní příkazového řádku (CLI) a vyhodnocuje binární soubory aplikací v Javě a zdrojový kód k identifikaci příležitostí k přeformulování a migraci pro Azure. Pomáhá modernizovat a znovu vytvářet rozsáhlé aplikace v Javě tím, že identifikuje běžné případy použití a vzory kódu a navrhuje doporučené změny.

Nástroj zjišťuje využití aplikačních technologií prostřednictvím statické analýzy kódu, poskytuje odhad úsilí a urychluje přeformulování kódu. Toto posouzení vám pomůže určit prioritu a přesunout aplikace v Javě do Azure. Díky sadě modulů a pravidel může nástroj objevit a posoudit různé technologie, jako je Java 11, Java 17, Jakarta EE, Spring, Hibernate, Java Message Service (JMS) a další. Nástroj vám pak pomůže znovu vytvořit aplikaci v Javě na různé cíle Azure – Aplikace Azure Service, Azure Kubernetes Service a Azure Container Apps – s konkrétními pravidly přeplatformování Azure.

Tento nástroj je založený na sadě komponent v projektu Konveyor, který vytvořil a vedl Red Hat.

Přehled

Tento nástroj je navržený tak, aby organizacím pomohl modernizovat své aplikace v Javě způsobem, který snižuje náklady a umožňuje rychlejší inovace. Nástroj používá pokročilé techniky analýzy k pochopení struktury a závislostí jakékoli aplikace v Javě a poskytuje pokyny k refaktoringu a migraci aplikací do Azure.

S ním můžete provádět následující úlohy:

Objevte využití technologií: Rychle zjistíte, které technologie aplikace používá. Zjišťování je užitečné, pokud máte starší verze aplikací, které nemají moc dokumentace, a chcete vědět, které technologie používají.
Posouzení kódu pro konkrétní cíl: Posouzení aplikace pro konkrétní cíl Azure Zkontrolujte úsilí a změny, které je potřeba udělat k opětovnému vytvoření aplikací do Azure.

Podporované cíle

Nástroj obsahuje pravidla, která vám pomůžou znovu vytvořit aplikace, abyste mohli nasazovat a používat různé služby Azure.

Pravidla používaná aplikací Azure Migrate a posouzením kódu se seskupují podle cíle. Cílem je umístění nebo způsob spuštění aplikace a obecné potřeby a očekávání. Při posuzování aplikace můžete zvolit více cílů. Následující tabulka popisuje dostupné cíle:

Cílový název	Popis	Cíl
Azure App Service	Osvědčené postupy pro nasazení aplikace do služby Aplikace Azure Service	`azure-appservice`
Azure Kubernetes Service	Osvědčené postupy pro nasazení aplikace do služby Azure Kubernetes Service	`azure-aks`
Azure Container Apps (aplikace pro kontejnery)	Osvědčené postupy pro nasazení aplikace do Azure Container Apps	`azure-container-apps`
Připravenost na cloud	Obecné osvědčené postupy pro připravenost aplikačního cloudu (Azure)	`cloud-readiness`
Operační systém Linux	Obecné osvědčené postupy pro vytvoření aplikace pro Linux	`linux`
OpenJDK 11	Obecné osvědčené postupy pro spuštění aplikace Java 8 s Javou 11	`openjdk11`
OpenJDK 17	Obecné osvědčené postupy pro spuštění aplikace Java 11 s Javou 17	`openjdk17`
OpenJDK 21	Obecné osvědčené postupy pro spuštění aplikace Java 17 s Javou 21	`openjdk21`

Když nástroj vyhodnotí připravenost na cloud a související služby Azure, může také hlásit užitečné informace pro potenciální využití různých služeb Azure. Následující seznam obsahuje několik zahrnutých služeb:

Databáze Azure
Azure Service Bus (služba pro správu a směrování zpráv)
Azure Storage
Síť pro doručování obsahu Azure
Azure Event Hubs
Azure Key Vault
Azure Front Door (přední dveře Azure)

Stažení a instalace

Pokud chcete použít rozhraní příkazového appcat řádku, musíte stáhnout balíček specifický pro vaše prostředí a mít požadované závislosti ve vašem prostředí. Rozhraní appcat příkazového řádku běží v libovolném prostředí, jako je Windows, Linux nebo Mac, pomocí hardwaru Intel, Arm nebo Apple Silicon. Ohledně požadavků na JDK doporučujeme použít Microsoft Build pro OpenJDK.

Operační systém	Architektura	Odkaz ke stažení	Další soubory
x64
Windows	Procesor x64	Stáhnout	sha256 / Sig
macOS	Procesor x64	Stáhnout	sha256 / Sig
Operační systém Linux	Procesor x64	Stáhnout	sha256 / Sig
AArch64
Windows	AArch64 / ARM64	Stáhnout	sha256 / Sig
macOS	Apple Silicon	Stáhnout	sha256 / Sig
Operační systém Linux	AArch64 / ARM64	Stáhnout	sha256 / Sig

Požadavky

Stáhněte a nainstalujte Microsoft Build openJDK 17. Ujistěte se, že proměnná prostředí JAVA_HOME je nastavena.

Nainstalujte AppCAT

Pokud chcete nainstalovat appcat, stáhněte si příslušný soubor ZIP pro vaši platformu. Po stažení souboru v závislosti na operačním systému byste měli najít soubor .tar.gz (Linux/macOS) nebo soubor.zip (Windows).

Extrahujte binární soubor ze staženého souboru. Měla by se zobrazit následující struktura složek:

/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

Spuštění AppCAT

Pokud chcete spustit appcat z libovolného umístění v terminálu, extrahujte archiv do požadovaného umístění. Potom aktualizujte proměnnou PATH prostředí tak, aby zahrnovala adresář, do kterého jste extrahovali archiv.

Poznámka:

Při zavolání binárního appcat souboru nejprve vyhledá závislosti ve spustitelné složce zadané v PATH proměnné prostředí. Pokud se závislosti nenajdou, vrátí se do domovského adresáře uživatele – ~/.appcat v Linuxu nebo Mac nebo %USERPROFILE%\.appcat ve Windows.

Využití

Podpříkazy

AppCAT poskytuje dva dílčí příkazy pro použití:

analyze: Spusťte analýzu zdrojového kódu u vstupního zdrojového kódu nebo binárního souboru.
transform: Převeďte pravidla XML z předchozích verzí (6 a starších) na formát YAML používaný touto verzí.

Poznámka:

Pro uživatele macOS: Pokud při pokusu o spuštění aplikace dojde k chybě Apple could not verify , můžete tuto chybu vyřešit pomocí následujícího příkazu:

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

Příklad:

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

Analýza podpříkazu

Podpříkaz analyze umožňuje spustit zdrojový kód a binární analýzu.

Pokud chcete analyzovat zdrojový kód aplikace, použijte následující příkaz:

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

Příznak --input musí odkazovat na adresář zdrojového kódu nebo binární soubor a --output musí odkazovat na adresář pro uložení výsledků analýzy.

Další informace o příznakech analýzy najdete v následujícím příkazu:

Linux / macOS
Windows

./appcat analyze --help

.\appcat.exe analyze --help

Pokud chcete zkontrolovat dostupné cíle pro AppCAT, použijte následující příkaz:

Linux / macOS
Windows

./appcat analyze --list-targets

.\appcat.exe analyze --list-targets

Tento příkaz vytvoří následující výstup:

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

Analýza více aplikací

AppCAT podporuje více analýz aplikací v jednotlivých spuštěních příkazů. Můžete zadat čárkami oddělený seznam vstupních cest příznaku --input k analýze více aplikací v jednom příkazu. Výstupní adresář a statická sestava zahrnují výsledky kombinované analýzy všech aplikací.

Pokud chcete analyzovat více aplikací, použijte následující příkaz:

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 také umožňuje použít možnost --bulk pro postupné přidávání dalších analýz aplikace do existujícího výstupního adresáře a statické zprávy. Když použijete --bulk tuto možnost, musíte ji používat konzistentně ve všech spuštěních příkazů, které zapisují do stejného výstupu.

Poznámka:

Pokud zadáte více vstupních cest, --bulk je ve výchozím nastavení povolená.

Pokud chcete přírůstkově přidat další analýzu aplikace do existující statické sestavy, použijte následující příkaz:

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>

Transformovat podpříkaz

Podpříkaz transform umožňuje převést předchozí appcat pravidla XML použitá ve verzi 6.x do nového formátu YAML používaného touto verzí 7.x.

K transformaci pravidel použijte následující příkaz:

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>

Příznak --input by měl odkazovat na soubor nebo adresář obsahující pravidla XML a --output příznak by měl odkazovat na výstupní adresář pro převedená pravidla YAML.

Ukázky

Poznámka:

Ujistěte se, že jsou oprávnění k souborům pro skripty v extrahované složce nastavená tak, aby povolovala provádění.

V adresáři ukázek najdete následující skripty pro spuštění různých typů analýzy:

run-assessment: Poskytuje zprávu s hodnocením kódu a kroky pro migraci Airsonic do služby Azure App Service na serveru Tomcat.
run-assessment-transform-rules: Převede pravidla XML aplikace Windup na pravidla YAML kompatibilní s analyzátorem lsp.
run-assessment-custom-rules: Poskytuje sestavu posouzení kódu pomocí vlastních pravidel (transformace XML na YAML).
run-assessment-openjdk21: Vygeneruje sestavu s posouzením kódu a kroky pro migraci Airsonic na OpenJDK 21.
run-assessment-package-only: Vytvoří sestavu vyhodnocením konkrétních balíčků.

Tyto skripty jsou určeny k použití s ukázkovým projektem Airsonic-Advanced – komunitním webovým streamerem médií, který umožňuje přístup ke kolekci hudby a jejich sdílení.

Úložiště aplikace můžete naklonovat ručně pomocí následujícího příkazu:

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

Po klonování zadejte cestu ke naklonované složce při spuštění skriptů posouzení. V závislosti na operačním systému spusťte příslušný skript, jak je znázorněno v následujícím příkladu:

Poznámka:

Před spuštěním skriptů se ujistěte, že jste naklonovali projekt Airsonic Advanced do místní cesty.

Linux / macOS
Windows

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

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

Sestavy se automaticky vygenerují a spustí. Sestavy najdete v části .. /samples/report-* (Linux/macOS) nebo .. \samples\report-* (Windows).

Shrnutí analýzy

Úvodní stránka sestavy představuje souhrnné zobrazení všech analyzovaných aplikací. Odtud můžete přejít na jednotlivé reporty aplikací a prozkoumat podrobná zjištění.

Tlačítko Ask Copilot v pravém horním rohu vás přesměruje na rozšíření GitHub Copilot App Modernization for Java v editoru Visual Studio Code. Toto rozšíření poskytuje posouzení aplikací i nápravu kódu jako své klíčové funkce pro migraci aplikací v Javě do Azure – využívá appCAT a možnosti AI GitHub Copilotu.

Sestava posouzení

Sestava posouzení poskytuje seznam problémů zařazených do kategorií s různými aspekty připravenosti Azure, nativního cloudu a modernizace Javy, které potřebujete vyřešit, abyste mohli úspěšně migrovat aplikaci do Azure.

Každý problém je zařazený do kategorií podle závažnosti – povinné, volitelné nebo potenciální – a zahrnuje počet ovlivněných řádků kódu.

Karty Závislosti a technologie zobrazují knihovny a technologie používané v aplikaci.

Podrobné informace o konkrétním problému

U každého problému můžete získat další informace (podrobnosti o problému, obsah pravidla atd.) jednoduše tak, že ho vyberete. Zobrazí se také seznam všech souborů ovlivněných tímto problémem.

U každého souboru nebo třídy ovlivněného problémem pak můžete přejít do zdrojového kódu a zvýraznit řádek kódu, který problém vytvořil.