Sdílet prostřednictvím


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ě.

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

    snímek obrazovky s vybranou možností MicroProfile Starter s modulem Runtime Payara Micro

  2. 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
  3. Vyberte STÁHNOUT a stáhněte si projekt.

  4. 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í

  1. Pomocí následujícího příkazu změňte adresář na dokončený projekt:

    cd payaramicro-hello-azure/
    
  2. Sestavte projekt pomocí následujícího příkazu Maven:

    mvn clean package
    
  3. Spusťte projekt pomocí následujícího příkazu:

    java -jar target/payaramicro-hello-azure-microbundle.jar
    
  4. 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
    
  5. 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.

  1. Otevřete soubor pom.xml v editoru kódu.

  2. 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>
    
  3. 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 z TOMCAT 8.5 na Java11.

    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] ------------------------------------------------------------------------
    
  4. Upravte položku runtime z TOMCAT 8.5 na java11 a položku deployment z *.war na *.jar. Potom přidejte oddíl <appSettings> do oddílu <configuration> u 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.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ů:

  1. 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
    
  2. 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:

snímek obrazovky webového prohlížeče s přední stránkou Payara Micro

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

snímek obrazovky okna terminálu s streamem protokolu

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ů.

  1. Na portálu Azure vyberte v nabídce skupinu prostředků.
  2. 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.
  3. Vyberte skupinu prostředků vytvořenou během tohoto kurzu.
  4. 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: