Bereitstellen einer KumuluzEE-Web-App für Azure App Service mit Maven

Artikel
01/13/2025

In dieser Schnellstartanleitung verwenden Sie das Maven-Plug-In für Azure App Service Web Apps, um eine KumuluzEE-Anwendung für Azure App Service unter Linuxbereitzustellen. Sie wählen die Bereitstellung von Java SE gegenüber Tomcat und WAR-Dateien, wenn Sie die Abhängigkeiten, die Runtime und die Konfiguration Ihrer App in einem einzigen bereitstellbaren Artefakt konsolidieren möchten.

Wenn Sie nicht über ein Azure-Abonnement verfügen, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.

Voraussetzungen

Die Azure CLI, entweder lokal oder über Azure Cloud Shell
Ein unterstütztes Java Development Kit (JDK). Weitere Informationen zu den für die Entwicklung in Azure verfügbaren JDKs finden Sie unter Java-Unterstützung für Azure und Azure Stack.
Apache Maven, Version 3.

Der einfachste und leichteste Weg, um das Maven Plugin für die Bereitstellung Ihrer KumuluzEE-Anwendung zu erhalten, ist die Verwendung von Azure CLI. Melden Sie sich mit der Azure CLI bei Ihrem Azure-Konto an:

az login

Befolgen Sie die Anweisungen, um den Anmeldevorgang abzuschließen.

Erstellen Sie eine Beispiel-App aus dem MicroProfile Starter

In diesem Abschnitt erstellen Sie eine KumuluzEE-Anwendung und testen sie lokal.

Erstellen eines Java SE 8-Basisprojekts

Öffnen Sie einen Webbrowser, und navigieren Sie zur MicroProfile Starter Website.

Geben Sie die Feldwerte entsprechend den Werten in der folgenden Tabelle ein, oder wählen Sie sie aus:

Feld	Wert
groupId	com.microsoft.azure.samples.kumuluzee
artifactId	kumuluzEE-hello-azure
MicroProfile-Version	MP 3.2
Java SE-Version	Java 8
„MicroProfile Runtime“ (MicroProfile-Runtime)	KumuluzEE
Beispiele für Spezifikationen	Metriken, OpenAPI

Wählen Sie DOWNLOAD, um das Projekt herunterzuladen.
Entpacken Sie die Archivdatei mithilfe des folgenden Befehls:
```
unzip kumuluzEE-hello-azure.zip
```

Ausführen der Anwendung in einer lokalen Umgebung

Wechseln Sie mit dem folgenden Befehl in das Verzeichnis des fertigen Projekts:
```
cd kumuluzEE-hello-azure/
```
Erstellen Sie das Projekt mithilfe von Maven mithilfe des folgenden Befehls:
```
mvn clean package
```
Führen Sie die Anwendung mit folgendem Befehl aus:
```
java -jar target/kumuluzEE-hello-azure.jar
```
Testen Sie die Web-App, indem Sie lokal mit einem Webbrowser darauf navigieren. Sie können beispielsweise den folgenden Befehl verwenden, wenn Sie curl verfügbar haben:
```
curl http://localhost:8080/data/hello
```
Sie sollten die folgende Nachricht auf dem Bildschirm sehen: Hello World.

Konfigurieren des Maven-Plug-Ins für Azure App Service

In diesem Abschnitt konfigurieren Sie das KumuluzEE-Projekt pom.xml Datei, damit Maven die App auf Azure App Service unter Linux bereitstellen kann.

Öffnen Sie die pom.xml-Datei in einem Code-Editor.

Fügen Sie im <build>Abschnitt der Datei pom.xml den folgenden <plugin>-Eintrag innerhalb des <plugins>Tags ein:

<build>
  <finalName>kumuluzEE-hello-azure</finalName>
  <plugins>
    <plugin>
      <groupId>com.microsoft.azure</groupId>
      <artifactId>azure-webapp-maven-plugin</artifactId>
      <version>1.10.0</version>
    </plugin>
  </plugins>
</build>

Konfigurieren Sie die Bereitstellung, indem Sie den folgenden Maven-Befehl ausführen:

mvn azure-webapp:config

Wählen Sie die folgenden Optionen aus, wenn Sie dazu aufgefordert werden:

Eingabefeld	Einzugebender/Auszuwählender Wert
Bestimmen Sie den Wert für das Betriebssystem (Standard: Linux):	1. Linux
Definieren Sie den Wert für javaVersion (Standard: Java 8):	2. Java 8
Bestätigen (Y/N)	j

Dieser Befehl erzeugt eine Ausgabe ähnlich dem folgenden Beispiel:

[INFO] Scanning for projects...
[INFO]
[INFO] ----< com.microsoft.azure.samples.kumuluzee:kumuluzEE-hello-azure >-----
[INFO] Building kumuluzEE-hello-azure 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- azure-webapp-maven-plugin:1.10.0:config (default-cli) @ kumuluzEE-hello-azure ---
1. linux [*]
2. windows
3. docker
Enter index to use: 1
Define value for javaVersion(Default: Java 8):
1. Java 11
2. Java 8 [*]
Enter index to use: 2
Please confirm webapp properties
AppName : kumuluzEE-hello-azure-1601006602397
ResourceGroup : kumuluzEE-hello-azure-1601006602397-rg
Region : westeurope
PricingTier : PremiumV2_P1v2
OS : Linux
RuntimeStack : JAVA 8-jre8
Deploy to slot : false
Confirm (Y/N)? : y
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  44.223 s
[INFO] Finished at: 2020-09-25T13:04:02+09:00
[INFO] ------------------------------------------------------------------------

