Quickstart: Een Java-app maken in Azure-app Service

Azure App Service biedt een uiterst schaalbare webhostingservice met een zelfherstellend vermogen. In deze quickstart gebruikt u de Maven-invoegtoepassing voor Azure App Service Web Apps om een Java-webtoepassing te implementeren op een Linux Tomcat-server in Azure App Service.

Als Maven niet uw favoriete ontwikkelhulpprogramma is, raadpleegt u vergelijkbare artikelen voor Java-ontwikkelaars:

Vereiste voorwaarden

Als u geen Azure-account hebt, maak dan een gratis account aan voordat u begint.
Voer de opdrachten in deze quickstart uit met behulp van Azure Cloud Shell, een interactieve shell die u via uw browser kunt gebruiken om met Azure-services te werken. Cloud Shell gebruiken:
1. Selecteer de volgende knop Cloud Shell starten of ga naar Cloud Shell openen https://shell.azure.com in uw browser.
2. Meld u indien nodig aan bij Azure en zorg ervoor dat u zich in de Bash-omgeving van Cloud Shell bevindt.
3. Selecteer Kopiëren in een codeblok, plak de code in Cloud Shell en voer deze uit.

Een Java-app maken

Voer de volgende Maven-opdracht uit in Cloud Shell om een nieuwe app met de naam helloworldte maken:

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

Wijzig uw werkmap naar de projectmap door cd helloworld te gebruiken.

De Maven-invoegtoepassing configureren

Het Implementatieproces van App Service maakt automatisch gebruik van uw Azure-referenties van Cloud Shell. De Maven-invoegtoepassing authenticeert met OAuth of apparaat aanmelding. Zie Authenticationvoor meer informatie.

Voer de volgende Maven-opdracht uit om de implementatie te configureren door het App Service-besturingssysteem, de Java-versie en de Tomcat-versie in te stellen.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

Als u een nieuwe uitvoeringsconfiguratie wilt maken, typt u Y en drukt u op Enter.
Voor De waarde Definiëren voor het besturingssysteemtypt u 2 voor Linux en drukt u op Enter.
Voor De waarde Definiëren voor javaVersiontypt u 1 voor Java 21 en drukt u op Enter.
Voor Waarde definiëren voor webContainertypt u 1 voor Tomcat 10.1 en drukt u op Enter.
Voor Waarde definiëren voor pricingTiertypt u 3 voor P1V2 en drukt u op Enter.
Voor Bevestigentypt u Y en drukt u op Enter.

De uitvoer moet er ongeveer uitzien als de volgende code:

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

Nadat u uw keuzes hebt bevestigd, voegt de invoegtoepassing het invoegtoepassingselement en de vereiste instellingen toe aan het pom.xml-bestand van uw project, waarmee uw web-app wordt geconfigureerd voor uitvoering in App Service.

Het relevante gedeelte van het pom.xml-bestand moet er ongeveer uitzien als in het volgende voorbeeld.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>helloworld-1745408005556-rg</resourceGroup>
                <appName>helloworld-1745408005556</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

De waarden voor <appName> en <resourceGroup>, helloworld-1745408005556 en helloworld-1745408005556-rg voor de demo-app, worden later gebruikt.

U kunt de configuraties voor App Service rechtstreeks in uw pom.xml-bestand wijzigen.

Zie Common Configurations voor de volledige lijst met configuraties.
Zie Azure Web App: Configuratiedetails voor configuraties die specifiek zijn voor App Service.

De app implementeren

Als alle configuraties klaar zijn in het pom.xml-bestand , kunt u uw Java-app implementeren in Azure met de volgende enkele opdracht.

mvn package azure-webapp:deploy

Zodra u een keuze hebt gemaakt uit een lijst met beschikbare abonnementen, wordt Maven geïmplementeerd in Azure App Service. Wanneer de implementatie is voltooid, is uw toepassing gereed.

Voor deze demo is de URL http://helloworld-1745408005556.azurewebsites.net. Wanneer u de URL opent met uw lokale webbrowser, ziet u de volgende app:

Schermopname van de Maven Hello World-web-app die wordt uitgevoerd in Azure App Service.

Gefeliciteerd. U hebt een Java-app geïmplementeerd in App Service.

De hulpbronnen opschonen

U hebt de resources voor deze zelfstudie gemaakt in een Azure-resourcegroep. Als u ze niet meer nodig hebt, kunt u de resourcegroep en alle bijbehorende resources verwijderen door de volgende Azure CLI-opdracht uit te voeren in Cloud Shell.

az group delete --name helloworld-1745408005556-rg --yes

Het uitvoeren van de opdracht kan enige tijd duren.

