Een Payara Micro-web-app implementeren om Azure App Service met Maven

  • Artikel
  • 5 minuten om te lezen

In deze quickstart gebruikt u de Maven-invoegtoepassing voor Azure App Service Web Apps een Payara Micro-toepassing te implementeren in Azure App Service op Linux. Het is beter om te kiezen voor de implementatie van Java SE dan Tomcat- en WAR-bestanden wanneer u de afhankelijkheden, runtime en configuratie van uw app wilt consolideren in één implementeerbaar artefact.

Als u nog geen abonnement op Azure hebt, maakt u een gratis account aan voordat u begint.

Vereisten

  • De Azure CLI-, lokaal of via Azure Cloud Shell.
  • Een ondersteunde JDK (Java Development Kit). Zie Java-ondersteuning in Azure en Azure Stack voor meer informatie over de JDK's die beschikbaar zijn voor gebruik bij het ontwikkelen in Azure.
  • Maven van Apache, versie 3).

Azure CLI installeren en u aanmelden

De eenvoudigste en eenvoudigste manier om de Maven-invoegtoepassing uw PayaraMicro-toepassing te laten implementeren, is met behulp van Azure CLI.

Meld u aan bij uw Azure-account met behulp van de Azure CLI:

az login

Volg de instructies om het aanmeldingsproces te voltooien.

Voorbeeld-app maken vanuit MicroProfile Starter

In deze sectie maakt u een PayaraMicro-toepassing en test u deze lokaal.

  1. Open Webbrowser en open de site MicroProfile Starter.

    MicroProfile Starter voor Payara Micro

  2. Voer het veld als volgt in of selecteer het veld.

    Veld Waarde
    groupId com.microsoft.azure.samples.payaramicro
    artifactId payaramicro-hello-azure
    MicroProfile-versie MP 3.2
    Java SE-versie Java 11
    MicroProfile Runtime PayaraMicro
    Voorbeelden voor specificaties Metrische gegevens, OpenAPI

  3. Selecteer de knop DOWNLOADEN om het project te downloaden.

  4. Het archiefbestand uitvijken; bijvoorbeeld:

    unzip payaraMicro-hello-azure.zip

De toepassing uitvoeren in de lokale omgeving

  1. Ga naar de map met het voltooide project, bijvoorbeeld:

    cd payaramicro-hello-azure/

  2. Bouw het project met behulp van Maven; bijvoorbeeld:

    mvn clean package

  3. Voer het project uit; bijvoorbeeld:

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

  4. Test de web-app door er lokaal naartoe te bladeren met een webbrowser. U kunt bijvoorbeeld de volgende opdracht gebruiken als u over curl beschikt:

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

  5. Het volgende bericht wordt weergegeven: Hallo wereld

De Maven-invoegtoepassing voor Azure App Service configureren

In deze sectie configureert u het PayaraMicro-projectpom.xmlzodat Maven de app kan implementeren in Azure App Service op Linux.

  1. Open het pom.xml in een code-editor.

  2. Voeg in <build> de sectie van <build> de volgende vermelding in de <plugin> tag <plugins> in.

    <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. Vervolgens kunt u de implementatie configureren, de volgende Maven-opdracht uitvoeren in de opdrachtprompt en het nummer gebruiken om deze opties te kiezen in de prompt:

    mvn azure-webapp:config

    Parameter options:

    Invoerveld Invoer/waarde selecteren
    Definieer waarde voor OS (standaard: Linux): 1. linux
    Definieer de waarde voor javaVersion (standaard: Java 8): 1. Java 11
    Definieer de waarde voor runtimeStack(Standaard: TOMCAT 8.5): TOMCAT 8.5
    Bevestigen (J/N) y

    [! OPMERKING] Hoewel we de Tomcat niet gebruiken, selecteert u TOMCAT 8.5 de op dit moment? Tijdens de detailconfiguratie wijzigen we de waarde van de TOMCAT 8.5 in Java11 later.**

    U kunt configureren met de volgende opdracht:

    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. Wijzig de Runtime van TOMCAT 8.5 in java11 en Het implementatiebestand van in *.war*.jar . Voeg vervolgens de <appSettings> sectie toe aan de sectie van en <configuration>PORTWEBSITES_PORTWEBSITES_CONTAINER_START_TIME_LIMIT .
    Ten slotte ziet u de volgende XML-vermelding voor 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>

De app implementeren in Azure

Wanneer u alle instellingen in de voorgaande secties van dit artikel hebt geconfigureerd, bent u klaar om uw web-app in Azure te implementeren. Volg hiervoor de volgende stappen:

  1. Bouw vanaf de opdrachtprompt of het terminalvenster dat u eerder hebt gebruikt het JAR-bestand opnieuw op met Maven als u wijzigingen hebt aangebracht in het bestand pom.xml, bijvoorbeeld:

    mvn clean package

  2. Implementeer uw web-app in Azure met behulp van Maven, bijvoorbeeld:

    mvn azure-webapp:deploy

    Als de implementatie is geslaagd, ziet u het volgende bericht op de console.

    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 implementeert uw web-app in Azure. Als de web-app of het web-app-plan nog niet bestaat, wordt deze nu gemaakt voor u. Het kan enkele minuten duren voordat de web-app wordt weergegeven op de URL die in de uitvoer wordt weergegeven. Navigeer naar de URL in een webbrowser. Als het goed is, ziet u het volgende scherm.

    Voorpagina van Payara Micro

    Wanneer uw web is geïmplementeerd, kunt u het beheren via de Azure Portal.

    • Uw web-app wordt weergegeven in de resourcegroep microprofile:

    Web-app die wordt weergegeven in Azure Portal App Services

    • En u kunt toegang krijgen tot uw web-app door te klikken op de Browse knop in overzicht voor uw web-app. Browse
      Controleer of de implementatie is geslaagd en wordt uitgevoerd. Het volgende scherm wordt weergegeven:

    Zoek de URL voor uw web-app in Azure Portal App Services

Bevestig dat de logboekstream wordt uitgevoerd App Service

U kunt de logboeken zien (of 'tail') van de App Service. Alle console.log aanroepen naar in de sitecode worden weergegeven in de terminal.

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

De logboekstream bevestigen

Resources ops schonen

Schoon de geïmplementeerd Azure-resources, wanneer u deze niet meer nodig hebt, op door de resourcegroep te verwijderen.

  • Selecteer Resourcegroep in het linkermenu van Azure Portal.
  • Voer microprofile in het veld Filteren op naam in. De resourcegroep die in deze zelfstudie is gemaakt, moet dit voorvoegsel hebben.
  • Selecteer de resourcegroep die u in deze zelfstudie hebt gemaakt.
  • Selecteer Resourcegroep verwijderen in het bovenste menu.

Volgende stappen

Voor meer informatie over MicroProfile en Azure gaat u verder naar het documentatiecentrum voor MicroProfile in Azure.

MicroProfile in Azure

Aanvullende resources

Raadpleeg de volgende artikelen voor meer informatie over de verschillende technologieën die in dit artikel worden besproken: