Teilen über


Schnellstart: Erstellen einer Java-App in Azure App Service

In dieser Schnellstartanleitung wird das Maven-Plug-In für Azure App Service-Web-Apps verwendet, um eine Java-Webanwendung auf einem Linux-Tomcat-Server in Azure App Service bereitzustellen. App Service stellt einen hochgradig skalierbaren Web-App-Hostingdienst mit Self-Patching bereit. Verwenden Sie die Registerkarten, um zwischen Anweisungen für Tomcat, JBoss oder Java SE (eingebetteter Server) zu wechseln.

Screenshot der Maven-Web-App „Hello World“, die in Azure App Service ausgeführt wird.

Sollte Maven nicht Ihr bevorzugtes Entwicklungstool sein, stehen ähnliche Tutorials für Java-Entwickler zur Verfügung:

Sollten Sie über kein Azure-Abonnement verfügen, können Sie zunächst ein kostenloses Azure-Konto erstellen.

1. Verwenden von Azure Cloud Shell

Azure hostet Azure Cloud Shell, eine interaktive Shell-Umgebung, die Sie über Ihren Browser nutzen können. Sie können entweder Bash oder PowerShell mit Cloud Shell verwenden, um mit Azure-Diensten zu arbeiten. Sie können die vorinstallierten Befehle von Cloud Shell verwenden, um den Code in diesem Artikel auszuführen, ohne etwas in Ihrer lokalen Umgebung installieren zu müssen.

Starten von Azure Cloud Shell:

Option Beispiel/Link
Wählen Sie rechts oben in einem Code- oder Befehlsblock die Option Ausprobieren aus. Durch die Auswahl von Ausprobieren wird der Code oder Befehl nicht automatisch in Cloud Shell kopiert. Screenshot: Beispiel von „Jetzt testen“ für Azure Cloud Shell.
Rufen Sie https://shell.azure.com auf, oder klicken Sie auf die Schaltfläche Cloud Shell starten, um Cloud Shell im Browser zu öffnen. Schaltfläche zum Starten von Azure Cloud Shell.
Wählen Sie im Azure-Portal rechts oben im Menü die Schaltfläche Cloud Shell aus. Screenshot: Schaltfläche „Cloud Shell“ im Azure-Portal

So verwenden Sie Azure Cloud Shell:

  1. Starten Sie Cloud Shell.

  2. Wählen Sie die Schaltfläche Kopieren für einen Codeblock (oder Befehlsblock) aus, um den Code oder Befehl zu kopieren.

  3. Fügen Sie den Code oder Befehl mit STRG+UMSCHALT+V unter Windows und Linux oder CMD+UMSCHALT+V unter macOS in die Cloud Shell-Sitzung ein.

  4. Drücken Sie die EINGABETASTE, um den Code oder Befehl auszuführen.

2. Erstellen einer Java-App

Führen Sie den folgenden Maven-Befehl über die Eingabeaufforderung der Cloud Shell aus, um eine neue App mit dem Namen helloworld zu erstellen:

mvn archetype:generate "-DgroupId=example.demo" "-DartifactId=helloworld" "-DarchetypeArtifactId=maven-archetype-webapp" "-DarchetypeVersion=1.4" "-Dversion=1.0-SNAPSHOT"

Ändern Sie anschließend Ihr Arbeitsverzeichnis in den Projektordner:

cd helloworld

3. Konfigurieren des Maven-Plug-Ins

Der Bereitstellungsprozess für Azure App Service verwendet automatisch Ihre Azure-Anmeldeinformation aus der Azure CLI. Wenn die Azure CLI nicht lokal installiert ist, führt das Maven-Plug-In die Authentifizierung über OAuth oder die Geräteanmeldung durch. Weitere Informationen finden Sie unter Authentifizierung mit Maven-Plug-Ins.

Führen Sie den als nächstes gezeigten Maven-Befehl aus, um die Bereitstellung zu konfigurieren. Dieser Befehl unterstützt Sie beim Einrichten des App Service-Betriebssystems, der Java-Version und der Tomcat-Version.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.12.0:config
  1. Geben Sie bei Create new run configuration (Neue Ausführungskonfiguration erstellen) den Buchstaben Y ein, und drücken Sie dann die EINGABETASTE.

  2. Geben Sie für Define value for OS (Wert für Betriebssystem definieren) 1 für Windows bzw. 2 für Linux ein, und drücken Sie die EINGABETASTE.

  3. Geben Sie für Define value for javaVersion (Wert für javaVersion definieren) 3 für Java 17 ein, und drücken Sie die EINGABETASTE.

  4. Geben Sie für Define value for webContainer (Wert für webContainer definieren) 1 für Tomcat 10.0 ein, und drücken Sie die EINGABETASTE.

  5. Geben Sie für Define value for pricingTier (Wert für pricingTier definieren) 9 für P1v2 ein, und drücken Sie die EINGABETASTE.

  6. Geben Sie für Confirm (Bestätigen) den Buchstaben Y ein, und drücken Sie die EINGABETASTE.

    Please confirm webapp properties
    AppName : helloworld-1690440759246
    ResourceGroup : helloworld-1690440759246-rg
    Region : centralus
    PricingTier : P1v2
    OS : Linux
    Java Version: Java 17
    Web server stack: Tomcat 10.0
    Deploy to slot : false
    Confirm (Y/N) [Y]: 
    [INFO] Saving configuration to pom.
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  13.069 s
    [INFO] Finished at: 2023-07-27T06:52:48Z
    [INFO] ------------------------------------------------------------------------
    

Nachdem Sie Ihre Auswahl bestätigt haben, fügt das Plug-In das obige Plug-In-Element und die erforderlichen Einstellungen in der pom.xml-Datei Ihres Projekts hinzu, die Ihre Web-App so konfiguriert, dass sie in Azure App Service ausgeführt wird.

Der relevante Teil der pom.xml-Datei sollte ähnlich wie im folgenden Beispiel aussehen.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>your-resourcegroup-name</resourceGroup>
                <appName>your-app-name</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>           

Sie können die Konfigurationen für App Service direkt in der Datei pom.xml ändern. Einige gängige Konfigurationen sind in der folgenden Tabelle aufgeführt:

Eigenschaft Erforderlich Beschreibung Version
<schemaVersion> false Gibt die Version des Konfigurationsschemas an. Folgende Werte werden unterstützt: v1 und v2. 1.5.2
<subscriptionId> false Geben Sie die Abonnement-ID an. 0.1.0+
<resourceGroup> true Azure-Ressourcengruppe für Ihre Web-App. 0.1.0+
<appName> true Der Name Ihrer Web-App. 0.1.0+
<region> false Gibt die Region an, die Ihre Web-App hosten wird, der Standardwert ist centralus. Alle gültigen Regionen finden Sie im Abschnitt Unterstützten Regionen. 0.1.0+
<pricingTier> false Der Tarif für Ihre Web-App. Für Produktionsworkloads lautet der Standardwert P1v2, für Entwicklungs- und Testworkloads in Java ist der empfohlene Mindestwert hingegen B2. Weitere Informationen finden Sie unter App Service – Preise. 0.1.0+
<runtime> false Die Laufzeitumgebungskonfiguration. Weitere Informationen finden Sie unter Konfigurationsdetails. 0.1.0+
<deployment> false Die Bereitstellungskonfiguration. Weitere Informationen finden Sie unter Konfigurationsdetails. 0.1.0+

Eine vollständige Liste der Konfigurationen finden Sie in der Dokumentation zur Plug-In-Referenz. Alle Azure Maven-Plug-Ins verwenden einen gemeinsamen Satz von Konfigurationen. Diese Konfigurationen finden Sie unter Allgemeine Konfigurationen. App Service-spezifische Konfigurationen finden Sie unter Azure Web App: Konfigurationsdetails.

Notieren Sie sich die Werte <appName> und <resourceGroup> (in der Demo entsprechend helloworld-1690440759246 und helloworld-1690440759246-rg). Sie werden später verwendet.

4. Bereitstellen der App

Wenn alle Konfigurationseinstellungen in Ihrer Datei pom.xml eingerichtet sind, können Sie Ihre Java-App mit einem einzigen Befehl in Azure bereitstellen.

mvn package azure-webapp:deploy

Nach Abschluss der Bereitstellung steht Ihre Anwendung unter http://<appName>.azurewebsites.net/ (http://helloworld-1690440759246.azurewebsites.net in der Demo) bereit. Öffnen Sie die URL in Ihrem lokalen Webbrowser. Folgendes sollte angezeigt werden:

Screenshot der Maven-Web-App „Hello World“, die in Azure App Service ausgeführt wird.

Herzlichen Glückwunsch! Sie haben Ihre erste Java-App in App Service bereitgestellt.

5. Bereinigen von Ressourcen

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt. Wenn Sie die Ressourcen in Zukunft nicht mehr benötigen, löschen Sie die Ressourcengruppe im Portal, oder führen Sie den folgenden Befehl in Cloud Shell aus:

az group delete --name <your resource group name; for example: helloworld-1690440759246-rg> --yes

Die Ausführung dieses Befehls kann eine Minute in Anspruch nehmen.

In dieser Schnellstartanleitung wird das Maven-Plug-In für Azure App Service-Web-Apps verwendet, um eine Java-Webanwendung mit einem eingebetteten Server in Azure App Service bereitzustellen. App Service stellt einen hochgradig skalierbaren Web-App-Hostingdienst mit Self-Patching bereit. Verwenden Sie die Registerkarten, um zwischen Anweisungen für Tomcat, JBoss oder Java SE (eingebetteter Server) zu wechseln.

Der Schnellstart stellt entweder eine Spring Boot-App oder eine eingebettete Tomcat- oder Aspxus-App mithilfe des azure-webapp-maven-plugin-Plug-Ins bereit.

Hinweis

App Service kann Spring-Apps hosten. Für Spring-Apps, die alle Spring-Dienste erfordern, probieren Sie stattdessen Azure Spring Apps aus.

Sollte Maven nicht Ihr bevorzugtes Entwicklungstool sein, stehen ähnliche Tutorials für Java-Entwickler zur Verfügung:

Sollten Sie über kein Azure-Abonnement verfügen, können Sie zunächst ein kostenloses Azure-Konto erstellen.

1. Verwenden von Azure Cloud Shell

Azure hostet Azure Cloud Shell, eine interaktive Shell-Umgebung, die Sie über Ihren Browser nutzen können. Sie können entweder Bash oder PowerShell mit Cloud Shell verwenden, um mit Azure-Diensten zu arbeiten. Sie können die vorinstallierten Befehle von Cloud Shell verwenden, um den Code in diesem Artikel auszuführen, ohne etwas in Ihrer lokalen Umgebung installieren zu müssen.

Starten von Azure Cloud Shell:

Option Beispiel/Link
Wählen Sie rechts oben in einem Code- oder Befehlsblock die Option Ausprobieren aus. Durch die Auswahl von Ausprobieren wird der Code oder Befehl nicht automatisch in Cloud Shell kopiert. Screenshot: Beispiel von „Jetzt testen“ für Azure Cloud Shell.
Rufen Sie https://shell.azure.com auf, oder klicken Sie auf die Schaltfläche Cloud Shell starten, um Cloud Shell im Browser zu öffnen. Schaltfläche zum Starten von Azure Cloud Shell.
Wählen Sie im Azure-Portal rechts oben im Menü die Schaltfläche Cloud Shell aus. Screenshot: Schaltfläche „Cloud Shell“ im Azure-Portal

So verwenden Sie Azure Cloud Shell:

  1. Starten Sie Cloud Shell.

  2. Wählen Sie die Schaltfläche Kopieren für einen Codeblock (oder Befehlsblock) aus, um den Code oder Befehl zu kopieren.

  3. Fügen Sie den Code oder Befehl mit STRG+UMSCHALT+V unter Windows und Linux oder CMD+UMSCHALT+V unter macOS in die Cloud Shell-Sitzung ein.

  4. Drücken Sie die EINGABETASTE, um den Code oder Befehl auszuführen.

