Nasazení webové aplikace Payara Micro do služby Azure App Service pomocí Mavenu
V tomto rychlém startu použijete modul plug-in Maven pro Azure App Service Web Apps k nasazení aplikace Payara Micro pro Azure App Service v Linuxu. Zvolte nasazení Java SE místo souborů Tomcat a WAR, pokud si přejete konsolidovat závislosti aplikace, modul runtime a konfiguraci do jednoho nasaditelného artefaktu.
Pokud nemáte předplatné Azure, vytvořte si bezplatný účet, než začnete.
Požadavky
- Azure CLI místně nebo prostřednictvím Azure Cloud Shellu .
- Podporovaná sada Java Development Kit (JDK). Další informace o sadách JDK, které jsou k dispozici při vývoji v Azure, najdete v tématu podpora Javy v Azure a azure Stack.
- Apache Maven, verze 3.
Přihlášení k Azure CLI
Nejjednodušším a nejsnadnějším způsobem, jak získat modul plug-in Maven, který nasazuje vaši aplikaci Payara Micro, je použití Azure CLI.
Přihlaste se ke svému účtu Azure pomocí Azure CLI:
az login
Dokončete proces přihlášení podle pokynů.
Vytvoření ukázkové aplikace z úvodní sady MicroProfile
V této části vytvoříte aplikaci Payara Micro a otestujete ji místně.
Otevřete webový prohlížeč a přejděte na web MicroProfile Starter.
Zadejte nebo vyberte hodnoty polí podle následující tabulky:
Pole Hodnota groupId com.microsoft.azure.samples.payaramicro artifactId payaramicro-hello-azure Verze MicroProfile MP 3.2 Verze Java SE Java 11 MicroProfile Runtime PayaraMicro Příklady pro specifikace Metriky, OpenAPI Vyberte STÁHNOUT a stáhněte si projekt.
Rozbalte archivní soubor pomocí následujícího příkazu:
unzip payaraMicro-hello-azure.zip
Spuštění aplikace v místním prostředí
Pomocí následujícího příkazu změňte adresář na dokončený projekt:
cd payaramicro-hello-azure/
Sestavte projekt pomocí následujícího příkazu Maven:
mvn clean package
Spusťte projekt pomocí následujícího příkazu:
java -jar target/payaramicro-hello-azure-microbundle.jar
Otestujte webovou aplikaci tak, že na ni přejdete místně pomocí webového prohlížeče. Pokud máte například
curl
k dispozici, můžete použít následující příkaz:curl http://localhost:8080/data/hello
Měla by se zobrazit následující zpráva: Hello World.
Konfigurace modulu plug-in Maven pro Azure App Service
V této části nakonfigurujete projekt Payara Micro pom.xml soubor tak, aby Maven mohl nasadit aplikaci do služby Azure App Service v Linuxu.
Otevřete soubor pom.xml v editoru kódu.
Do sekce
<build>
v souboru pom.xml vložte následující<plugin>
položku uvnitř značky<plugins>
:<build> <finalName>payaramicro-hello-azure</finalName> <plugins> <plugin> <groupId>com.microsoft.azure</groupId> <artifactId>azure-webapp-maven-plugin</artifactId> <version>1.10.0</version> </plugin> </plugins> </build>
Nakonfigurujte nasazení spuštěním následujícího příkazu Mavenu:
mvn azure-webapp:config
Po zobrazení výzvy vyberte následující možnosti:
Vstupní pole Vstupní/výběrové hodnoty Definujte hodnotu pro OS(Default: Linux): 1. linux Definovat hodnotu pro javaVersion(Výchozí: Java 8): 1. Java 11 Definujte hodnotu pro runtimeStack(Default: TOMCAT 8.5): TOMCAT 8.5 Potvrdit (Y/N) y [! POZNÁMKA] I když tomcat nepoužíváme, vyberte v tuto chvíli
TOMCAT 8.5
. Během podrobné konfigurace upravíte hodnotu zTOMCAT 8.5
naJava11
.Tento příkaz vytvoří výstup podobný následujícímu příkladu:
[INFO] Scanning for projects... [INFO] [INFO] --< com.microsoft.azure.samples.payaramicro:payaramicro-hello-azure >--- [INFO] Building payaramicro-hello-azure 1.0-SNAPSHOT [INFO] --------------------------------[ war ]--------------------------------- [INFO] [INFO] --- azure-webapp-maven-plugin:1.10.0:config (default-cli) @ payaramicro-hello-azure --- Define value for OS(Default: Linux): 1. linux [*] 2. windows 3. docker Enter index to use: Define value for javaVersion(Default: Java 8): 1. Java 11 2. Java 8 [*] Enter index to use: 1 Define value for runtimeStack(Default: TOMCAT 8.5): 1. TOMCAT 9.0 2. TOMCAT 8.5 [*] Enter index to use: Please confirm webapp properties AppName : payaramicro-hello-azure-1601009217863 ResourceGroup : payaramicro-hello-azure-1601009217863-rg Region : westeurope PricingTier : PremiumV2_P1v2 OS : Linux RuntimeStack : TOMCAT 8.5-java11 Deploy to slot : false Confirm (Y/N)? : y [INFO] Saving configuration to pom. [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 22.302 s [INFO] Finished at: 2020-09-25T13:47:11+09:00 [INFO] ------------------------------------------------------------------------
Upravte položku
runtime
zTOMCAT 8.5
najava11
a položkudeployment
z*.war
na*.jar
. Potom přidejte oddíl<appSettings>
do oddílu<configuration>
uPORT
,WEBSITES_PORT
aWEBSITES_CONTAINER_START_TIME_LIMIT
. Položka XML proazure-webapp-maven-plugin
by měla vypadat podobně jako v následujícím příkladu:<plugin> <groupId>com.microsoft.azure</groupId> <artifactId>azure-webapp-maven-plugin</artifactId> <version>1.9.1</version> <configuration> <schemaVersion>V2</schemaVersion> <resourceGroup>microprofile</resourceGroup> <appName>payaramicro-hello-azure-1591860934798</appName> <pricingTier>P1v2</pricingTier> <region>japaneast</region> <runtime> <os>linux</os> <javaVersion>java11</javaVersion> <webContainer>java11</webContainer> </runtime> <appSettings> <property> <name>PORT</name> <value>8080</value> </property> <property> <name>WEBSITES_PORT</name> <value>8080</value> </property> <property> <name>WEBSITES_CONTAINER_START_TIME_LIMIT</name> <value>600</value> </property> </appSettings> <deployment> <resources> <resource> <directory>${project.basedir}/target</directory> <includes> <include>*.jar</include> </includes> </resource> </resources> </deployment> </configuration> </plugin>
Nasazení aplikace do Azure
Jakmile nakonfigurujete všechna nastavení v předchozích částech tohoto článku, jste připraveni nasadit webovou aplikaci do Azure. Provedete to pomocí následujících kroků:
V příkazovém řádku nebo okně terminálu, které jste používali dříve, znovu sestavte soubor JAR pomocí Mavenu, pokud jste provedli nějaké změny v souboru pom.xml pomocí následujícího příkazu:
mvn clean package
Nasaďte webovou aplikaci do Azure pomocí Mavenu v následujícím příkazu:
mvn azure-webapp:deploy
Pokud nasazení proběhlo úspěšně, zobrazí se následující výstup:
[INFO] Successfully deployed the artifact to https://payaramicro-hello-azure-1601009217863.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:58 min
[INFO] Finished at: 2020-09-25T13:55:13+09:00
[INFO] ------------------------------------------------------------------------
Maven nasadí webovou aplikaci do Azure. Pokud webová aplikace nebo plán webové aplikace ještě neexistují, vytvoří se za vás. Než se webová aplikace zobrazí na adrese URL zobrazené ve výstupu, může to několik minut trvat. Přejděte na adresu URL ve webovém prohlížeči. Měla by se zobrazit následující obrazovka:
Po nasazení webové aplikace ji můžete spravovat prostřednictvím webu Azure Portal.
Vaše webová aplikace je uvedená ve skupině prostředků mikroprofilu.
K webové aplikaci můžete přistupovat výběrem možnosti Procházet na stránce Přehled pro vaši webovou aplikaci. Ověřte, že nasazení proběhlo úspěšně a běží.
Potvrďte stream protokolu ze spuštěné služby App Service
Protokoly můžete zobrazit v celém rozsahu nebo pomocí tail
zobrazit konec protokolů ze spuštěné služby App Service. Všechna volání ke kódu webu console.log
se zobrazí v terminálu.
az webapp log tail \
--resource-group microprofile \
--name payaramicro-hello-azure-1601009217863
Vyčistěte prostředky
Pokud už prostředky Azure nepotřebujete, vyčistěte prostředky, které jste nasadili, odstraněním skupiny prostředků.
- Na portálu Azure vyberte v nabídce skupinu prostředků.
- Do pole Filtrovat podle názvu zadejte mikroprofil. Skupina prostředků vytvořená v tomto návodu by měla mít tuto předponu.
- Vyberte skupinu prostředků vytvořenou během tohoto kurzu.
- V nabídce vyberte Odstranit skupinu prostředků.
Další kroky
Další informace o MicroProfile a Azure najdete v centru dokumentace k MicroProfile v Azure.
Další zdroje informací
Další informace o různých technologiích probíraných v tomto článku najdete v následujících článcích: