Een Payara Micro-web-app implementeren in Azure-app Service met Maven

Artikel
10/23/2023

In deze quickstart gebruikt u de Maven-invoegtoepassing voor Azure-app Service Web Apps om 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 voor Azure en Azure Stack voor meer informatie over de JDK's die beschikbaar zijn voor gebruik bij het ontwikkelen in Azure.
Apache Maven, versie 3.

De eenvoudigste en eenvoudigste manier om de Maven-invoegtoepassing voor het implementeren van uw PayaraMicro-toepassing te krijgen, 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 van MicroProfile Starter

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

Open een webbrowser en navigeer naar de MicroProfile Starter-site .

Voer het veld in of selecteer het veld als volgt.

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

Selecteer DOWNLOADEN om het project te downloaden.
Pak het archiefbestand uit; bijvoorbeeld:
```
unzip payaraMicro-hello-azure.zip
```

De toepassing uitvoeren in de lokale omgeving

Ga naar de map met het voltooide project, bijvoorbeeld:
```
cd payaramicro-hello-azure/
```
Bouw het project met behulp van Maven; bijvoorbeeld:
```
mvn clean package
```

Voer het project uit; bijvoorbeeld:

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

Test de web-app door er lokaal heen te bladeren met een webbrowser. U kunt bijvoorbeeld de volgende opdracht gebruiken als u over curl beschikt:
```
curl http://localhost:8080/data/hello
```
Het volgende bericht wordt weergegeven: Hallo wereld

De Maven-invoegtoepassing voor Azure App Service configureren

In deze sectie configureert u het PayaraMicro-project pom.xml-bestand, zodat Maven de app kan implementeren in Azure-app Service op Linux.

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

Voeg in de <build> sectie van het pom.xml-bestand de volgende <plugin> vermelding in de <plugins> tag 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>

Vervolgens kunt u de implementatie configureren door de volgende Maven-opdracht uit te voeren:

mvn azure-webapp:config

Selecteer de volgende opties wanneer u hierom wordt gevraagd:

Invoerveld	Invoer/waarde selecteren
Definieer de waarde voor het besturingssysteem (standaard: Linux):	1. Linux
Waarde definiëren voor javaVersion(standaard: Java 8):	1. Java 11
Waarde definiëren voor runtimeStack(Standaard: TOMCAT 8.5):	TOMCAT 8.5
Bevestigen (J/N)	y

[! OPMERKING] Hoewel we Tomcat niet gebruiken, selecteert u TOMCAT 8.5 op dit moment. Tijdens de gedetailleerde configuratie wijzigt u de waarde van TOMCAT 8.5 in Java11.

Met deze opdracht wordt uitvoer geproduceerd die vergelijkbaar is met het volgende voorbeeld:

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

Wijzig de runtime vermelding van TOMCAT 8.5 in java11 en de deployment vermelding van *.war naar *.jar. Voeg vervolgens de <appSettings> sectie toe aan de <configuration> sectie van PORT, WEBSITES_PORTen WEBSITES_CONTAINER_START_TIME_LIMIT. Uw XML-vermelding moet azure-webapp-maven-plugin er ongeveer uitzien als in het volgende voorbeeld:

<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

Nadat u alle instellingen in de voorgaande secties van dit artikel hebt geconfigureerd, kunt u uw web-app implementeren in Azure. Volg hiervoor de volgende stappen:

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
```
Implementeer uw web-app in Azure met behulp van Maven, bijvoorbeeld:
```
mvn azure-webapp:deploy
```

Als u de implementatie hebt voltooid, ziet u de volgende uitvoer.

[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 het web-app- of web-app-plan nog niet bestaat, wordt deze voor u gemaakt. 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. U ziet nu het volgende scherm.

Screenshot of web browser showing front page of Payara Micro.

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

Uw web-app wordt weergegeven in de microprofile-resourcegroep , zoals wordt weergegeven in de volgende schermopname:

U kunt toegang krijgen tot uw web-app door Bladeren te selecteren op de pagina Overzicht voor uw web-app. Controleer of de implementatie is geslaagd en wordt uitgevoerd. Het volgende scherm wordt weergegeven:

Bevestig de logboekstream van de actieve App Service

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

az webapp log tail \
    --resource-group microprofile \
    --name payaramicro-hello-azure-1601009217863

Resources opschonen

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

Ga naar het MicroProfile in het Documentatiecentrum van Azure voor meer informatie over MicroProfile en Azure.

MicroProfile in Azure

Aanvullende bronnen

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

Een Payara Micro-web-app implementeren in Azure-app Service met Maven

Vereisten

Voorbeeld-app maken van MicroProfile Starter

De toepassing uitvoeren in de lokale omgeving

De Maven-invoegtoepassing voor Azure App Service configureren

De app implementeren in Azure

Bevestig de logboekstream van de actieve App Service

Resources opschonen

Volgende stappen

Aanvullende bronnen

Feedback

Feedback

Aanvullende resources

Een Payara Micro-web-app implementeren in Azure-app Service met Maven

Vereisten

Aanmelden bij Azure CLI

Voorbeeld-app maken van MicroProfile Starter

De toepassing uitvoeren in de lokale omgeving

De Maven-invoegtoepassing voor Azure App Service configureren

De app implementeren in Azure

Bevestig de logboekstream van de actieve App Service

Resources opschonen

Volgende stappen

Aanvullende bronnen

Feedback

Feedback

Aanvullende resources