Merge pull request #265087 from cephalin/java-quickstart

add spring boot and tomcat embedded pivots

Author: American-Dipper

articles/app-service/includes/quickstart-java/quickstart-java-quarkus.md renamed to articles/app-service/includes/quickstart-java/quickstart-java-javase.md

@@ -3,18 +3,30 @@ author: cephalin
 ms.service: app-service
 ms.devlang: java
 ms.topic: include
-ms.date: 08/30/2023
+ms.date: 02/10/2024
 ms.author: cephalin
 ---
 
-In this quickstart, you'll use the [Maven Plugin for Azure App Service Web Apps](https://github.com/microsoft/azure-maven-plugins/blob/develop/azure-webapp-maven-plugin/README.md) to deploy a Java web application with an embedded server to [Azure App Service](/azure/app-service/). App Service provides a highly scalable, self-patching web app hosting service. Use the tabs to switch between Tomcat, JBoss, or embedded server (Java SE) instructions.
+In this quickstart, you use the [Maven Plugin for Azure App Service Web Apps](https://github.com/microsoft/azure-maven-plugins/blob/develop/azure-webapp-maven-plugin/README.md) to deploy a Java web application with an embedded server to [Azure App Service](/azure/app-service/). App Service provides a highly scalable, self-patching web app hosting service. Use the tabs to switch between Tomcat, JBoss, or embedded server (Java SE) instructions.
 
-The quickstart uses a [Quarkus](https://quarkus.io) sample, which comes with a bundled web server. You can deploy your own application and server bundle in a single JAR file to App Service instead of the using the Tomcat or JBoss hosting options. If you want, you can also embed a Tomcat server in the JAR file and run that in App Service.
+The quickstart deploys either a Spring Boot app, embedded Tomcat, or Quarkus app using the [azure-webapp-maven-plugin](https://github.com/microsoft/azure-maven-plugins/wiki/Azure-Web-App) plugin.
 
 > [!NOTE]
-> For Spring apps that requires all the Spring services, try [Azure Spring Apps](../../../spring-apps/enterprise/quickstart.md) instead. However, you can deploy Spring Boot apps to App Service.
+> App Service can host Spring apps. For Spring apps that require all the Spring services, try [Azure Spring Apps](../../../spring-apps/quickstart.md) instead.
 
-:::image type="content" source="../../media/quickstart-java/quarkus-hello-world-in-browser-azure-app-service.png" alt-text="Screenshot of Maven Hellow World web app running in Azure App Service in introduction.":::
+### [Spring Boot](#tab/springboot)
+
+:::image type="content" source="../../media/quickstart-java/springboot-hello-world-in-browser-azure-app-service.png" alt-text="Screenshot of Spring Boot Hello World web app running in Azure App Service in introduction.":::
+
+### [Embedded Tomcat](#tab/embeddedtomcat)
+
+:::image type="content" source="../../media/quickstart-java/embedded-tomcat-hello-world-in-browser-azure-app-service.png" alt-text="Screenshot of embedded Tomcat Hello World web app running in Azure App Service in introduction.":::
+
+### [Quarkus](#tab/quarkus)
+
+:::image type="content" source="../../media/quickstart-java/quarkus-hello-world-in-browser-azure-app-service.png" alt-text="Screenshot of Quarkus Hello World web app running in Azure App Service in introduction.":::
+
+-----
 
 If Maven isn't your preferred development tool, check out our similar tutorials for Java developers:
 + [Gradle](../../configure-language-java.md?pivots=platform-linux#gradle)
@@ -28,22 +40,56 @@ If Maven isn't your preferred development tool, check out our similar tutorials
 
 [!INCLUDE [cloud-shell-try-it-no-header.md](../../../../includes/cloud-shell-try-it-no-header.md)]
 
-## 2 - Create a Java app
+## 2 - Get the sample app
 
-Execute the following Maven command in the Cloud Shell prompt to create a new app named `quarkus-hello-azure`:
+### [Spring Boot](#tab/springboot)
 
-```azurecli-interactive
-   mvn io.quarkus.platform:quarkus-maven-plugin:3.2.2.Final:create \
-     -DprojectGroupId=org.acme \
-     -DprojectArtifactId=quarkus-hello-azure  \
-     -Dextensions='resteasy-reactive'
-```
+1. Download and extract the [default Spring Boot web application template](https://github.com/rd-1-2022/rest-service). This repository is cloned for you when you run the [Spring CLI](https://docs.spring.io/spring-cli/reference/creating-new-projects.html) command `spring boot new my-webapp`.
 
-Then change your working directory to the project folder:
+    ```bash
+    git clone https://github.com/rd-1-2022/rest-service my-webapp
+    ```
 
-```azurecli-interactive
-cd quarkus-hello-azure
-```
+1. Change your working directory to the project folder:
+
+    ```azurecli-interactive
+    cd my-webapp
+    ```
+
+### [Embedded Tomcat](#tab/embeddedtomcat)
+
+1. Download and extract the [embeddedTomcatExample](https://github.com/Azure-Samples/java-docs-embedded-tomcat) repository, or clone it locally by running `git clone`:
+
+    ```bash
+    git clone https://github.com/Azure-Samples/java-docs-embedded-tomcat
+    ```
+
+1. Change your working directory to the project folder:
+
+    ```azurecli-interactive
+    cd java-docs-embedded-tomcat
+    ```
+
+    The application is run using the standard [Tomcat](https://tomcat.apache.org/tomcat-9.0-doc/api/org/apache/catalina/startup/Tomcat.html) class (see [Main.java](https://github.com/Azure-Samples/java-docs-embedded-tomcat/blob/main/src/main/java/com/microsoft/azure/appservice/examples/embeddedtomcat/Main.java) in the sample). 
+
+### [Quarkus](#tab/quarkus)
+
+1. Generate a new Quarkus app named `quarkus-hello-azure` with the following Maven command:
+
+    ```azurecli-interactive
+    mvn io.quarkus.platform:quarkus-maven-plugin:3.2.2.Final:create \
+        -DprojectGroupId=org.acme \
+        -DprojectArtifactId=quarkus-hello-azure  \
+        -Dextensions='resteasy-reactive'
+    ```
+
+1. Change your working directory to the project folder:
+
+    ```azurecli-interactive
+    cd quarkus-hello-azure
+    ```
+
+-----
 
 ## 3 - Configure the Maven plugin
 
@@ -52,7 +98,7 @@ The deployment process to Azure App Service uses your Azure credentials from the
 Run the Maven command shown next to configure the deployment. This command helps you to set up the App Service operating system, Java version, and Tomcat version.
 
 ```azurecli-interactive
-mvn com.microsoft.azure:azure-webapp-maven-plugin:2.12.0:config
+mvn com.microsoft.azure:azure-webapp-maven-plugin:2.13.0:config
 ```
 
 1. For **Create new run configuration**, type **Y**, then **Enter**.
@@ -63,8 +109,8 @@ mvn com.microsoft.azure:azure-webapp-maven-plugin:2.12.0:config
 
     ```
     Please confirm webapp properties
-    AppName : quarkus-hello-azure-1690375364238
-    ResourceGroup : quarkus-hello-azure-1690375364238-rg
+    AppName : <generated-app-name>
+    ResourceGroup : <generated-app-name>-rg
     Region : centralus
     PricingTier : P1v2
     OS : Linux
@@ -81,7 +127,7 @@ mvn com.microsoft.azure:azure-webapp-maven-plugin:2.12.0:config
     [INFO] ------------------------------------------------------------------------
     ```
 
-After you've confirmed your choices, the plugin adds the above plugin element and requisite settings to your project's `pom.xml` file that configure your web app to run in Azure App Service.
+After you confirm your choices, the plugin adds the above plugin element and requisite settings to your project's `pom.xml` file that configure your web app to run in Azure App Service.
 
 The relevant portion of the `pom.xml` file should look similar to the following example.
 
@@ -118,13 +164,36 @@ Property | Required | Description | Version
 
 For the complete list of configurations, see the plugin reference documentation. All the Azure Maven Plugins share a common set of configurations. For these configurations see [Common Configurations](https://github.com/microsoft/azure-maven-plugins/wiki/Common-Configuration). For configurations specific to App Service, see [Azure Web App: Configuration Details](https://github.com/microsoft/azure-maven-plugins/wiki/Azure-Web-App:-Configuration-Details).
 
-Be careful about the values of `<appName>` and `<resourceGroup>` (`quarkus-hello-azure-1690375364238` and `quarkus-hello-azure-1690375364238-rg` accordingly in the demo). They're used later.
+Be careful about the values of `<appName>` and `<resourceGroup>`. They're used later.
 
 ## 4 - Deploy the app
 
-With all the configuration ready in your *pom.xml* file, you can deploy your Java app to Azure with one single command.
+With all the configuration ready in your [pom.xml](https://github.com/Azure-Samples/java-docs-embedded-tomcat/blob/main/pom.xml) file, you can deploy your Java app to Azure with one single command.
+
+1. Build the JAR file using the following command:
+
+    ### [Spring Boot](#tab/springboot)
+    
+    ```bash
+    mvn clean package
+    ```
+
+    ### [Embedded Tomcat](#tab/embeddedtomcat)
+    
+    ```bash
+    mvn clean package
+    ```
+
+    To make the application it deployable using [azure-webapp-maven-plugin](https://github.com/microsoft/azure-maven-plugins/wiki/Azure-Web-App), and running on Azure App Service, the sample configures the `package` goal as follows:
+    
+    - Build a single uber JAR file, which contains everything the application needs to run.
+    - Create an [executable JAR](https://en.wikipedia.org/wiki/JAR_(file_format)#Executable_JAR_files) by specifying the Tomcat class as the start-up class.
+    - Replace the original artifact with the uber JAR to ensure that the deploy step deploys the right file.
 
-1. Rebuild the JAR file using the following command:
+    > [!TIP]
+    > Quarkus and Spring Boot both produce two JAR files with `mvn clean package`, but `azure-webapp-maven-plugin` picks the right JAR file to deploy automatically.
+    
+    ### [Quarkus](#tab/quarkus)
 
     ```bash
     mvn clean package -Dquarkus.package.type=uber-jar -D%prod.quarkus.http.port=80 
@@ -137,6 +206,8 @@ With all the configuration ready in your *pom.xml* file, you can deploy your Jav
 
     You can configure these properties by using other means, but they're added to `mvn package` command here for simplicity.
 
+    -----
+
 2. Deploy to Azure by using the following command:
 
    ```bash
@@ -146,7 +217,7 @@ With all the configuration ready in your *pom.xml* file, you can deploy your Jav
     If the deployment succeeds, you see the following output:
 
     ```output
-    [INFO] Successfully deployed the artifact to https://quarkus-hello-azure-1690375364238.azurewebsites.net
+    [INFO] Successfully deployed the artifact to https://<app-name>.azurewebsites.net
     [INFO] ------------------------------------------------------------------------
     [INFO] BUILD SUCCESS
     [INFO] ------------------------------------------------------------------------
@@ -155,11 +226,27 @@ With all the configuration ready in your *pom.xml* file, you can deploy your Jav
     [INFO] ------------------------------------------------------------------------
     ```
 
-Once deployment is completed, your application is ready at `http://<appName>.azurewebsites.net/` (`http://quarkus-hello-azure-1690375364238.azurewebsites.net` in the demo). Open the url with your local web browser, you should see
+### [Spring Boot](#tab/springboot)
+
+Once deployment is completed, your application is ready at `http://<appName>.azurewebsites.net/`. Open the URL `http://<appName>.azurewebsites.net/greeting` with your local web browser (note the `/greeting` path), and you should see:
+
+:::image type="content" source="../../media/quickstart-java/springboot-hello-world-in-browser-azure-app-service.png" alt-text="Screenshot of Spring Boot Hello World web app running in Azure App Service.":::
+
+### [Embedded Tomcat](#tab/embeddedtomcat)
+
+Once deployment is completed, your application is ready at `http://<appName>.azurewebsites.net/`. Open the url with your local web browser, and you should see:
+
+:::image type="content" source="../../media/quickstart-java/embedded-tomcat-hello-world-in-browser-azure-app-service.png" alt-text="Screenshot of embedded Tomcat web app running in Azure App Service.":::
+
+### [Quarkus](#tab/quarkus)
+
+Once deployment is completed, your application is ready at `http://<appName>.azurewebsites.net/`. Open the url with your local web browser, and you should see:
+
+:::image type="content" source="../../media/quickstart-java/quarkus-hello-world-in-browser-azure-app-service.png" alt-text="Screenshot of Quarkus web app running in Azure App Service.":::
 
-:::image type="content" source="../../media/quickstart-java/quarkus-hello-world-in-browser-azure-app-service.png" alt-text="Screenshot of Maven Hellow World web app running in Azure App Service.":::
+-----
 
-**Congratulations!** You've deployed your first Java app to App Service.
+**Congratulations!** You deployed your first Java app to App Service.
 
 ## 5 - Clean up resources
 
@@ -169,4 +256,4 @@ In the preceding steps, you created Azure resources in a resource group. If you
 az group delete --name <your resource group name; for example: quarkus-hello-azure-1690375364238-rg> --yes
 ```
 
-This command may take a minute to run.
+This command might take a minute to run.

articles/app-service/media/quickstart-java/embedded-tomcat-hello-world-in-browser-azure-app-service.png

@@ -5,7 +5,7 @@ keywords: azure, app service, web app, windows, linux, java, maven, quickstart
 ms.assetid: 582bb3c2-164b-42f5-b081-95bfcb7a502a
 ms.devlang: java
 ms.topic: quickstart
-ms.date: 08/31/2023
+ms.date: 02/10/2024
 ms.custom: mvc, mode-other, devdivchpfy22, devx-track-java, devx-track-javaee-jbosseap-appsvc, devx-track-javaee-jbosseap, devx-track-javaee, devx-track-extended-java
 zone_pivot_groups: app-service-java-hosting
 adobe-target: true
@@ -25,9 +25,9 @@ ms.author: cephalin
 
 ::: zone-end
 
-::: zone pivot="java-maven-quarkus"
+::: zone pivot="java-maven-javase"
 
-[!INCLUDE [quickstart-java-windows-maven-pivot.md](./includes/quickstart-java/quickstart-java-quarkus.md)]
+[!INCLUDE [quickstart-java-windows-maven-pivot.md](./includes/quickstart-java/quickstart-java-javase.md)]
 
 ::: zone-end
 

articles/app-service/media/quickstart-java/springboot-hello-world-in-browser-azure-app-service.png

@@ -1225,7 +1225,7 @@ groups:
   title: App Service Java hosting
   prompt: Choose how you want to deploy your Java app
   pivots:
-  - id: java-maven-quarkus
+  - id: java-maven-javase
     title: Embed your own server
   - id: java-maven-tomcat
     title: To a Tomcat server
@@ -3007,4 +3007,4 @@ groups:
   - id: blob-storage-quickstart-scratch
     title: Build from scratch
   - id: blob-storage-quickstart-template
-    title: Start with a template
+    title: Start with a template