Nasazení webové aplikace Payara Micro do služby Aplikace Azure Service pomocí Mavenu

V tomto rychlém startu použijete modul plug-in Maven pro Aplikace Azure Service Web Apps k nasazení aplikace Payara Micro do služby Aplikace Azure Service v Linuxu. Pokud chcete sloučit závislosti aplikace, modul runtime a konfiguraci do jediného nasaditelného artefaktu, můžete zvolit nasazení Java SE pomocí Tomcatu a souborů WAR.

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet před tím, než začnete.

Požadavky

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 PayaraMicro, je použití Azure CLI.

Přihlaste se k účtu Azure pomocí Azure CLI:

az login

Postupujte podle pokynů a dokončete proces přihlášení.

Vytvoření ukázkové aplikace z MicroProfile Starter

V této části vytvoříte aplikaci PayaraMicro a otestujete ji místně.

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

    Snímek obrazovky s vybranou možností MicroProfile Starter s modulem runtime Payara Micro

  2. Zadejte nebo vyberte následující pole.

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

  4. Rozbalte archivní soubor; Například:

    unzip payaraMicro-hello-azure.zip
    

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

  1. Přejděte do adresáře pro dokončený projekt; například:

    cd payaramicro-hello-azure/
    
  2. Sestavení projektu pomocí Mavenu; Například:

    mvn clean package
    
  3. Spusťte projekt; Například:

    java -jar target/payaramicro-hello-azure-microbundle.jar
    
  4. Otestujte webovou aplikaci tak, že ji místně otevřete ve webovém prohlížeči. Pokud máte k dispozici nástroj curl, můžete například 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 PayaraMicro pom.xml soubor tak, aby maven mohl nasadit aplikaci do služby Aplikace Azure Service v Linuxu.

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

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

    <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. Potom můžete nasazení nakonfigurovat 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
    Confirm (Y/N) y

    [! POZNÁMKA] I když tomcat nepoužíváme, vyberte TOMCAT 8.5 v tuto chvíli. Během podrobné konfigurace upravíte hodnotu z TOMCAT 8.5 hodnoty do 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. runtime Upravte položku z TOMCAT 8.5 do java11 a deployment položku z *.war do *.jar. Pak přidejte <appSettings> oddíl do oddílu <configuration>PORT, WEBSITES_PORTa WEBSITES_CONTAINER_START_TIME_LIMIT. Položka azure-webapp-maven-plugin XML 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>
    

Nasadit aplikaci do Azure

Jakmile nakonfigurujete všechna nastavení v předchozích částech tohoto článku, jste připraveni nasadit webovou aplikaci do Azure. Můžete to udělat podle následujících kroků:

  1. Pokud jste provedli nějaké změny v souboru pom.xml, na příkazovém řádku nebo v okně terminálu, které jste používali dříve, znovu zkompilujte soubor JAR pomocí Mavenu. Například:

    mvn clean package
    
  2. Nasaďte webovou aplikaci do Azure pomocí Mavenu. Například:

    mvn azure-webapp:deploy
    

Pokud jste nasazení uspěli, 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í vaši webovou aplikaci do Azure. Pokud webová aplikace nebo plán webové aplikace ještě neexistují, vytvoří se za vás. Může trvat několik minut, než bude webová aplikace viditelná na adrese URL zobrazené ve výstupu. Ve webovém prohlížeči přejděte na příslušnou adresu URL. Měla by se zobrazit následující obrazovka.

Snímek obrazovky webového prohlížeče s úvodní stránkou Payara Micro

Po nasazení webu ho můžete spravovat prostřednictvím webu Azure Portal.

Vaše webová aplikace bude uvedená ve skupině prostředků microprofile .

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

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

Zobrazí se (nebo "tail") protokoly ze spuštěné služby App Service. Všechna volání console.log v kódu lokality 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čištění prostředků

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

  • Na webu Azure Portal vyberte v nabídce nalevo Skupina prostředků.
  • Do pole Filtrovat podle názvu zadejte mikroprofile, skupina prostředků vytvořená v tomto kurzu by měla mít tuto předponu.
  • Vyberte skupinu prostředků, kterou jste vytvořili v tomto kurzu.
  • V horní nabídce vyberte Odstranit skupinu prostředků.

Další kroky

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

Další materiály

Další informace o různých technologiích popsaných v tomto článku najdete v následujících článcích: