Nasazení webové aplikace KumuluzEE do služby Azure App Service pomocí Mavenu

Článek
01/08/2025

V tomto rychlém startu použijete modul plug-in Maven pro Azure App Service Web Apps k nasazení aplikace KumuluzEE pro Azure App Service v Linuxu. Pokud chcete konsolidovat závislosti aplikace, modul runtime a konfiguraci do jednoho nasaditelného artefaktu, zvolíte nasazení Java SE přes soubory Tomcat a WAR.

Pokud nemáte předplatné Azure, vytvořte si bezplatného účtu.

Požadavky

Azure CLI místně nebo prostřednictvím Azure Cloud Shell .
Podporovaná sada nástrojů pro vývoj Javy (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.

Nejjednodušším a nejsnadnějším způsobem, jak získat modul plug-in Maven, který nasazuje aplikaci KumuluzEE, 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 KumuluzEE a otestujete ji místně.

Vytvoření základního projektu Java SE 8

Otevřete webový prohlížeč a přejděte na web MicroProfile Starter.

Zadejte nebo vyberte hodnoty polí podle hodnot v následující tabulce:

Pole	Hodnota
groupId	com.microsoft.azure.samples.kumuluzee
artifactId	kumuluzEE-hello-azure
Verze MicroProfile	MP 3.2
Verze Java SE	Java 8
MicroProfile Runtime	KumuluzEE
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 kumuluzEE-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 kumuluzEE-hello-azure/
```
Pomocí následujícího příkazu sestavte projekt pomocí Mavenu:
```
mvn clean package
```
Spusťte aplikaci pomocí následujícího příkazu:
```
java -jar target/kumuluzEE-hello-azure.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 KumuluzEE 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.

V části <build> souboru pom.xml vložte následující položku <plugin> do značky <plugins>.

<build>
  <finalName>kumuluzEE-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):	2. Java 8
Potvrdit (Y/N)	y

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

[INFO] Scanning for projects...
[INFO]
[INFO] ----< com.microsoft.azure.samples.kumuluzee:kumuluzEE-hello-azure >-----
[INFO] Building kumuluzEE-hello-azure 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- azure-webapp-maven-plugin:1.10.0:config (default-cli) @ kumuluzEE-hello-azure ---
1. linux [*]
2. windows
3. docker
Enter index to use: 1
Define value for javaVersion(Default: Java 8):
1. Java 11
2. Java 8 [*]
Enter index to use: 2
Please confirm webapp properties
AppName : kumuluzEE-hello-azure-1601006602397
ResourceGroup : kumuluzEE-hello-azure-1601006602397-rg
Region : westeurope
PricingTier : PremiumV2_P1v2
OS : Linux
RuntimeStack : JAVA 8-jre8
Deploy to slot : false
Confirm (Y/N)? : y
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  44.223 s
[INFO] Finished at: 2020-09-25T13:04:02+09:00
[INFO] ------------------------------------------------------------------------

Přidejte oddíl <appSettings> k oddílu <configuration> do sekcí PORT, WEBSITES_PORTa WEBSITES_CONTAINER_START_TIME_LIMIT. Položka XML pro azure-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.10.0</version>
  <configuration>
    <schemaVersion>V2</schemaVersion>
    <resourceGroup>microprofile</resourceGroup>
    <appName>kumuluzEE-hello-azure-1601006602397</appName>
    <pricingTier>P1v2</pricingTier>
    <region>japaneast</region>
    <runtime>
      <os>linux</os>
      <javaVersion>jre8</javaVersion>
      <webContainer>jre8</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

Po nakonfigurování všech 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ů:

Z příkazového řádku nebo okna terminálu, které jste používali dříve, znovu sestavte soubor JAR pomocí Mavenu, pokud jste provedli jakékoli změny souboru pom.xml pomocí následujícího příkazu:
```
mvn clean package
```
Nasaďte webovou aplikaci do Azure pomocí následujícího příkazu Maven:
```
mvn azure-webapp:deploy
```

Pokud nasazení proběhlo úspěšně, zobrazí se následující výstup:

[INFO] Successfully deployed the artifact to https://kumuluzee-hello-azure-1601006602397.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:23 min
[INFO] Finished at: 2020-09-25T13:13:14+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:

snímek obrazovky webového prohlížeče s úvodní stránkou KumuluzEE

Po nasazení webové aplikace ji můžete spravovat prostřednictvím webu Azure Portal. Vaše webová aplikace je uvedená v mikroprofile skupině prostředků.

Ke své webové aplikaci se dostanete tak, že na stránce Přehled webové aplikace vyberete Procházet. Ověřte, že nasazení proběhlo úspěšně a je spuštěné.

Potvrzení streamu protokolu ze spuštěné služby App Service

Pomocí následujícího příkazu můžete zobrazit protokoly ze spuštěné služby App Service nebo tail. Všechna volání console.log v kódu lokality se zobrazí v terminálu.

az webapp log tail \
    --resource-group microprofile \
    --name kumuluzEE-hello-azure-1601006602397

Vyčištění prostředků

Pokud už prostředky Azure nepotřebujete, vyčistěte prostředky, které jste nasadili, odstraněním skupiny prostředků.

Z portálu Azure v nabídce vyberte skupinu prostředků.
Do pole Filtrovat podle názvu zadejte mikroprofil. Skupina prostředků vytvořená v tomto kurzu by měla mít tuto předponu.
Vyberte skupinu prostředků vytvořenou v tomto tutoriálu.
V nabídce vyberte Odstranit skupinu prostředků.

Další kroky

Další informace o MicroProfile a Azure najdete v centru dokumentace k MicroProfile v Azure.

MicroProfile na 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:

modul plug-in Maven pro azure Web Apps.
Vytvoření služebního účtu Azure pomocí Azure CLI 2.0.
Nastavení Mavenu - referenční.

Sdílet prostřednictvím

Nasazení webové aplikace KumuluzEE do služby Azure App Service pomocí Mavenu

Požadavky

Vytvoření ukázkové aplikace z úvodní sady MicroProfile

Vytvoření základního projektu Java SE 8

Spuštění aplikace v místním prostředí

Konfigurace modulu plug-in Maven pro Azure App Service

Nasazení aplikace do Azure

Potvrzení streamu protokolu ze spuštěné služby App Service

Vyčištění prostředků

Další kroky

Další zdroje informací

Váš názor

Další materiály

Sdílet prostřednictvím

Nasazení webové aplikace KumuluzEE do služby Azure App Service pomocí Mavenu

Požadavky

Přihlášení k Azure CLI

Vytvoření ukázkové aplikace z úvodní sady MicroProfile

Vytvoření základního projektu Java SE 8

Spuštění aplikace v místním prostředí

Konfigurace modulu plug-in Maven pro Azure App Service

Nasazení aplikace do Azure

Potvrzení streamu protokolu ze spuštěné služby App Service

Vyčištění prostředků

Další kroky

Další zdroje informací

Váš názor

Další materiály