Azure App Service biedt een uiterst schaalbare, zelfreparerende webapp-hostingservice. In deze quickstart gebruikt u de Maven-invoegtoepassing voor Azure App Service Web Apps om een Java-webtoepassing te implementeren met een ingesloten Spring Boot-, Quarkus- of Tomcat-server in App Service. Zie azure-webapp-maven-plugin voor meer informatie.

Als Maven niet uw favoriete ontwikkelhulpprogramma is, raadpleegt u vergelijkbare artikelen voor Java-ontwikkelaars:

Vereiste voorwaarden

Als u geen Azure-account hebt, maak dan een gratis account aan voordat u begint.
Voer de opdrachten in deze quickstart uit met behulp van Azure Cloud Shell, een interactieve shell die u via uw browser kunt gebruiken om met Azure-services te werken. Cloud Shell gebruiken:
1. Selecteer de volgende knop Cloud Shell starten of ga naar Cloud Shell openen https://shell.azure.com in uw browser.
2. Meld u indien nodig aan bij Azure en zorg ervoor dat u zich in de Bash-omgeving van Cloud Shell bevindt.
3. Selecteer Kopiëren in een codeblok, plak de code in Cloud Shell en voer deze uit.

De voorbeeld-app downloaden

Kies het juiste tabblad en volg de instructies om de voorbeeld-Spring Boot-, Quarkus- of Embedded Tomcat-web-app op te halen.

Download en pak de standaardsjabloon voor Spring Boot-webtoepassingen of kloon deze door de volgende opdracht uit te voeren. Als u de Spring CLI-opdrachtspring boot new my-webapp uitvoert, wordt ook de web-app gekloond.

git clone https://github.com/rd-1-2022/rest-service my-webapp

Verander vervolgens uw werkmap naar de projectmap door cd my-webapp uit te voeren.

Genereer een nieuwe Quarkus-app met de naam quarkus-hello-azure door de volgende Maven-opdracht uit te voeren:

mvn io.quarkus.platform:quarkus-maven-plugin:3.21.3:create \
    -DprojectGroupId=org.acme \
    -DprojectArtifactId=quarkus-hello-azure  \
    -Dextensions='resteasy-reactive'

Wijzig uw werkmap naar de projectmap door cd quarkus-hello-azure uit te voeren.

Download en pak de opslagplaats embeddedTomcatExample uit of kloon deze lokaal door de volgende git clone opdracht uit te voeren.
```
git clone https://github.com/Azure-Samples/java-docs-embedded-tomcat
```
Wijzig uw werkmap naar de projectmap door het commando cd java-docs-embedded-tomcat uit te voeren.
Voer de toepassing uit met behulp van de standaard Tomcat-klasse . Zie Main.java in het voorbeeld.

De Maven-invoegtoepassing configureren

Het Implementatieproces van App Service maakt automatisch gebruik van uw Azure-referenties van Cloud Shell. De Maven-plugin authenticeert met OAuth of apparaataanmelding. Zie Authenticationvoor meer informatie.

Voer de volgende Maven-opdracht uit om de implementatie te configureren door het App Service-besturingssysteem en de Java-versie in te stellen.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

Als u een nieuwe uitvoeringsconfiguratie wilt maken, typt u Y en drukt u op Enter.
Voor De waarde Definiëren voor het besturingssysteemtypt u 2 voor Linux en drukt u op Enter.
Voor De waarde Definiëren voor javaVersiontypt u 1 voor Java 21 en drukt u op Enter.
Voor Waarde definiëren voor pricingTiertypt u 3 voor P1v2 en drukt u op Enter.
Voor Bevestigentypt u Y en drukt u op Enter.

De uitvoer moet er ongeveer uitzien als de volgende code:

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

Nadat u uw keuzes hebt bevestigd, voegt de invoegtoepassing het invoegtoepassingselement en de vereiste instellingen toe aan het pom.xml-bestand van uw project, waarmee uw web-app wordt geconfigureerd voor uitvoering in App Service.

Het relevante gedeelte van het pom.xml-bestand moet er ongeveer uitzien als in het volgende voorbeeld.

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

De waarden voor <appName> en <resourceGroup> worden later gebruikt.

U kunt de configuraties voor App Service rechtstreeks in uw pom.xml-bestand wijzigen.

Zie Common Configurations voor de volledige lijst met configuraties.
Zie Azure Web App: Configuratiedetails voor configuraties die specifiek zijn voor App Service.

De app implementeren

Nu alle configuraties klaar zijn in uw pom.xml-bestand , kunt u uw Java-app implementeren in Azure.

Bouw het JAR-bestand met behulp van de volgende opdracht.
```
 mvn clean package
```
Aanbeveling

Spring Boot produceert twee JAR-bestanden met mvn package, maar het azure-webapp-maven-plugin juiste JAR-bestand wordt automatisch geïmplementeerd.

Implementeer de app in Azure met behulp van de volgende opdracht:

mvn azure-webapp:deploy

Zodra u een keuze hebt gemaakt uit een lijst met beschikbare abonnementen, wordt Maven geïmplementeerd in Azure App Service. Wanneer de implementatie is voltooid, is uw toepassing gereed en ziet u de volgende uitvoer:

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

Open het standaarddomein van uw app op de pagina Overzicht in Azure Portal en voeg deze toe aan /greeting de URL. U ziet nu de volgende app:

Bouw het JAR-bestand met behulp van de volgende opdracht.
```
echo '%prod.quarkus.http.port=${PORT}' >> src/main/resources/application.properties
mvn clean package -Dquarkus.package.jar.type=uber-jar
```
Stel de Quarkus-poort in het bestand application.properties in op de PORT omgevingsvariabele in de Linux Java-container. Dquarkus.package.jar.type=uber-jar vertelt Maven om een Uber-Jar aan te maken, inclusief alle afhankelijkheden in het JAR-bestand.

Aanbeveling

Quarkus produceert twee JAR-bestanden met mvn package, maar azure-webapp-maven-plugin kiest het juiste JAR-bestand dat automatisch moet worden geïmplementeerd.

Implementeer de app in Azure met behulp van de volgende opdracht:

mvn azure-webapp:deploy

Zodra u een keuze hebt gemaakt uit een lijst met beschikbare abonnementen, wordt Maven geïmplementeerd in Azure App Service. Wanneer de implementatie is voltooid, is uw toepassing gereed en ziet u de volgende uitvoer:

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

Open het standaarddomein van uw app vanuit het overzicht in Azure Portal en voeg deze toe aan /hello de URL. U zou de volgende app moeten zien:

Bouw het JAR-bestand met behulp van de volgende opdracht.
```
mvn clean package
```
Als u de toepassing wilt implementeren met behulp van de azure-webapp-maven-plugin en deze wilt uitvoeren in Azure App Service, configureert het voorbeeld het package doel als volgt:
- Hiermee wordt één Uber JAR-bestand gebouwd dat alles bevat wat de toepassing moet uitvoeren.
- Hiermee maakt u een uitvoerbaar JAR-bestand door de Tomcat-klasse op te geven als opstartklasse.
- "Vervangt het oorspronkelijke artefact met de Uber-Jar om ervoor te zorgen dat de implementatiestap het juiste bestand uitrolt."

Implementeer de app in Azure met behulp van de volgende opdracht:

mvn azure-webapp:deploy

Zodra u een keuze hebt gemaakt uit een lijst met beschikbare abonnementen, wordt Maven geïmplementeerd in Azure App Service. Wanneer de implementatie is voltooid, is uw toepassing gereed en ziet u de volgende uitvoer:

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

Open de URL voor het standaarddomein van uw app vanuit het overzicht in Azure Portal. U zou de volgende app moeten zien:

Gefeliciteerd. U hebt een Java-app geïmplementeerd in App Service.

De hulpbronnen opschonen

U hebt de resources voor deze zelfstudie gemaakt in een Azure-resourcegroep. Als u ze niet meer nodig hebt, kunt u de resourcegroep en alle bijbehorende resources verwijderen door de volgende Azure CLI-opdracht uit te voeren in Cloud Shell.

az group delete --name <resource group name>  --yes

Voer bijvoorbeeld het volgende uit az group delete --name quarkus-hello-azure-1690375364238-rg --yes. Het uitvoeren van deze opdracht kan enige tijd duren.

Azure App Service biedt een uiterst schaalbare, zelfreparerende webapp-hostingservice. In deze quickstart gebruikt u de Maven-invoegtoepassing voor Azure App Service Web Apps om een Java-webtoepassing te implementeren op een Linux JBoss EAP-server in Azure App Service.

Als Maven niet uw favoriete ontwikkelhulpprogramma is, raadpleegt u vergelijkbare artikelen voor Java-ontwikkelaars:

Vereiste voorwaarden

Als u geen Azure-account hebt, maak dan een gratis account aan voordat u begint.
Voer de opdrachten in deze quickstart uit met behulp van Azure Cloud Shell, een interactieve shell die u via uw browser kunt gebruiken om met Azure-services te werken. Cloud Shell gebruiken:
1. Selecteer de volgende knop Cloud Shell starten of ga naar Cloud Shell openen https://shell.azure.com in uw browser.
2. Meld u indien nodig aan bij Azure en zorg ervoor dat u zich in de Bash-omgeving van Cloud Shell bevindt.
3. Selecteer Kopiëren in een codeblok, plak de code in Cloud Shell en voer deze uit.

