Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Sollte Maven nicht Ihr bevorzugtes Entwicklungstool sein, stehen ähnliche Tutorials für Java-Entwickler zur Verfügung:
Wenn Sie nicht über ein Azure-Konto verfügen, erstellen Sie ein kostenloses Konto , bevor Sie beginnen.
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:
| Auswahlmöglichkeit | 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. |
|
| Rufen Sie https://shell.azure.com auf, oder klicken Sie auf die Schaltfläche Cloud Shell starten, um Cloud Shell im Browser zu öffnen. |
|
| Wählen Sie im Azure-Portal rechts oben im Menü die Schaltfläche Cloud Shell aus. |
|
So verwenden Sie Azure Cloud Shell:
Starten Sie Cloud Shell.
Wählen Sie die Schaltfläche Kopieren für einen Codeblock (oder Befehlsblock) aus, um den Code oder Befehl zu kopieren.
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.
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.14.1:config
Geben Sie bei Create new run configuration (Neue Ausführungskonfiguration erstellen) den Buchstaben Y ein, und drücken Sie dann die EINGABETASTE.
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.
Für den Wert für javaVersion definieren geben Sie 1 für Java 21 ein und drücken Sie dann die Eingabetaste.
Geben Sie den Wert für webContainer definieren, 1 für Tomcat 10.1 ein, und drücken Sie dann Enter.
Geben Sie für Wert für die Preisstufe festlegen3 für P1V2 ein und drücken Sie dann Enter.
Geben Sie für Confirm (Bestätigen) den Buchstaben Y ein, und drücken Sie die EINGABETASTE.
Please confirm webapp properties AppName : helloworld-1745408005556 ResourceGroup : helloworld-1745408005556-rg Region : centralus PricingTier : P1V2 OS : Linux Java Version: Java 21 Web server stack: Tomcat 10.1 Deploy to slot : false Confirm (Y/N) [Y]: [INFO] Saving configuration to pom. [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 01:36 min [INFO] Finished at: 2025-04-23T11:34:44Z [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.
- Die vollständige Liste der 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-1745408005556 und helloworld-1745408005556-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
Nachdem Sie aus einer Liste der verfügbaren Abonnements ausgewählt haben, stellt Maven den Azure App Service bereit. Nach Abschluss der Bereitstellung ist Ihre Anwendung bereit. In dieser Demo ist die URL http://helloworld-1745408005556.azurewebsites.net. Öffnen Sie die URL mit Ihrem lokalen Webbrowser, dann sollten Sie sehen
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-1745408005556-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.
Die Schnellstartanleitung stellt entweder eine Spring Boot-App, eine Quarkus-App oder einen eingebetteten Tomcat mithilfe des azure-webapp-maven-plugin bereit.
Sollte Maven nicht Ihr bevorzugtes Entwicklungstool sein, stehen ähnliche Tutorials für Java-Entwickler zur Verfügung:
Wenn Sie nicht über ein Azure-Konto verfügen, erstellen Sie ein kostenloses Konto , bevor Sie beginnen.
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:
| Auswahlmöglichkeit | 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. |
|
| Rufen Sie https://shell.azure.com auf, oder klicken Sie auf die Schaltfläche Cloud Shell starten, um Cloud Shell im Browser zu öffnen. |
|
| Wählen Sie im Azure-Portal rechts oben im Menü die Schaltfläche Cloud Shell aus. |
|
So verwenden Sie Azure Cloud Shell:
Starten Sie Cloud Shell.
Wählen Sie die Schaltfläche Kopieren für einen Codeblock (oder Befehlsblock) aus, um den Code oder Befehl zu kopieren.
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.
Drücken Sie die EINGABETASTE, um den Code oder Befehl auszuführen.
2 - Abrufen der Beispiel-App
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-webappausführen.git clone https://github.com/rd-1-2022/rest-service my-webappÄ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.14.1:config
Geben Sie bei Create new run configuration (Neue Ausführungskonfiguration erstellen) den Buchstaben Y ein, und drücken Sie dann die EINGABETASTE.
Geben Sie für Define value for OS (Wert für Betriebssystem definieren) 2 für Linux ein, und drücken Sie die EINGABETASTE.
Für den Wert für javaVersion definieren geben Sie 1 für Java 21 ein und drücken Sie dann die Eingabetaste.
Geben Sie für Define value for pricingTier (Wert für pricingTier definieren) 3 für P1v2 ein, und drücken Sie die EINGABETASTE.
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 21 Web server stack: Java SE Deploy to slot : false Confirm (Y/N) [Y]: [INFO] Saving configuration to pom. [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 47.533 s [INFO] Finished at: 2025-04-23T12:20:08Z [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.
- Die vollständige Liste der 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.
Erstellen Sie die JAR-Datei mit den folgenden Befehlen:
mvn clean packageTipp
Spring Boot erzeugt zwei JAR-Dateien mit
mvn package, wählt jedochazure-webapp-maven-plugindie richtige JAR-Datei aus, die automatisch bereitgestellt werden soll.Führen Sie die Bereitstellung in Azure über den folgenden Befehl durch:
mvn azure-webapp:deployNachdem Sie aus einer Liste der verfügbaren Abonnements ausgewählt haben, stellt Maven den Azure App Service bereit. Wenn die Bereitstellung abgeschlossen ist, wird die folgende Ausgabe angezeigt:
[INFO] Successfully deployed the artifact to <URL> [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 02:20 min [INFO] Finished at: 2023-07-26T12:47:50Z [INFO] ------------------------------------------------------------------------Ihre Anwendung ist bereit.
Rufen Sie die Standarddomäne für Ihre App im Azure-Portal ab, indem Sie "Übersicht" für Ihre App auswählen. Fügen Sie /greeting an. Folgendes sollte angezeigt werden:
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.
Sollte Maven nicht Ihr bevorzugtes Entwicklungstool sein, stehen ähnliche Tutorials für Java-Entwickler zur Verfügung:
Wenn Sie nicht über ein Azure-Konto verfügen, erstellen Sie ein kostenloses Konto , bevor Sie beginnen.
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:
| Auswahlmöglichkeit | 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. |
|
| Rufen Sie https://shell.azure.com auf, oder klicken Sie auf die Schaltfläche Cloud Shell starten, um Cloud Shell im Browser zu öffnen. |
|
| Wählen Sie im Azure-Portal rechts oben im Menü die Schaltfläche Cloud Shell aus. |
|
So verwenden Sie Azure Cloud Shell:
Starten Sie Cloud Shell.
Wählen Sie die Schaltfläche Kopieren für einen Codeblock (oder Befehlsblock) aus, um den Code oder Befehl zu kopieren.
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.
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.14.1:config
Geben Sie bei Create new run configuration (Neue Ausführungskonfiguration erstellen) den Buchstaben Y ein, und drücken Sie dann die EINGABETASTE.
Geben Sie für Define value for OS (Wert für Betriebssystem definieren) 2 für Linux ein, und drücken Sie die EINGABETASTE.
Um den Wert für javaVersion zu definieren, geben Sie 2 für Java 17 ein und drücken Sie dann die EINGABETASTE. Wenn Sie Java 21 auswählen, wird Jbosseap später nicht als Option angezeigt.
Geben Sie zur Definition des Wertes für webContainer4 für Jbosseap 7 ein und drücken Sie dann die Eingabetaste.
Geben Sie für Define value for pricingTier (Wert für pricingTier definieren) 1 für P1v3 ein, und drücken Sie die EINGABETASTE.
Geben Sie für Confirm (Bestätigen) den Buchstaben Y ein, und drücken Sie die EINGABETASTE.
Please confirm webapp properties AppName : petstoreee7-1745409173307 ResourceGroup : petstoreee7-1745409173307-rg Region : centralus PricingTier : P1v3 OS : Linux Java Version: Java 17 Web server stack: Jbosseap 4 Deploy to slot : false Confirm (Y/N) [Y]: [INFO] Saving configuration to pom. [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 01:36 min [INFO] Finished at: 2025-04-23T11:54:22Z [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.
- Die vollständige Liste der 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-1745409173307 und petstoreee7-1745409173307-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
Nachdem Sie aus einer Liste der verfügbaren Abonnements ausgewählt haben, stellt Maven den Azure App Service bereit. Nach Abschluss der Bereitstellung ist Ihre Anwendung bereit. In dieser Demo ist die URL http://petstoreee7-1745409173307.azurewebsites.net. Öffnen Sie die URL mit Ihrem lokalen Webbrowser, dann sollten Sie sehen
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-1745409173307-rg> --yes
Die Ausführung dieses Befehls kann eine Minute in Anspruch nehmen.