Fügen Sie den Abschnitt <appSettings> zum abschnitt <configuration> von PORT, WEBSITES_PORTund WEBSITES_CONTAINER_START_TIME_LIMIThinzu. Ihr XML-Eintrag für azure-webapp-maven-plugin sollte dem folgenden Beispiel ähneln:

<plugin>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-webapp-maven-plugin</artifactId>
  <version>1.10.0</version>
  <configuration>
    <schemaVersion>V2</schemaVersion>
    <resourceGroup>microprofile</resourceGroup>
    <appName>kumuluzEE-hello-azure-1601006602397</appName>
    <pricingTier>P1v2</pricingTier>
    <region>japaneast</region>
    <runtime>
      <os>linux</os>
      <javaVersion>jre8</javaVersion>
      <webContainer>jre8</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>

Bereitstellen der App in Azure

Nachdem Sie alle Einstellungen in den vorherigen Abschnitten dieses Artikels konfiguriert haben, können Sie Ihre Web-App in Azure bereitstellen. Führen Sie dazu die folgenden Schritte aus:

Erzeugen Sie die JAR-Datei mit Maven von der Eingabeaufforderung oder dem Terminal-Fenster aus, das Sie zuvor verwendet haben, wenn Sie Änderungen an der Datei pom.xml vorgenommen haben, indem Sie den folgenden Befehl verwenden:
```
mvn clean package
```
Stellen Sie Ihre Web-App mit dem folgenden Maven-Befehl in Azure bereit:
```
mvn azure-webapp:deploy
```

Wenn die Bereitstellung erfolgreich war, sehen Sie die folgende Ausgabe:

[INFO] Successfully deployed the artifact to https://kumuluzee-hello-azure-1601006602397.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:23 min
[INFO] Finished at: 2020-09-25T13:13:14+09:00
[INFO] ------------------------------------------------------------------------

Maven stellt Ihre Web-App in Azure bereit. Wenn die Web-App oder der Web-App Plan noch nicht existiert, wird er für Sie erstellt. Es kann einige Minuten dauern, bis die Web-App an der url sichtbar ist, die in der Ausgabe angezeigt wird. Navigieren Sie zu der URL in einem Webbrowser. Du solltest den folgenden Bildschirm sehen:

Screenshot des Webbrowsers mit der Frontseite

Nachdem Ihre Web-App bereitgestellt wurde, können Sie sie über das Azure-Portalverwalten. Ihre Web-App wird in der Ressourcengruppe Microprofile aufgeführt.

Sie können auf Ihre Web-App zugreifen, indem Sie Durchsuchen auf der Seite Übersicht für Ihre Web-App wählen. Vergewissern Sie sich, dass die Bereitstellung erfolgreich war und ausgeführt wird.

Bestätigen Sie den Log-Stream des ausgeführten App Service

Mit dem folgenden Befehl können Sie die Protokolle des ausgeführten App Service anzeigen oder anhängen. Alle Aufrufe von console.log im Websitecode werden im Terminal angezeigt.

az webapp log tail \
    --resource-group microprofile \
    --name kumuluzEE-hello-azure-1601006602397

Bereinigen von Ressourcen

Wenn die Azure-Ressourcen nicht mehr benötigt werden, bereinigen Sie die von Ihnen bereitgestellten Ressourcen, indem Sie die Ressourcengruppe löschen.

Wählen Sie im Azure-Portal Ressourcengruppe aus dem Menü.
Geben Sie microprofile in das Feld Filter nach Name ein. Die in diesem Tutorial erstellte Ressourcengruppe sollte dieses Präfix haben.
Wählen Sie die Ressourcengruppe aus, die in diesem Tutorial erstellt wurde.
Wählen Sie Ressourcengruppe löschen aus dem Menü.

Nächste Schritte

Weitere Informationen zu MicroProfile und Azure finden Sie im Dokumentationscenter zu MicroProfile in Azure.

MicroProfile auf Azure

Weitere Ressourcen

Weitere Informationen zu den verschiedenen technologien, die in diesem Artikel behandelt werden, finden Sie in den folgenden Artikeln:

Freigeben über

Bereitstellen einer KumuluzEE-Web-App für Azure App Service mit Maven

Voraussetzungen

Erstellen Sie eine Beispiel-App aus dem MicroProfile Starter

Erstellen eines Java SE 8-Basisprojekts

Ausführen der Anwendung in einer lokalen Umgebung

Konfigurieren des Maven-Plug-Ins für Azure App Service

Bereitstellen der App in Azure

Bestätigen Sie den Log-Stream des ausgeführten App Service

Bereinigen von Ressourcen

Nächste Schritte

Weitere Ressourcen

Feedback

Zusätzliche Ressourcen

Freigeben über

Bereitstellen einer KumuluzEE-Web-App für Azure App Service mit Maven

Voraussetzungen

Anmelden bei der Azure CLI

Erstellen Sie eine Beispiel-App aus dem MicroProfile Starter

Erstellen eines Java SE 8-Basisprojekts

Ausführen der Anwendung in einer lokalen Umgebung

Konfigurieren des Maven-Plug-Ins für Azure App Service

Bereitstellen der App in Azure

Bestätigen Sie den Log-Stream des ausgeführten App Service

Bereinigen von Ressourcen

Nächste Schritte

Weitere Ressourcen

Feedback

Zusätzliche Ressourcen