Een Java-app maken

Kloon de Pet Store-demotoepassing.

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

Wijzig de map in het voltooide petstore-ee7 project en bouw het.
```
cd app-service-java-quickstart
git checkout 20230308
cd petstore-ee7
mvn clean install
```
Als u een bericht ziet over een losgekoppelde HEAD-status, kunt u dit negeren. Er wordt geen Git-commit gemaakt in deze quickstart, dus de losgekoppelde HEAD-status is geschikt.

Aanbeveling

Voor het petstore-ee7 voorbeeld is Java 11 of hoger vereist. Voor het booty-duke-app-service voorbeeldproject is Java 17 vereist. Als uw geïnstalleerde versie van Java kleiner is dan 17, voert u de build uit vanuit de map petstore-ee7 in plaats van op het hoogste niveau.

De Maven-invoegtoepassing configureren

Het Implementatieproces van App Service maakt automatisch gebruik van uw Azure-referenties van Cloud Shell. De Maven-plugin authenticeert met OAuth of apparaataanmelding. Zie Authenticationvoor meer informatie.

Voer de volgende Maven-opdracht uit om de implementatie te configureren door het App Service-besturingssysteem, de Java-versie en de Jbosseap-versie in te stellen.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

Als u een nieuwe uitvoeringsconfiguratie wilt maken, typt u Y en drukt u op Enter.
Voor De waarde Definiëren voor het besturingssysteemtypt u 2 voor Linux en drukt u op Enter.
Voor De waarde Definiëren voor javaVersiontypt u 2 voor Java 17 en drukt u op Enter. Als u Java 21 selecteert, ziet u Jbosseap later niet als een optie.
Voor Waarde definiëren voor webContainertypt u 4 voor Jbosseap 7 en drukt u op Enter.
Voor Waarde definiëren voor pricingTiertypt u 1 voor P1v3 en drukt u op Enter.
Voor Bevestigentypt u Y en drukt u op Enter.

De uitvoer moet er ongeveer uitzien als de volgende code:

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

Nadat u uw keuzes hebt bevestigd, voegt de invoegtoepassing het invoegtoepassingselement en de vereiste instellingen toe aan het pom.xml-bestand van uw project, waarmee uw web-app wordt geconfigureerd voor uitvoering in App Service.

Het relevante gedeelte van het pom.xml-bestand moet er ongeveer uitzien als in het volgende voorbeeld.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>petstoreee7-1745409173307-rg</resourceGroup>
                <appName>petstoreee7-1745409173307</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

De waarden voor <appName> en <resourceGroup>, petstoreee7-1745409173307 en petstoreee7-1745409173307-rg in de demo-app, worden later gebruikt.

U kunt de configuraties voor App Service rechtstreeks in uw pom.xml-bestand wijzigen.

Zie Common Configurations voor de volledige lijst met configuraties.
Zie Azure Web App: Configuratiedetails voor configuraties die specifiek zijn voor App Service.

De app implementeren

Als alle configuraties klaar zijn in uw pom.xml-bestand , kunt u uw Java-app implementeren in Azure met de volgende enkele opdracht.

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

Zodra u een keuze hebt gemaakt uit een lijst met beschikbare abonnementen, wordt Maven geïmplementeerd in Azure App Service. Wanneer de implementatie is voltooid, is uw toepassing gereed.

Voor deze demo-app is de URL http://petstoreee7-1745409173307.azurewebsites.net. Wanneer u de URL opent met uw lokale webbrowser, ziet u de volgende app:

Schermopname van de Maven Hello World-web-app die wordt uitgevoerd in Azure App Service.

Gefeliciteerd. U hebt een Java-app geïmplementeerd in App Service.

De hulpbronnen opschonen

U hebt de resources voor deze zelfstudie gemaakt in een Azure-resourcegroep. Als u ze niet meer nodig hebt, kunt u de resourcegroep en alle bijbehorende resources verwijderen door de volgende Azure CLI-opdracht uit te voeren in Cloud Shell.

az group delete --name petstoreee7-1745409173307-rg  --yes

Het uitvoeren van de opdracht kan enige tijd duren.

Delen via

Vereiste voorwaarden

Een Java-app maken

De Maven-invoegtoepassing configureren

De app implementeren

De hulpbronnen opschonen

Vereiste voorwaarden

De voorbeeld-app downloaden

De Maven-invoegtoepassing configureren

De app implementeren

De hulpbronnen opschonen

Vereiste voorwaarden

Een Java-app maken

De Maven-invoegtoepassing configureren

De app implementeren

De hulpbronnen opschonen

Verwante inhoud

Feedback

Aanvullende resources