Nasazení polyglotových aplikací v plánu Azure Spring Apps Enterprise

Tento článek se vztahuje na:❌ Basic/Standard ✔️ Enterprise

V tomto článku se dozvíte, jak nasadit polyglotní aplikace v plánu Azure Spring Apps Enterprise a jak tyto polyglotové aplikace můžou využívat funkce buildovací služby poskytované balíčky buildů.

Požadavky

• Již zřízená instance plánu Azure Spring Apps Enterprise. Další informace najdete v tématu Rychlý start: Sestavování a nasazování aplikací do Azure Spring Apps pomocí plánu Enterprise.
• Azure CLI verze 2.45.0 nebo vyšší K instalaci rozšíření Azure Spring Apps použijte následující příkaz: az extension add --name spring

Nasazení polyglotových aplikací v instanci služby

Tato část se týká sestavování a nasazování aplikací Polyglot, když je povolená služba sestavení. Pokud službu sestavení zakážete, můžete nasadit aplikace pouze s vlastní imagí kontejneru. Můžete vytvořit vlastní image nebo použít jednu vytvořenou instancí Azure Spring Apps Enterprise. Další informace najdete v tématu Nasazení aplikace s vlastní imagí kontejneru.

Správa tvůrce

Když vytváříte instanci Azure Spring Apps Enterprise, musíte zvolit výchozího tvůrce z některého z následujících podporovaných balíčků buildů rodiny jazyků:

• Java Azure Buildpack pro VMware Tanzu
• Buildpack .NET Core pro VMware Tanzu
• Go Buildpack pro VMware Tanzu
• Buildpack webových serverů pro VMware Tanzu
• Node.js Buildpack pro VMware Tanzu
• Python Buildpack pro VMware Tanzu
• Balíček buildu nativních imagí v Javě pro VMware Tanzu
• PHP Buildpack pro VMware Tanzu

Další informace najdete v tématu Buildpacky jazykové řady pro VMware Tanzu.

Tyto balíčky buildů podporují sestavování se zdrojovým kódem nebo artefakty pro Javu, .NET Core, Go, webové statické soubory, Node.js a aplikace Pythonu. Během vytváření nebo prohlížení tvůrce můžete také zobrazit verze buildpacku. A můžete vytvořit vlastní tvůrce zadáním buildpacků a zásobníku.

Všichni tvůrci nakonfigurovaní v instanci služby Azure Spring Apps jsou uvedeni na stránce buildové služby , jak je znázorněno na následujícím snímku obrazovky:

Výběrem možnosti Přidat vytvořte nového tvůrce. Následující snímek obrazovky ukazuje prostředky, které byste měli použít k vytvoření vlastního tvůrce. Zásobník operačního systému zahrnuje Bionic Base, Bionic Full, Jammy Tiny, Jammy Basea Jammy Full. Bionic je založen na Ubuntu 18.04 (Bionic Beaver) a Jammy je založen na Ubuntu 22.04 (Jammy Jellyfish). Další informace najdete v části doporučení zásobníku operačního systému.

Doporučujeme použít Jammy OS Stack k vytvoření tvůrce, protože VMware je zastaralý Bionic OS Stack.

Vlastní tvůrce můžete také upravit, když se tvůrce nepoužívá v nasazení. Buildpacky nebo zásobník operačního systému můžete aktualizovat, ale název tvůrce je jen pro čtení.

Tvůrce je prostředek, který průběžně přispívá k vašim nasazením. Poskytuje nejnovější image modulu runtime a nejnovější buildpacky.

Tvůrce nemůžete odstranit při vytváření existujících aktivních nasazení pomocí tvůrce. Pokud chcete odstranit tvůrce v tomto stavu, postupujte takto:

1. Uložte konfiguraci jako nového tvůrce.
2. Nasaďte aplikace pomocí nového tvůrce. Nasazení jsou propojená s novým tvůrcem.
3. Migrujte nasazení v předchozím tvůrci do nového tvůrce.
4. Odstraňte původní tvůrce.

Doporučení zásobníku operačního systému

V Azure Spring Apps doporučujeme vytvořit Jammy OS Stack tvůrce, protože Bioinic OS Stack je v souladu s vyřazením VMware. Následující seznam popisuje dostupné možnosti:

• Jammy Tiny: Vhodné pro vytvoření minimální image pro nejmenší možnou velikost a bezpečnostní stopu. Stejně jako vytvoření nativní image Java může finální image kontejneru zmenšit. Integrované knihovny jsou omezené. Nemůžete se například připojit k instanci aplikace pro řešení potíží, protože neexistuje žádná shell knihovna.

  • Většina aplikací Go
  • Aplikace v Javě Některé možnosti konfigurace Apache Tomcat, jako je nastavení bin/setenv.sh, nejsou k dispozici, protože Tiny nemá žádné prostředí.

• Jammy Base: Vhodný pro většinu aplikací bez nativních rozšíření.

  • Aplikace v Javě a aplikace .NET Core
  • Aplikace Go, které vyžadují některé knihovny jazyka C.
  • Node.js, pythonu nebo webových serverů bez nativních rozšíření.

• Jammy Full: Zahrnuje většinu knihoven a je vhodný pro aplikace s nativními rozšířeními. Obsahuje například kompletní knihovnu písem. Pokud vaše aplikace spoléhá na nativní rozšíření, použijte Full zásobník.

  • Node.js nebo aplikace v Pythonu s nativními rozšířeními.

Další informace najdete v tématu Zásobníky Ubuntu v dokumentaci k VMware.

Správa registru kontejneru

Tato část ukazuje, jak spravovat registr kontejneru používaný službou sestavení, pokud povolíte službu sestavení s vlastním registrem kontejneru. Pokud povolíte službu sestavení s registrem kontejnerů spravovaným službou Azure Spring Apps, můžete tuto část přeskočit.

Po povolení registru kontejneru uživatele se službou sestavení můžete registr zobrazit a nakonfigurovat pomocí webu Azure Portal nebo Azure CLI.

az spring container-registry list \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> 

az spring container-registry show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name>

az spring container-registry update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name> \
    --server <your-container-registry-login-server> \
    --username <your-container-registry-username> \
    --password <your-container-registry-password>

az spring container-registry delete \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name> 

Služba sestavení může používat registr kontejneru a může také změnit přidružený registr kontejneru. Tento proces je časově náročný. Když dojde ke změně, všechny prostředky tvůrce a sestavení v rámci opětovného sestavení služby sestavení a konečné image kontejneru se nasdílí do nového registru kontejneru.

az spring build-service show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name>

az spring build-service update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --registry-name <your-container-registry-name> 

Sestavování a nasazování aplikací polyglotu

Pomocí registru kontejneru můžete vytvářet a nasazovat polyglotní aplikace následujícím způsobem:

• Pro službu sestavení využívající registr kontejnerů spravovaný službou Azure Spring Apps můžete vytvořit aplikaci na image a pak ji nasadit do aktuální instance služby Azure Spring Apps. Sestavení a nasazení se spouští společně pomocí az spring app deploy příkazu.

• Pro službu sestavení pomocí registru kontejneru spravovaného uživatelem můžete sestavit aplikaci do image kontejneru a pak ji nasadit do aktuální instance Azure Spring Apps Enterprise a dalších instancí. Příkazy sestavení a nasazení jsou oddělené. Pomocí příkazu sestavení můžete vytvořit nebo aktualizovat sestavení a pak pomocí příkazu deploy nasadit image kontejneru do instance služby.

Další informace najdete v části Sestavení služby na vyžádání služby Use Tanzu Build Service.

Následující příklady ukazují některé užitečné příkazy sestavení, které se mají použít.

az configure --defaults group=<resource-group-name> spring=<service-name>

az spring build-service build list
az spring build-service build show --name <build-name>
az spring build-service build create --name <build-name> --artifact-path <artifact-path>
az spring build-service build update --name <build-name> --artifact-path <artifact-path>
az spring build-service build delete --name <build-name>

Následující příklady Azure CLI ukazují sestavení a nasazení souboru artefaktů pro dva scénáře registru kontejneru:

• Registr kontejnerů spravovaný službou Azure Spring Apps
• Registr kontejneru spravovaný uživatelem

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring app deploy \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
   --name <app-name> \
   --container-image <your-container-image> \
   --container-registry <your-container-registry> \
   --registry-password <your-password> \
   --registry-username <your-username>

Pokud nasadíte aplikaci se souborem artefaktů, použijte --artifact-path k určení cesty k souboru. Soubory JAR i WAR jsou přijatelné.

Pokud Azure CLI zjistí balíček WAR jako tenký soubor JAR, použijte --disable-validation k zakázání ověřování.

Následující příklad nasadí složku zdrojového kódu do aktivního nasazení pomocí parametru --source-path k určení složky.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

az spring build-service build create \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

Můžete také nakonfigurovat prostředí sestavení pro sestavení aplikace. V aplikaci v Javě můžete například zadat verzi sady JDK pomocí BP_JVM_VERSION prostředí sestavení.

K určení prostředí sestavení použijte --build-env, jak je znázorněno v následujícím příkladu. Dostupné proměnné prostředí sestavení jsou popsány dále v tomto článku.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Pro každé sestavení můžete také určit prostředky sestavení, jak je znázorněno v následujícím příkladu.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Výchozí prostředek procesoru/paměti sestavení je 1 vCPU, 2 Gi. Pokud vaše aplikace potřebuje menší nebo větší velikost paměti, použijte --build-memory k určení prostředků paměti , 500Minapříklad , 1Gi, 2Giatd. Pokud vaše aplikace potřebuje menší nebo větší množství prostředků procesoru, použijte --build-cpu k určení prostředků procesoru , 500mnapříklad , 1, 2atd. Maximální limit prostředků procesoru a paměti pro sestavení je 8 vCPU, 16Gi.

Prostředky procesoru a paměti jsou omezené velikostí fondu agentů služby sestavení. Další informace najdete v části Fond agentů sestavení služby Use Tanzu Build Service. Součet kvóty prostředků sestavení pro zpracování nemůže překročit velikost fondu agentů.

Paralelní počet úloh sestavení závisí na velikosti fondu agentů a jednotlivých prostředcích sestavení. Pokud je například prostředek sestavení výchozí 1 vCPU, 2 Gi a velikost fondu agentů je 6 vCPU, 12 Gi, pak je číslo paralelního sestavení 6.

Jiné úlohy sestavení jsou na chvíli blokované kvůli omezením kvót prostředků.

Aplikace musí naslouchat na portu 8080. Aplikace Spring Boot přepíší SERVER_PORT automatické použití 8080.

Podporované jazyky pro nasazení

V následující tabulce jsou uvedené funkce podporované pro každý jazyk.

Další informace opodporovaných

Omezení nativních imagí v Javě

Nativní image je technologie pro kompilaci kódu Java předem do nativního spustitelného souboru. Nativní bitové kopie poskytují různé výhody, jako je okamžité spuštění a snížení spotřeby paměti. Nativní bitové kopie můžete zabalit do zjednodušené image kontejneru pro rychlejší a efektivnější nasazení. Kvůli optimalizaci uzavřeného světa platí následující omezení :

• Následující funkce Javy vyžadují konfiguraci v době sestavení spustitelného souboru:
  • Dynamické načítání tříd
  • Reflexe
  • Dynamický proxy server
  • JNI (nativní rozhraní Java)
  • Serializace
• Bajtové kódy už nejsou za běhu dostupné, takže ladění a monitorování pomocí nástrojů určených pro JVMTI není možné.

Následující funkce se v Azure Spring Apps nepodporují kvůli omezení nativní image Java. Azure Spring Apps je bude podporovat, když nativní image Java a komunita toto omezení překonají.

Nasazení aplikací v Javě

Buildpack pro nasazení aplikací v Javě je tanzu-buildpacks/java-azure.

Následující tabulka uvádí funkce podporované v Azure Spring Apps:

Nasazení aplikací .NET

Buildpack pro nasazení aplikací .NET je tanzu-buildpacks/dotnet-core.

Následující tabulka uvádí funkce podporované v Azure Spring Apps:

Nasazení aplikací v Pythonu

Buildpack pro nasazení aplikací Pythonu je tanzu-buildpacks/python.

Následující tabulka uvádí funkce podporované v Azure Spring Apps:

Nasazení aplikací Go

Buildpack pro nasazení aplikací Go je tanzu-buildpacks/go.

Následující tabulka uvádí funkce podporované v Azure Spring Apps:

Nasazení Node.js aplikací

Buildpack pro nasazení Node.js aplikací je tanzu-buildpacks/nodejs.

Následující tabulka uvádí funkce podporované v Azure Spring Apps:

Nasazení aplikací webového serveru

Buildpack pro nasazení aplikací WebServer je tanzu-buildpacks/web-servers.

Další informace naleznete v tématu Nasazení webových statických souborů.

Nasazení aplikací nativní bitové kopie Java (Preview)

Buildpack pro nasazení aplikací nativních imagí Java je tanzu-buildpacks/java-native-image.

Aplikace nativní bitové kopie Spring Boot můžete nasadit pomocí tanzu-buildpacks/java-native-image balíčku buildpack. Spring Native poskytuje podporu pro kompilaci aplikací Spring Boot do nativních spustitelných souborů. Buildpack používá sadu Liberica Native Image Kit (NIK) k vytváření nativních imagí aplikací Spring Boot a tyto aplikace jsou plně podporované.

Při sestavování nativní image Java musíte nastavit prostředí BP_NATIVE_IMAGE sestavení a true prostředek paměti sestavení by neměl být menší než 8Gi. Velikost fondu agentů služby sestavení by neměla být menší než 4 vCPU, 8 Gi. Další informace najdete v části Fond agentů sestavení služby Use Tanzu Build Service.

Pokud chcete nativní image sestavit do menší velikosti image kontejneru, doporučujeme použít tvůrce se zásobníkem operačního Jammy Tiny systému. Další informace najdete v části doporučení zásobníku operačního systému.

Následující tabulka uvádí funkce podporované v Azure Spring Apps:

Pro nativní image Java existují určitá omezení. Další informace najdete v části Omezení nativní bitové kopie Java.

Nasazení aplikací PHP

Buildpack pro nasazování aplikací PHP je tanzu-buildpacks/php.

Balíček sestavení Tanzu PHP je kompatibilní pouze s úplným zásobníkem operačního systému. Doporučujeme použít tvůrce se zásobníkem operačního Jammy Full systému. Další informace najdete v části doporučení zásobníku operačního systému.

Následující tabulka uvádí funkce podporované v Azure Spring Apps:

Další kroky

• Nasazení webových statických souborů