2 - Abrufen der Beispiel-App

  1. Laden Sie die Standard-Volage für die Spring Boot-Webanwendung herunter und extrahieren Sie sie. Dieses Repository wird für Sie geklont, wenn Sie den Spring CLI-Befehl spring boot new my-webapp ausführen.

    git clone https://github.com/rd-1-2022/rest-service my-webapp
    
  2. Ändern Sie Ihr Arbeitsverzeichnis in den Projektordner:

    cd my-webapp
    

3. Konfigurieren des Maven-Plug-Ins

Der Bereitstellungsprozess für Azure App Service verwendet automatisch Ihre Azure-Anmeldeinformation aus der Azure CLI. Wenn die Azure CLI nicht lokal installiert ist, führt das Maven-Plug-In die Authentifizierung über OAuth oder die Geräteanmeldung durch. Weitere Informationen finden Sie unter Authentifizierung mit Maven-Plug-Ins.

Führen Sie den als nächstes gezeigten Maven-Befehl aus, um die Bereitstellung zu konfigurieren. Dieser Befehl unterstützt Sie beim Einrichten des App Service-Betriebssystems, der Java-Version und der Tomcat-Version.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.13.0:config
  1. Geben Sie bei Create new run configuration (Neue Ausführungskonfiguration erstellen) den Buchstaben Y ein, und drücken Sie dann die EINGABETASTE.

  2. Geben Sie für Define value for OS (Wert für Betriebssystem definieren) 2 für Linux ein, und drücken Sie die EINGABETASTE.

  3. Geben Sie für Define value for javaVersion (Wert für javaVersion definieren) 1 für Java 17 ein, und drücken Sie die EINGABETASTE.

  4. Geben Sie für Define value for pricingTier (Wert für pricingTier definieren) 9 für P1v2 ein, und drücken Sie die EINGABETASTE.

  5. Geben Sie für Confirm (Bestätigen) den Buchstaben Y ein, und drücken Sie die EINGABETASTE.

    Please confirm webapp properties
    AppName : <generated-app-name>
    ResourceGroup : <generated-app-name>-rg
    Region : centralus
    PricingTier : P1v2
    OS : Linux
    Java Version: Java 17
    Web server stack: Java SE
    Deploy to slot : false
    Confirm (Y/N) [Y]: y
    [INFO] Saving configuration to pom.
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  8.139 s
    [INFO] Finished at: 2023-07-26T12:42:48Z
    [INFO] ------------------------------------------------------------------------
    

Nachdem Sie Ihre Auswahl bestätigt haben, fügt das Plug-In das oben genannte Plug-In-Element und die erforderlichen Einstellungen zur pom.xml-Datei Ihres Projekts hinzu, die Ihre Web-App für die Ausführung in Azure App Service konfigurieren.

Der relevante Teil der pom.xml-Datei sollte ähnlich wie im folgenden Beispiel aussehen.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>your-resourcegroup-name</resourceGroup>
                <appName>your-app-name</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>           

Sie können die Konfigurationen für App Service direkt in der Datei pom.xml ändern. Einige gängige Konfigurationen sind in der folgenden Tabelle aufgeführt:

Eigenschaft Erforderlich Beschreibung Version
<schemaVersion> false Gibt die Version des Konfigurationsschemas an. Folgende Werte werden unterstützt: v1 und v2. 1.5.2
<subscriptionId> false Geben Sie die Abonnement-ID an. 0.1.0+
<resourceGroup> true Azure-Ressourcengruppe für Ihre Web-App. 0.1.0+
<appName> true Der Name Ihrer Web-App. 0.1.0+
<region> false Gibt die Region an, die Ihre Web-App hosten wird, der Standardwert ist centralus. Alle gültigen Regionen finden Sie im Abschnitt Unterstützten Regionen. 0.1.0+
<pricingTier> false Der Tarif für Ihre Web-App. Für Produktionsworkloads lautet der Standardwert P1v2, für Entwicklungs- und Testworkloads in Java ist der empfohlene Mindestwert hingegen B2. Weitere Informationen finden Sie unter App Service – Preise. 0.1.0+
<runtime> false Die Laufzeitumgebungskonfiguration. Weitere Informationen finden Sie unter Konfigurationsdetails. 0.1.0+
<deployment> false Die Bereitstellungskonfiguration. Weitere Informationen finden Sie unter Konfigurationsdetails. 0.1.0+

Eine vollständige Liste der Konfigurationen finden Sie in der Dokumentation zur Plug-In-Referenz. Alle Azure Maven-Plug-Ins verwenden einen gemeinsamen Satz von Konfigurationen. Diese Konfigurationen finden Sie unter Allgemeine Konfigurationen. App Service-spezifische Konfigurationen finden Sie unter Azure Web App: Konfigurationsdetails.

Achten Sie auf die Werte von <appName> und <resourceGroup>. Sie werden später verwendet.

4. Bereitstellen der App

Wenn alle Konfigurationseinstellungen in Ihrer Datei pom.xml eingerichtet sind, können Sie Ihre Java-App mit einem einzigen Befehl in Azure bereitstellen.

  1. Erstellen Sie die JAR-Datei mit dem folgenden Befehl:

    mvn clean package
    
  2. Führen Sie die Bereitstellung in Azure über den folgenden Befehl durch:

    mvn azure-webapp:deploy
    

    Bei einer erfolgreichen Bereitstellung wird die folgende Ausgabe angezeigt:

    [INFO] Successfully deployed the artifact to https://<app-name>.azurewebsites.net
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  02:20 min
    [INFO] Finished at: 2023-07-26T12:47:50Z
    [INFO] ------------------------------------------------------------------------
    

Nach Abschluss der Bereitstellung steht Ihre Anwendung unter http://<appName>.azurewebsites.net/ bereit. Öffnen Sie die URL http://<appName>.azurewebsites.net/greeting in Ihrem lokalen Webbrowser (beachten Sie den Pfad /greeting). Folgendes sollte angezeigt werden:

Screenshot: Spring Boot-Web-App „Hallo Welt“, die in Azure App Service ausgeführt wird.

Herzlichen Glückwunsch! Sie haben Ihre erste Java-App in App Service bereitgestellt.

5. Bereinigen von Ressourcen

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt. Wenn Sie die Ressourcen in Zukunft nicht mehr benötigen, löschen Sie die Ressourcengruppe im Portal, oder führen Sie den folgenden Befehl in Cloud Shell aus:

az group delete --name <your resource group name; for example: quarkus-hello-azure-1690375364238-rg> --yes

Die Ausführung dieses Befehls kann einige Minuten in Anspruch nehmen.

In dieser Schnellstartanleitung wird das Maven-Plug-In für Azure App Service-Web-Apps verwendet, um eine Java-Webanwendung auf einem JBoss EAP-Server unter Linux in Azure App Service bereitzustellen. App Service stellt einen hochgradig skalierbaren Web-App-Hostingdienst mit Self-Patching bereit. Verwenden Sie die Registerkarten, um zwischen Anweisungen für Tomcat, JBoss oder Java SE (eingebetteter Server) zu wechseln.

Screenshot der Maven-Web-App „Hello World“, die in Azure App Service ausgeführt wird.

Sollte Maven nicht Ihr bevorzugtes Entwicklungstool sein, stehen ähnliche Tutorials für Java-Entwickler zur Verfügung:

Sollten Sie über kein Azure-Abonnement verfügen, können Sie zunächst ein kostenloses Azure-Konto erstellen.

1. Verwenden von Azure Cloud Shell

Azure hostet Azure Cloud Shell, eine interaktive Shell-Umgebung, die Sie über Ihren Browser nutzen können. Sie können entweder Bash oder PowerShell mit Cloud Shell verwenden, um mit Azure-Diensten zu arbeiten. Sie können die vorinstallierten Befehle von Cloud Shell verwenden, um den Code in diesem Artikel auszuführen, ohne etwas in Ihrer lokalen Umgebung installieren zu müssen.

Starten von Azure Cloud Shell:

Option Beispiel/Link
Wählen Sie rechts oben in einem Code- oder Befehlsblock die Option Ausprobieren aus. Durch die Auswahl von Ausprobieren wird der Code oder Befehl nicht automatisch in Cloud Shell kopiert. Screenshot: Beispiel von „Jetzt testen“ für Azure Cloud Shell.
Rufen Sie https://shell.azure.com auf, oder klicken Sie auf die Schaltfläche Cloud Shell starten, um Cloud Shell im Browser zu öffnen. Schaltfläche zum Starten von Azure Cloud Shell.
Wählen Sie im Azure-Portal rechts oben im Menü die Schaltfläche Cloud Shell aus. Screenshot: Schaltfläche „Cloud Shell“ im Azure-Portal

So verwenden Sie Azure Cloud Shell:

  1. Starten Sie Cloud Shell.

  2. Wählen Sie die Schaltfläche Kopieren für einen Codeblock (oder Befehlsblock) aus, um den Code oder Befehl zu kopieren.

  3. Fügen Sie den Code oder Befehl mit STRG+UMSCHALT+V unter Windows und Linux oder CMD+UMSCHALT+V unter macOS in die Cloud Shell-Sitzung ein.

  4. Drücken Sie die EINGABETASTE, um den Code oder Befehl auszuführen.

2. Erstellen einer Java-App

Klonen Sie die Demoanwendung Pet Store.

git clone https://github.com/Azure-Samples/app-service-java-quickstart

Wechseln Sie zu dem Verzeichnis des abgeschlossenen Tierhandlungsprojekt, und erstellen Sie es.

Tipp

Für das Beispiel petstore-ee7 ist Java 11 oder höher erforderlich. Für das Beispielprojekt booty-duke-app-service ist Java 17 erforderlich. Wenn Sie eine ältere Java-Version als Java 17 installiert haben, führen Sie den Build im Verzeichnis petstore-ee7 statt auf der obersten Ebene aus.

cd app-service-java-quickstart
git checkout 20230308
cd petstore-ee7
mvn clean install

Wenn eine Meldung darüber angezeigt wird, dass Sie sich in einem Zustand HEAD getrennt befinden, kann diese Nachricht problemlos ignoriert werden. Da Sie in diesem Schnellstart keinen Git-Commit ausführen, ist der getrennte HEAD-Status angemessen.

3. Konfigurieren des Maven-Plug-Ins

Der Bereitstellungsprozess für Azure App Service verwendet automatisch Ihre Azure-Anmeldeinformation aus der Azure CLI. Wenn die Azure CLI nicht lokal installiert ist, führt das Maven-Plug-In die Authentifizierung über OAuth oder die Geräteanmeldung durch. Weitere Informationen finden Sie unter Authentifizierung mit Maven-Plug-Ins.

Führen Sie den als nächstes gezeigten Maven-Befehl aus, um die Bereitstellung zu konfigurieren. Dieser Befehl unterstützt Sie beim Einrichten des App Service-Betriebssystems, der Java-Version und der Tomcat-Version.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.12.0:config
  1. Geben Sie bei Create new run configuration (Neue Ausführungskonfiguration erstellen) den Buchstaben Y ein, und drücken Sie dann die EINGABETASTE.

  2. Geben Sie für Define value for OS (Wert für Betriebssystem definieren) 2 für Linux ein, und drücken Sie die EINGABETASTE.

  3. Geben Sie für Define value for javaVersion (Wert für javaVersion definieren) 2 für Java 11 ein, und drücken Sie die EINGABETASTE.

  4. Geben Sie für die Option webContainer die Ziffer 1 für Jbosseap 7 ein, und drücken Sie die EINGABETASTE.

  5. Geben Sie für Define value for pricingTier (Wert für pricingTier definieren) 1 für P1v3 ein, und drücken Sie die EINGABETASTE.

  6. Geben Sie für Confirm (Bestätigen) den Buchstaben Y ein, und drücken Sie die EINGABETASTE.

    Please confirm webapp properties
    AppName : petstoreee7-1690443003536
    ResourceGroup : petstoreee7-1690443003536-rg
    Region : centralus
    PricingTier : P1v3
    OS : Linux
    Java Version: Java 11
    Web server stack: Jbosseap 7
    Deploy to slot : false
    Confirm (Y/N) [Y]: 
    [INFO] Saving configuration to pom.
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  19.914 s
    [INFO] Finished at: 2023-07-27T07:30:20Z
    [INFO] ------------------------------------------------------------------------
    

