Distribuera en Payara Micro-webbapp för att Azure App Service med Maven

  • Artikel
  • 4 minuter för att läsa

I den här snabbstarten använder du Plugin-programmet Maven för att Azure App Service Web Apps distribuera ett Payara Micro-program till Azure App Service på Linux. Du ska välja Java SE-distribution i stället för Tomcat- och WAR-filer när du vill konsolidera appens beroenden, runtime och konfiguration i en enda distribuerbar artefakt.

Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

Förutsättningar

Installera och logga in på Azure CLI

Det enklaste sättet att få Maven-plugin-programmet att distribuera PayaraMicro-programmet är att använda Azure CLI.

Logga in på ditt Azure-konto med hjälp av Azure CLI:

az login

Följ instruktionerna för att slutföra inloggningsprocessen.

Skapa exempelapp från MicroProfile Starter

I det här avsnittet skapar du ett PayaraMicro-program och testar det lokalt.

  1. Öppna Webbläsare och åtkomst till MicroProfile Starter-webbplatsen.

    MicroProfile Starter för Payara Micro

  2. Mata in eller välj fältet enligt nedan.

    Fält Värde
    groupId com.microsoft.azure.samples.payaramicro
    artifactId payaramicro-hello-azure
    MicroProfile-version MP 3.2
    Java SE version Java 11
    MicroProfile Runtime PayaraMicro
    Exempel på specifikationer Metrics, OpenAPI

  3. Välj knappen LADDA NED för att ladda ned projektet.

  4. Packa upp arkivfilen. till exempel:

    unzip payaraMicro-hello-azure.zip

Köra programmet i en lokal miljö

  1. Byt katalog till det slutförda projektet, till exempel:

    cd payaramicro-hello-azure/

  2. Skapa projektet med hjälp av Maven; till exempel:

    mvn clean package

  3. Kör projektet; till exempel:

    java -jar target/payaramicro-hello-azure-microbundle.jar

  4. Testa webbappen genom att bläddra till den lokalt med hjälp av en webbläsare. Du kan till exempel använda följande kommando om du har Curl tillgängligt:

    curl http://localhost:8080/data/hello

  5. Du bör se följande meddelande: Hello World

Konfigurera Maven-pluginet för Azure App Service

I det här avsnittet konfigurerar du PayaraMicro-pom.xml så att Maven kan distribuera appen till Azure App Service på Linux.

  1. Öppna filen pom.xml kodredigeraren.

  2. I avsnittet <build> i <build> in följande post <plugin> i <plugins> taggen .

    <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. Sedan kan du konfigurera distributionen, köra följande Maven-kommando i kommandotolken och använda nummer för att välja dessa alternativ i prompten:

    mvn azure-webapp:config

    Alternativparameter:

    Indatafält Indata/välj värde
    Definiera värdet för OS (standard: Linux): 1. linux
    Definiera värdet för javaVersion(Standard: Java 8): 1. Java 11
    Definiera värdet för runtimeStack(Standard: TOMCAT 8.5): TOMCAT 8.5
    Confirm (Y/N) (Bekräfta (J/N)) y

    [! Obs! Även om vi inte använder Tomcat väljer du TOMCAT 8.5 i den här gången? Under detaljkonfigurationen ändrar vi värdet från till TOMCAT 8.5Java11 senare.**

    Du kan konfigurera med följande kommando:

    mvn azure-webapp:config
[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. Ändra körningsfilen TOMCAT 8.5 från till och java11 distributionsfilen från till *.war*.jar . Lägg sedan <appSettings> till -avsnittet <configuration> i -avsnittet i och PORTWEBSITES_PORTWEBSITES_CONTAINER_START_TIME_LIMIT .
    Slutligen kan du se följande XML-post för azure-webapp-maven-plugin .

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

distribuera appen till Azure

När du har konfigurerat alla inställningar i föregående avsnitt i den här artikeln är du redo att distribuera din webbapp till Azure. Gör det med hjälp av följande steg:

  1. Från kommandotolken eller terminalfönstret som du använde tidigare kan du återskapa JAR-filen med hjälp av Maven om du har gjort några ändringar i pom.xml-filen, till exempel:

    mvn clean package

  2. Distribuera din webbapp till Azure med hjälp av Maven, till exempel:

    mvn azure-webapp:deploy

    Om du har lyckats med distributionen visas följande meddelande i konsolen.

    mvn azure-webapp:deploy

[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 distribuerar din webbapp till Azure. Om webbappen eller webbapplanen inte redan finns kommer den att skapas åt dig. Det kan ta några minuter innan webbappen visas på den URL som visas i utdata. Gå till URL:en i en webbläsare. Du bör se följande skärm.

    Front Page of Payara Micro

    När din webbplats har distribuerats kan du hantera den via Azure Portal .

    • Webbappen visas i resursgruppen microprofile:

    Webbapp som anges i Azure Portal App Services

    • Och du kan komma åt din webbapp genom att klicka Browse på knappen i Browse för din webbapp.
      Kontrollera att distributionen lyckades och körs. Du bör se följande skärm:

    Hitta URL:en för din webbapp i Azure Portal App Services

Bekräfta att loggströmmen körs App Service

Du kan se (eller "tail") loggarna från den App Service. Alla anrop console.log till i platskoden visas i terminalen.

az webapp log tail -g microprofile -n payaramicro-hello-azure-1601009217863

Bekräfta loggströmmen

Rensa resurser

När Azure-resurserna inte längre behövs rensar du de resurser som du har distribuerat genom att ta bort resursgruppen.

  • Från Azure-portalen väljer du Resursgrupp från den vänstra menyn.
  • Ange microprofile i fältet Filtrera efter namn. Resursgruppen som skapades i den här självstudien ska ha det här prefixet.
  • Välj den resursgrupp som skapats i den här självstudien.
  • Välj Ta bort resursgrupp från menyn längst upp.

Nästa steg

Om du vill veta mer om MicroProfile och Azure kan du fortsätta till dokumentationscentret MicroProfile på Azure.

MicroProfile på Azure

Ytterligare resurser

Mer information om de olika tekniker som beskrivs i den här artikeln finns i följande artiklar: