Nasazení aplikací Spring Boot pomocí Mavenu
Poznámka:
Plány Basic, Standard a Enterprise budou od poloviny března 2025 vyřazeny ze 3letého období vyřazení. Doporučujeme přejít na Azure Container Apps. Další informace najdete v oznámení o vyřazení Azure Spring Apps.
Od 30. září 2024 bude od 30. září 2024 zastaralý plán s úplným vypnutím po šesti měsících. Doporučujeme přejít na Azure Container Apps. Další informace najdete v tématu Migrace spotřeby Azure Spring Apps Úrovně Standard a vyhrazeného plánu do Azure Container Apps.
Tento článek se vztahuje na:✅ Java ❎ C#
Tento článek se vztahuje na:✅ Basic/Standard ✅ Enterprise
V tomto článku se dozvíte, jak pomocí modulu plug-in Azure Spring Apps Maven nakonfigurovat a nasadit aplikace do Azure Spring Apps.
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- Už zřízená instance Azure Spring Apps.
- JDK 8 nebo JDK 11
- Apache Maven
- Azure CLI verze 2.45.0 nebo vyšší s rozšířením Azure Spring Apps Rozšíření můžete nainstalovat pomocí následujícího příkazu:
az extension add --name spring
Vygenerování projektu Spring
Pokud chcete vytvořit projekt Spring pro použití v tomto článku, postupujte následovně:
Přejděte na Spring Initializr a vygenerujte ukázkový projekt s doporučenými závislostmi pro Azure Spring Apps. Tento odkaz používá následující adresu URL k zadání výchozího nastavení.
https://start.spring.io/#!type=maven-project&language=java&platformVersion=2.5.7&packaging=jar&jvmVersion=1.8&groupId=com.example&artifactId=hellospring&name=hellospring&description=Demo%20project%20for%20Spring%20Boot&packageName=com.example.hellospring&dependencies=web,cloud-eureka,actuator,cloud-config-client
Následující obrázek ukazuje doporučenou instalaci aplikace Spring Initializr pro tento ukázkový projekt.
V tomto příkladu se používá Java verze 8. Pokud chcete použít Javu verze 11, změňte možnost v části Metadata projektu.
Vyberte Možnost Generovat , pokud jsou nastaveny všechny závislosti.
Stáhněte a rozbalte balíček a pak vytvořte webový kontroler pro webovou aplikaci. Přidejte soubor src/main/java/com/example/hellospring/HelloController.java s následujícím obsahem:
package com.example.hellospring; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.bind.annotation.RequestMapping; @RestController public class HelloController { @RequestMapping("/") public String index() { return "Greetings from Azure Spring Apps!"; } }
Místní sestavování aplikací Spring
Pokud chcete projekt sestavit pomocí Mavenu, spusťte následující příkazy:
cd hellospring
mvn clean package -DskipTests -Denv=cloud
Kompilace projektu trvá několik minut. Po dokončení byste měli mít jednotlivé soubory JAR pro každou službu v příslušných složkách.
Zřízení instance Azure Spring Apps
Následující postup vytvoří instanci Azure Spring Apps pomocí webu Azure Portal.
Na nové kartě otevřete Azure Portal.
V horním vyhledávacím poli vyhledejte Azure Spring Apps.
Ve výsledcích vyberte Azure Spring Apps .
Na stránce Azure Spring Apps vyberte Vytvořit.
Vyplňte formulář na stránce Vytvoření aplikace Azure Spring Apps. Zvažte následující pokyny:
- Předplatné: Vyberte předplatné, na které se má tento prostředek fakturovat.
- Skupina prostředků: Osvědčeným postupem je vytvoření nových skupin prostředků pro nové prostředky. Tuto skupinu prostředků použijete v dalších krocích jako <název> skupiny prostředků.
- Podrobnosti/název služby: Zadejte <název> instance služby. Název musí mít délku 4 až 32 znaků a může obsahovat jenom malá písmena, číslice a pomlčky. První znak názvu služby musí být písmeno a poslední znak musí být písmeno nebo číslo.
- Umístění: Vyberte oblast vaší instance služby.
Vyberte Zkontrolovat a vytvořit.
Generování konfigurací a nasazení do azure Spring Apps
Pokud chcete vygenerovat konfigurace a nasadit aplikaci, postupujte takto:
Spusťte následující příkaz z kořenové složky hellospring , která obsahuje soubor POM. Pokud jste se už přihlásili pomocí Azure CLI, příkaz automaticky vyzvedne přihlašovací údaje. V opačném případě vás příkaz vyzve s pokyny pro přihlášení. Další informace najdete v tématu Ověřování v úložišti azure-maven-plugins na GitHubu.
mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.10.0:config
Zobrazí se výzva k výběru:
- ID předplatného – předplatné, které jste použili k vytvoření instance Azure Spring Apps.
- Instance služby – název vaší instance Azure Spring Apps
- Název aplikace – název aplikace podle vašeho výběru nebo použijte výchozí hodnotu
artifactId
. - Veřejný koncový bod - true pro zveřejnění aplikace pro veřejný přístup, jinak nepravda.
Ověřte, že
appName
prvek v souboru POM má správnou hodnotu. Relevantní část souboru POM by měla vypadat podobně jako v následujícím příkladu.<build> <plugins> <plugin> <groupId>com.microsoft.azure</groupId> <artifactId>azure-spring-apps-maven-plugin</artifactId> <version>1.10.0</version> <configuration> <subscriptionId>xxxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx</subscriptionId> <clusterName>v-spr-cld</clusterName> <appName>hellospring</appName>
Soubor POM teď obsahuje závislosti a konfigurace modulu plug-in.
Nasaďte aplikaci pomocí následujícího příkazu.
mvn azure-spring-apps:deploy
Ověření služeb
Po dokončení nasazení můžete k aplikaci přistupovat na adrese https://<service instance name>-hellospring.azuremicroservices.io/
.
Vyčištění prostředků
Pokud chcete pokračovat v práci s ukázkovou aplikací, možná budete chtít ponechat prostředky na místě. Pokud už ji nepotřebujete, odstraňte skupinu prostředků obsahující vaši instanci Azure Spring Apps. Pokud chcete odstranit skupinu prostředků pomocí Azure CLI, použijte následující příkazy:
echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."