Nachdem Sie Ihre Auswahl bestätigt haben, fügt das Plug-In das obige Plug-In-Element und die erforderlichen Einstellungen in der pom.xml-Datei Ihres Projekts hinzu, die Ihre Web-App so konfiguriert, dass sie in Azure App Service ausgeführt wird.

Der relevante Teil der pom.xml-Datei sollte ähnlich wie im folgenden Beispiel aussehen.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>your-resourcegroup-name</resourceGroup>
                <appName>your-app-name</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>           

Sie können die Konfigurationen für App Service direkt in der Datei pom.xml ändern. Einige gängige Konfigurationen sind in der folgenden Tabelle aufgeführt:

Eigenschaft Erforderlich Beschreibung Version
<schemaVersion> false Gibt die Version des Konfigurationsschemas an. Folgende Werte werden unterstützt: v1 und v2. 1.5.2
<subscriptionId> false Geben Sie die Abonnement-ID an. 0.1.0+
<resourceGroup> true Azure-Ressourcengruppe für Ihre Web-App. 0.1.0+
<appName> true Der Name Ihrer Web-App. 0.1.0+
<region> false Gibt die Region an, die Ihre Web-App hosten wird, der Standardwert ist centralus. Alle gültigen Regionen finden Sie im Abschnitt Unterstützten Regionen. 0.1.0+
<pricingTier> false Der Tarif für Ihre Web-App. Für Produktionsworkloads lautet der Standardwert P1v2, für Entwicklungs- und Testworkloads in Java ist der empfohlene Mindestwert hingegen B2. Weitere Informationen finden Sie unter App Service – Preise. 0.1.0+
<runtime> false Die Laufzeitumgebungskonfiguration. Weitere Informationen finden Sie unter Konfigurationsdetails. 0.1.0+
<deployment> false Die Bereitstellungskonfiguration. Weitere Informationen finden Sie unter Konfigurationsdetails. 0.1.0+

Eine vollständige Liste der Konfigurationen finden Sie in der Dokumentation zur Plug-In-Referenz. Alle Azure Maven-Plug-Ins verwenden einen gemeinsamen Satz von Konfigurationen. Diese Konfigurationen finden Sie unter Allgemeine Konfigurationen. App Service-spezifische Konfigurationen finden Sie unter Azure Web App: Konfigurationsdetails.

Notieren Sie sich die Werte <appName> und <resourceGroup> (in der Demo entsprechend petstoreee7-1690443003536 und petstoreee7-1690443003536-rg). Sie werden später verwendet.

4. Bereitstellen der App

Wenn alle Konfigurationseinstellungen in Ihrer Datei pom.xml eingerichtet sind, können Sie Ihre Java-App mit einem einzigen Befehl in Azure bereitstellen.

# Disable testing, as it requires Wildfly to be installed locally.
mvn package azure-webapp:deploy -DskipTests

Nach Abschluss der Bereitstellung steht Ihre Anwendung unter http://<appName>.azurewebsites.net/ (http://petstoreee7-1690443003536.azurewebsites.net in der Demo) bereit. Öffnen Sie die URL in Ihrem lokalen Webbrowser. Folgendes sollte angezeigt werden:

Screenshot der Maven-Web-App „Hello World“, die in Azure App Service ausgeführt wird.

Herzlichen Glückwunsch! Sie haben Ihre erste Java-App in App Service bereitgestellt.

5. Bereinigen von Ressourcen

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt. Wenn Sie die Ressourcen in Zukunft nicht mehr benötigen, löschen Sie die Ressourcengruppe im Portal, oder führen Sie den folgenden Befehl in Cloud Shell aus:

az group delete --name <your resource group name; for example: petstoreee7-1690443003536-rg> --yes

Die Ausführung dieses Befehls kann eine Minute in Anspruch nehmen.

Nächste Schritte