Merge pull request #210088 from SteveSaunders1952/v-ssaunders-how-to-staging-environment

Update how-to-staging-environment screenshots

Author: jborsecnik

articles/spring-apps/how-to-staging-environment.md

@@ -1,5 +1,5 @@
 ---
-title: Set up a staging environment in Azure Spring Apps | Microsoft Docs
+title: Set up a staging environment in Azure Spring Apps
 description: Learn how to use blue-green deployment with Azure Spring Apps
 author: karlerickson
 ms.service: spring-apps
@@ -22,10 +22,10 @@ This article explains how to set up a staging deployment by using the blue-green
 
 ## Prerequisites
 
-* Azure Spring Apps instance on a Standard pricing tier
-* [Azure Spring Apps extension](/cli/azure/azure-cli-extensions-overview) for the Azure CLI
+- Azure Spring Apps instance on a Standard pricing tier
+- [Azure Spring Apps extension](/cli/azure/azure-cli-extensions-overview) for the Azure CLI
 
-This article uses an application built from Spring Initializr. If you want to use a different application for this example, you'll need to make a simple change in a public-facing portion of the application to differentiate your staging deployment from production.
+This article uses an application built from Spring Initializr. If you want to use a different application for this example, make a change in a public-facing portion of the application to differentiate your staging deployment from the production deployment.
 
 > [!TIP]
 > [Azure Cloud Shell](https://shell.azure.com) is a free interactive shell that you can use to run the instructions in this article.  It has common, preinstalled Azure tools, including the latest versions of Git, JDK, Maven, and the Azure CLI. If you're signed in to your Azure subscription, start your Cloud Shell instance. To learn more, see [Overview of Azure Cloud Shell](../cloud-shell/overview.md).
@@ -46,8 +46,8 @@ To build the application, follow these steps:
 
 1. Generate the code for the sample app by using Spring Initializr with [this configuration](https://start.spring.io/#!type=maven-project&language=java&platformVersion=2.3.4.RELEASE&packaging=jar&jvmVersion=1.8&groupId=com.example&artifactId=hellospring&name=hellospring&description=Demo%20project%20for%20Spring%20Boot&packageName=com.example.hellospring&dependencies=web,cloud-eureka,actuator,cloud-starter-sleuth,cloud-starter-zipkin,cloud-config-client).
 
-2. Download the code.
-3. Add the following *HelloController.java* source file to the folder *\src\main\java\com\example\hellospring\*:
+1. Download the code.
+1. Add the following *HelloController.java* source file to the folder *\src\main\java\com\example\hellospring\*:
 
    ```java
    package com.example.hellospring;
@@ -67,25 +67,25 @@ To build the application, follow these steps:
    }
    ```
 
-4. Build the *.jar* file:
+1. Build the *.jar* file:
 
    ```azurecli
    mvn clean package -DskipTests
    ```
 
-5. Create the app in your Azure Spring Apps instance:
+1. Create the app in your Azure Spring Apps instance:
 
    ```azurecli
    az spring app create -n demo -g <resourceGroup> -s <Azure Spring Apps instance> --assign-endpoint
    ```
 
-6. Deploy the app to Azure Spring Apps:
+1. Deploy the app to Azure Spring Apps:
 
    ```azurecli
    az spring app deploy -n demo -g <resourceGroup> -s <Azure Spring Apps instance> --jar-path target\hellospring-0.0.1-SNAPSHOT.jar
    ```
 
-7. Modify the code for your staging deployment:
+1. Modify the code for your staging deployment:
 
    ```java
    package com.example.hellospring;
@@ -105,54 +105,53 @@ To build the application, follow these steps:
    }
    ```
 
-8. Rebuild the *.jar* file:
+1. Rebuild the *.jar* file:
 
    ```azurecli
    mvn clean package -DskipTests
    ```
 
-9. Create the green deployment:
+1. Create the green deployment:
 
    ```azurecli
    az spring app deployment create -n green --app demo -g <resourceGroup> -s <Azure Spring Apps instance> --jar-path target\hellospring-0.0.1-SNAPSHOT.jar
    ```
 
 ## View apps and deployments
 
-View deployed apps by using the following procedure:
+Use the following steps to view deployed apps.
 
 1. Go to your Azure Spring Apps instance in the Azure portal.
 
 1. From the left pane, open the **Apps** pane to view apps for your service instance.
 
-   ![Screenshot of the open Apps pane.](media/spring-cloud-blue-green-staging/app-dashboard.png)
+   :::image type="content" source="media/how-to-staging-environment/app-dashboard.png" lightbox="media/how-to-staging-environment/app-dashboard.png" alt-text="Screenshot of the Apps pane showing apps for your service instance.":::
 
-1. You can select an app and view details.
+1. Select an app to view details.
 
-   ![Screenshot of details for an app.](media/spring-cloud-blue-green-staging/app-overview.png)
+   :::image type="content" source="media/how-to-staging-environment/app-overview.png" lightbox="media/how-to-staging-environment/app-overview.png" alt-text="Screenshot of details for an app.":::
 
 1. Open **Deployments** to see all deployments of the app. The grid shows both production and staging deployments.
 
-   ![Screenshot that shows listed app deployments.](media/spring-cloud-blue-green-staging/deployments-dashboard.png)
+   :::image type="content" source="media/how-to-staging-environment/deployments-dashboard.png" lightbox="media/how-to-staging-environment/deployments-dashboard.png" alt-text="Screenshot that shows listed app deployments.":::
 
 1. Select the URL to open the currently deployed application.
 
-   ![Screenshot that shows the U R L for the deployed application.](media/spring-cloud-blue-green-staging/running-blue-app.png)
+   :::image type="content" source="media/how-to-staging-environment/running-blue-app.png" lightbox="media/how-to-staging-environment/running-blue-app.png" alt-text="Screenshot that shows the URL of the deployed application.":::
 
 1. Select **Production** in the **State** column to see the default app.
 
-   ![Screenshot that shows the U R L for the default app.](media/spring-cloud-blue-green-staging/running-default-app.png)
+   :::image type="content" source="media/how-to-staging-environment/running-default-app.png" lightbox="media/how-to-staging-environment/running-default-app.png" alt-text="Screenshot that shows the URL of the default app.":::
 
 1. Select **Staging** in the **State** column to see the staging app.
 
-   ![Screenshot that shows the U R L for the staging app.](media/spring-cloud-blue-green-staging/running-staging-app.png)
+   :::image type="content" source="media/how-to-staging-environment/running-staging-app.png" lightbox="media/how-to-staging-environment/running-staging-app.png" alt-text="Screenshot that shows the URL of the staging app.":::
 
 >[!TIP]
-> * Confirm that your test endpoint ends with a slash (/) to ensure that the CSS file is loaded correctly.
-> * If your browser requires you to enter login credentials to view the page, use [URL decode](https://www.urldecoder.org/) to decode your test endpoint. URL decode returns a URL in the format *https://\<username>:\<password>@\<cluster-name>.test.azureapps.io/gateway/green*. Use this format to access your endpoint.
+> Confirm that your test endpoint ends with a slash (/) to ensure that the CSS file is loaded correctly. If your browser requires you to enter login credentials to view the page, use [URL decode](https://www.urldecoder.org/) to decode your test endpoint. URL decode returns a URL in the format `https://\<username>:\<password>@\<cluster-name>.test.azureapps.io/gateway/green`. Use this format to access your endpoint.
 
 >[!NOTE]
-> Configuration server settings apply to both your staging environment and your production environment. For example, if you set the context path (*server.servlet.context-path*) for your app gateway in the configuration server as *somepath*, the path to your green deployment changes to *https://\<username>:\<password>@\<cluster-name>.test.azureapps.io/gateway/green/somepath/...*.
+> Configuration server settings apply to both your staging environment and your production environment. For example, if you set the context path (*server.servlet.context-path*) for your app gateway in the configuration server as *somepath*, the path to your green deployment changes to `https://\<username>:\<password>@\<cluster-name>.test.azureapps.io/gateway/green/somepath/...`.
 
 If you visit your public-facing app gateway at this point, you should see the old page without your new change.
 
@@ -162,11 +161,11 @@ If you visit your public-facing app gateway at this point, you should see the ol
 
 1. Select the ellipsis after **Registration status** of the green deployment, and then select **Set as production**.
 
-   ![Screenshot that shows selections for setting the staging build to production.](media/spring-cloud-blue-green-staging/set-staging-deployment.png)
+   :::image type="content" source="media/how-to-staging-environment/set-staging-deployment.png" lightbox="media/how-to-staging-environment/set-staging-deployment.png" alt-text="Screenshot that shows selections for setting the staging build to production.":::
 
 1. Confirm that the URL of the app displays your changes.
 
-   ![Screenshot that shows the U R L of the app now in production.](media/spring-cloud-blue-green-staging/new-production-deployment.png)
+   :::image type="content" source="media/how-to-staging-environment/new-production-deployment.png" lightbox="media/how-to-staging-environment/new-production-deployment.png" alt-text="Screenshot that shows the URL of the app now in production.":::
 
 >[!NOTE]
 > After you've set the green deployment as the production environment, the previous deployment becomes the staging deployment.
@@ -191,4 +190,4 @@ az spring app deployment delete -n <staging-deployment-name> -g <resource-group-
 
 ## Next steps
 
-* [CI/CD for Azure Spring Apps](./how-to-cicd.md?pivots=programming-language-java)
+- [CI/CD for Azure Spring Apps](./how-to-cicd.md?pivots=programming-language-java)