edits

Author: KarlErickson

articles/spring-apps/includes/quickstart-deploy-microservice-apps/clean-up-resources.md

@@ -6,7 +6,7 @@ ms.topic: include
 ms.date: 05/24/2022
 ---
 
-<!-- 
+<!--
 For clarity of structure, a separate markdown file is used to describe how to clean up resources using Azure Portal or AZD.
 
 [!INCLUDE [clean-up-resources-portal-or-azd](includes/quickstart-deploy-microservice-apps/clean-up-resources.md)]
@@ -41,4 +41,4 @@ The console outputs messages similar to the following example:
 SUCCESS: Your application was removed from Azure in xx minutes xx seconds.
 ```
 
----
+---

articles/spring-apps/includes/quickstart-deploy-microservice-apps/deploy-microservice-apps-with-basic-standard-plan.md

@@ -3,10 +3,10 @@ author: KarlErickson
 ms.author: v-shilichen
 ms.service: spring-apps
 ms.topic: include
-ms.date: 06/9/2023
+ms.date: 01/03/2024
 ---
 
-<!-- 
+<!--
 For clarity of structure, a separate markdown file is used to describe how to deploy to Azure Spring Apps with Basic/Standard plan.
 
 [!INCLUDE [deploy-microservice-apps-with-basic-standard-plan](includes/quickstart-deploy-microservice-apps/deploy-microservice-apps-with-basic-standard-plan.md)]
@@ -39,11 +39,11 @@ Use the following steps to initialize the Pet Clinic application using Azure Dev
 
    ```output
    Initializing a new project (azd init)
-   
+
    Downloading template code to: <your-local-path>
    (✓) Done: Initialized git repository
    Enter a new environment name: <your-env-name>
-   
+
    SUCCESS: New project initialized!
    You can view the template code in your directory: <your-local-path>
    Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
@@ -225,23 +225,23 @@ Use the following steps to package the app, provision the Azure resources requir
 
    ```output
    Deploying services (azd deploy)
-   
+
    (✓) Done: Deploying service admin-server
    - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io
-   
+
    (✓) Done: Deploying service api-gateway
    - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io
-   
+
    (✓) Done: Deploying service customers-service
    - No endpoints were found
-   
+
    (✓) Done: Deploying service vets-service
    - No endpoints were found
-   
+
    (✓) Done: Deploying service visits-service
    - No endpoints were found
-   
-   
+
+
    SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
    You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
    https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview

articles/spring-apps/includes/quickstart-deploy-microservice-apps/deploy-microservice-apps-with-enterprise-plan.md

@@ -3,10 +3,10 @@ author: KarlErickson
 ms.author: v-shilichen
 ms.service: spring-apps
 ms.topic: include
-ms.date: 9/15/2023
+ms.date: 01/03/2024
 ---
 
-<!-- 
+<!--
 For clarity of structure, a separate markdown file is used to describe how to deploy to Azure Spring Apps with Enterprise plan.
 
 [!INCLUDE [deploy-microservice-apps-with-enterprise-plan](includes/quickstart-deploy-microservice-apps/deploy-microservice-apps-with-enterprise-plan.md)]
@@ -23,50 +23,50 @@ The **Deploy to Azure** button in the next section launches an Azure portal expe
 
 Use the following steps to prepare the project and run the sample locally:
 
-1. Use the following command to clone the [Pet Clinic application](https://github.com/Azure-Samples/spring-petclinic-microservices.git) from GitHub.
+1. Use the following command to clone the [Pet Clinic application](https://github.com/Azure-Samples/spring-petclinic-microservices.git) from GitHub:
 
    ```bash
    git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
    ```
 
 1. Enter the project root directory and use the following command to build the project:
 
-   ```shell
+   ```bash
    ./mvnw clean package -DskipTests
    ```
 
-If you don't want to run the application locally, you can skip the following steps.
+Use the following steps if you want to run the application locally. Otherwise, you can skip these steps.
 
 1. Open a terminal and use the following command to start Config Server:
 
-   ```shell
+   ```bash
    ./mvnw spring-boot:run -pl spring-petclinic-config-server
    ```
 
 1. Open a terminal and use the following command to start Discovery Server:
 
-   ```shell
+   ```bash
    ./mvnw spring-boot:run -pl spring-petclinic-discovery-server
    ```
 
-1. For Customers, Veterinarians, Visits, and Spring Cloud Gateway services, open new terminal and use the following commands to start the services:
+1. For the Customers, Veterinarians, Visits, and Spring Cloud Gateway services, open new terminal and use the following commands to start the services:
 
-   ```shell
+   ```bash
    ./mvnw spring-boot:run -pl spring-petclinic-customers-service
    ./mvnw spring-boot:run -pl spring-petclinic-vets-service
    ./mvnw spring-boot:run -pl spring-petclinic-visits-service
    ./mvnw spring-boot:run -Dspring-boot.run.profiles=default,development \
-     -pl spring-petclinic-api-gateway
+       -pl spring-petclinic-api-gateway
    ```
 
-1. Open a new terminal and enter the project `spring-petclinic-frontend` directory. Use the following commands to install dependencies and run the sample application:
+1. Open a new terminal and enter the project `spring-petclinic-frontend` directory. Use the following commands to install dependencies and run the front end application:
 
-   ```shell
+   ```bash
    npm install
    npm run start
    ````
 
-1. Go to `http://localhost:8080` in your browser to access the application.
+1. After the script completes successfully, go to `http://localhost:8080` in your browser to access the PetClinic application.
 
 ---
 
@@ -122,7 +122,7 @@ The **Deploy to Azure** button in the previous section launches an Azure portal
 
 [!INCLUDE [deploy-spring-apps-maven-plugin](microservice-spring-apps-maven-plugin.md)]
 
-2. Use the following command to deploy the application:
+2. Use the following command to deploy the back end applications:
 
    ```bash
    ./mvnw azure-spring-apps:deploy
@@ -135,28 +135,32 @@ The **Deploy to Azure** button in the previous section launches an Azure portal
    [INFO] Artifact(customers-service-3.0.1.jar) is successfully deployed to deployment(default) of app(customers-service).
    [INFO] Starting Spring App after deploying artifacts...
    [INFO] Deployment Status: Running
-   
+
    ...
-   
+
    [INFO] Start deploying artifact(vets-service-3.0.1.jar) to deployment(default) of app(vets-service)...
    [INFO] Artifact(vets-service-3.0.1.jar) is successfully deployed to deployment(default) of app(vets-service).
    [INFO] Starting Spring App after deploying artifacts...
    [INFO] Deployment Status: Running
-   
+
    ...
-   
+
    [INFO] Start deploying artifact(visits-service-3.0.1.jar) to deployment(default) of app(visits-service)...
    [INFO] Artifact(visits-service-3.0.1.jar) is successfully deployed to deployment(default) of app(visits-service).
    [INFO] Starting Spring App after deploying artifacts...
    [INFO] Deployment Status: Running
    ```
 
-2. Use the following Azure CLI command to deploy the application:
+2. The Azure portal doesn't support deploying the front end applications, so use the following Azure CLI command to deploy the front end application:
 
-   ```bash
-   az spring app deploy --resource-group ${RESOURCE_GROUP} --name ${APP_FRONTEND} \
-     --service ${SPRING_APPS_NAME}  --source-path spring-petclinic-frontend \
-     --build-env BP_WEB_SERVER=nginx --builder ${APP_FRONTEND}
+   ```azurecli
+   az spring app deploy \
+       --resource-group ${RESOURCE_GROUP} \
+       --service ${SPRING_APPS_NAME} \
+       --name ${APP_FRONTEND} \
+       --source-path spring-petclinic-frontend \
+       --build-env BP_WEB_SERVER=nginx \
+       --builder ${APP_FRONTEND}
    ```
 
    After the command is executed, you can see from the following log messages that the deployment was successful:

articles/spring-apps/includes/quickstart-deploy-microservice-apps/microservice-spring-apps-maven-plugin.md

@@ -4,10 +4,10 @@ ms.author: v-shilichen
 ms.service: spring-apps
 ms.custom: event-tier1-build-2022
 ms.topic: include
-ms.date: 11/06/2023
+ms.date: 01/03/2024
 ---
 
-<!-- 
+<!--
 Use the following line at the end of the heading Prerequisites, with blank lines before and after. App deployments with Spring Apps Maven plugin.
 
 [!INCLUDE [microservice-spring-apps-maven-plugin](includes/quickstart-deploy-microservice-apps/microservice-spring-apps-maven-plugin.md)]
@@ -28,4 +28,3 @@ Use the following steps to deploy using the [Maven plugin for Azure Spring Apps]
    - **Use existing Azure Spring Apps in Azure**: Press <kbd>y</kbd> to use the existing Azure Spring Apps instance.
    - **Select apps to expose public access**: Press <kbd>Enter</kbd> to select none.
    - **Confirm to save all the above configurations**: Press <kbd>y</kbd>. If you press <kbd>n</kbd>, the configuration isn't saved in the POM files.
-

articles/spring-apps/includes/quickstart-deploy-microservice-apps/prepare-spring-project.md

@@ -3,10 +3,10 @@ author: KarlErickson
 ms.author: v-shilichen
 ms.service: spring-apps
 ms.topic: include
-ms.date: 05/24/2022
+ms.date: 01/03/2024
 ---
 
-<!-- 
+<!--
 For clarity of structure, a separate markdown file is used to describe how to prepare project locally.
 
 [!INCLUDE [prepare-spring-project](includes/quickstart-deploy-microservice-apps/prepare-spring-project.md)]
@@ -21,10 +21,11 @@ Use the following steps to prepare the sample locally:
    git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
    ```
 
-1. Use the following command to run the sample application:
+1. Use the following command to change directory to the sample root path and then run the sample project locally:
 
    ```bash
+   cd spring-petclinic-microservices
    bash ./scripts/run_all_without_infra.sh
    ```
 
-1. Go to `http://localhost:8080` in your browser to access the application.
+1. After the script completes successfully, go to `http://localhost:8080` in your browser to access the PetClinic application.