Merge pull request #239072 from moarychan/moary/quickstart/redesign-event-driven

Redesign quick start doc with standard tier - Launch your first event-driven app

Author: American-Dipper

articles/spring-apps/.openpublishing.redirection.spring-apps.json

@@ -34,6 +34,11 @@
             "source_path": "tutorial-custom-domain.md",
             "redirect_url": "/azure/spring-apps/how-to-custom-domain",
             "redirect_document_id": true
+        },
+        {
+            "source_path": "quickstart-deploy-event-driven-app-standard-consumption.md",
+            "redirect_url": "/azure/spring-apps/quickstart-deploy-event-driven-app",
+            "redirect_document_id": true
         }
     ]
 }

articles/spring-apps/includes/quickstart-deploy-event-driven-app/clean-up-resources.md

@@ -0,0 +1,59 @@
+---
+author: karlerickson
+ms.author: v-shilichen
+ms.service: spring-apps
+ms.topic: include
+ms.date: 07/19/2023
+---
+
+<!-- 
+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-event-driven-app/clean-up-resources.md)]
+
+-->
+
+## 6. Clean up resources
+
+::: zone pivot="sc-consumption-plan,sc-enterprise"
+
+Be sure to delete the resources you created in this article when you no longer need them. To delete the resources, just delete the resource group that contains them. You can delete the resource group using the Azure portal. Alternatively, to delete the resource group by using Azure CLI, use the following command:
+
+```azurecli
+az group delete --name ${RESOURCE_GROUP}
+```
+
+::: zone-end
+
+::: zone pivot="sc-standard"
+
+You can delete the Azure resource group, which includes all the resources in the resource group. Use the following steps to delete the entire resource group, including the newly created service:
+
+### [Azure portal](#tab/Azure-portal)
+
+1. Locate your resource group in the Azure portal. On the navigation menu, select **Resource groups**. Then, select the name of your resource group - for example, **myresourcegroup**.
+
+1. On your resource group page, select **Delete**. Enter the name of your resource group in the text box to confirm deletion - for example, **myresourcegroup** - then, select **Delete**.
+
+### [Azure Developer CLI](#tab/Azure-Developer-CLI)
+
+Use the following command to delete all the Azure resources used in this sample application:
+
+```bash
+azd down
+```
+
+The following list describes the command interactions:
+
+- **Total resources to delete: \<your-resources-total>, are you sure you want to continue?**: Press <kbd>y</kbd>.
+- **Would you like to permanently delete these resources instead, allowing their names to be reused?**: Press <kbd>y</kbd>. Press <kbd>n</kbd> if you want to reuse the Key Vault.
+
+The console outputs messages similar to the following example:
+
+```output
+SUCCESS: Your application was removed from Azure in xx minutes xx seconds.
+```
+
+---
+
+::: zone-end

articles/spring-apps/includes/quickstart-deploy-event-driven-app/deploy-app-azure-spring-apps-event-driven.md

@@ -0,0 +1,90 @@
+---
+author: karlerickson
+ms.author: v-shilichen
+ms.service: spring-apps
+ms.custom: event-tier1-build-2022
+ms.topic: include
+ms.date: 07/19/2023
+---
+
+<!-- 
+For clarity of structure, a separate markdown file is used to describe how to prepare event-driven project.
+
+[!INCLUDE [deployment-event-driven](../../includes/quickstart-deploy-event-driven-app/deployment-event-driven.md)]
+
+-->
+
+This section provides the steps to deploy your application to Azure Spring Apps.
+
+### [Azure portal](#tab/Azure-portal)
+
+Use the following steps to deploy your JAR file with the [Maven plugin for Azure Spring Apps](https://github.com/microsoft/azure-maven-plugins/wiki/Azure-Spring-Apps).
+
+1. Navigate to the sample project directory and use the following command to configure the app for Azure Spring Apps:
+
+   ```bash
+   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.17.0:config
+   ```
+
+   The following list describes the command interactions:
+
+   - **OAuth2 login**: You need to authorize the login to Azure based on the OAuth2 protocol.
+   - **Select subscription**: Select the subscription list number of the Azure Spring Apps instance you created, which defaults to the first subscription in the list. If you use the default number, press <kbd>Enter</kbd>.
+   - **Select Azure Spring Apps for deployment**: Select the list number of the Azure Spring Apps instance you created. If you use the default number, press <kbd>Enter</kbd>.
+   - **Input the app name(simple-event-driven-app)**: Provide an app name. To use the default project artifact ID as the name, press <kbd>Enter</kbd>.
+   - **Expose public access for this app (Simple Event Driven App)?**: Press <kbd>n</kbd>.
+   - **Confirm to save all the above configurations (Y/n)**: Press <kbd>y</kbd>. If you press <kbd>n</kbd>, the configuration isn't saved in the POM file.
+
+1. Use the following command to deploy the app:
+
+   ```bash
+   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.17.0:deploy
+   ```
+
+   The following list describes the command interaction:
+
+   - **OAuth2 login**: You need to authorize the login to Azure based on the OAuth2 protocol.
+
+   After the command is executed, you can see the following output, which indicates that the deployment was successful.
+
+   ```output
+   [INFO] Deployment(default) is successfully updated.
+   [INFO] Deployment Status: Running
+   ```
+
+### [Azure Developer CLI](#tab/Azure-Developer-CLI)
+
+Use the following steps to use AZD to package the app, provision the Azure resources required by the web application, and then deploy to Azure Spring Apps.
+
+1. Use the following command to package a deployable copy of your application:
+
+   ```bash
+   azd package
+   ```
+
+1. Use the following command to deploy the application code to those newly provisioned resources:
+
+   ```bash
+   azd deploy
+   ```
+
+   The console outputs messages similar to the following example:
+
+   ```output
+   Deploying services (azd deploy)
+   
+   WARNING: Feature 'springapp' is in alpha stage.
+   To learn more about alpha features and their support, visit https://aka.ms/azd-feature-stages.
+   
+   (✓) Done: Deploying service simple-event-driven-app
+   - 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
+   ```
+
+> [!NOTE]
+> You can also use `azd up` to combine the previous three commands: `azd package` (packages a deployable copy of your application), `azd provision` (provisions Azure resources), and `azd deploy` (deploys application code). For more information, see [Azure-Samples/ASA-Samples-Event-Driven-Application](https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git).
+
+---

articles/spring-apps/includes/quickstart-deploy-event-driven-app/deploy-event-driven-app-basic-standard-plan.md

@@ -0,0 +1,27 @@
+---
+author: karlerickson
+ms.author: v-shilichen
+ms.service: spring-apps
+ms.custom: event-tier1-build-2022
+ms.topic: include
+ms.date: 07/19/2023
+---
+
+<!-- 
+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-event-driven-app-with-basic-standard-plan](includes/quickstart-deploy-event-driven-app/deploy-event-driven-app-basic-standard-plan.md)]
+
+-->
+
+## 2. Prepare the Spring project
+
+[!INCLUDE [prepare-spring-project-event-driven](../../includes/quickstart-deploy-event-driven-app/prepare-spring-project-event-driven.md)]
+
+## 3. Prepare the cloud environment
+
+[!INCLUDE [prepare-cloud-environment-event-driven](../../includes/quickstart-deploy-event-driven-app/prepare-cloud-environment-event-driven.md)]
+
+## 4. Deploy the app to Azure Spring Apps
+
+[!INCLUDE [deployment-event-driven](../../includes/quickstart-deploy-event-driven-app/deploy-app-azure-spring-apps-event-driven.md)]

articles/spring-apps/includes/quickstart-deploy-event-driven-app/deploy-event-driven-app-enterprise-plan.md

@@ -0,0 +1,159 @@
+---
+author: karlerickson
+ms.author: v-shilichen
+ms.service: spring-apps
+ms.custom: event-tier1-build-2022
+ms.topic: include
+ms.date: 07/19/2023
+---
+
+<!-- 
+For clarity of structure, a separate markdown file is used to describe how to deploy to Azure Spring Apps with Enterprise plan.
+
+[!INCLUDE [deploy-event-driven-app-with-enterprise-plan](includes/quickstart-deploy-event-driven-app/deploy-event-driven-app-enterprise-plan.md)]
+
+-->
+
+## 2. Prepare the Spring project
+
+Use the following steps to prepare the sample locally.
+
+[!INCLUDE [prepare-spring-project-git-event-driven](../../includes/quickstart-deploy-event-driven-app/prepare-spring-project-git-event-driven.md)]
+
+## 3. Prepare the cloud environment
+
+The main resources you need to run this sample are an Azure Spring Apps instance and an Azure Service Bus instance. Use the following steps to create these resources.
+
+### 3.1. Provide names for each resource
+
+Create variables to hold the resource names by using the following commands. Be sure to replace the placeholders with your own values.
+
+```azurecli
+export RESOURCE_GROUP=<event-driven-app-resource-group-name>
+export LOCATION=<desired-region>
+export SERVICE_BUS_NAME_SPACE=<event-driven-app-service-bus-namespace>
+export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-name>
+export APP_NAME=<event-driven-app-name>
+```
+
+### 3.2. Create a new resource group
+
+Use the following steps to create a new resource group:
+
+1. Use the following command to sign in to the Azure CLI:
+
+   ```azurecli
+   az login
+   ```
+
+1. Use the following command to set the default location:
+
+   ```azurecli
+   az configure --defaults location=${LOCATION}
+   ```
+
+1. Use the following command to list all available subscriptions to determine the subscription ID to use:
+
+   ```azurecli
+   az account list --output table
+   ```
+
+1. Use the following command to set the default subscription:
+
+   ```azurecli
+   az account set --subscription <subscription-ID>
+   ```
+
+1. Use the following command to create a resource group:
+
+   ```azurecli
+   az group create --resource-group ${RESOURCE_GROUP}
+   ```
+
+1. Use the following command to set the newly created resource group as the default resource group:
+
+   ```azurecli
+   az configure --defaults group=${RESOURCE_GROUP}
+   ```
+
+### 3.3. Install extension and register namespace
+
+Use the following commands to install the Azure Spring Apps extension for the Azure CLI and register the `Microsoft.SaaS` namespace:
+
+```azurecli
+az extension add --name spring --upgrade
+az provider register --namespace Microsoft.SaaS
+```
+
+### 3.4. Create an Azure Spring Apps instance
+
+Use the following command to create your Azure Spring Apps instance:
+
+```azurecli
+az spring create \
+    --name ${AZURE_SPRING_APPS_INSTANCE} \
+    --sku Enterprise
+```
+
+Then, use the following command to create an app in the Azure Spring Apps instance:
+
+```azurecli
+az spring app create \
+    --service ${AZURE_SPRING_APPS_INSTANCE} \
+    --name ${APP_NAME}
+```
+
+### 3.5. Create a Service Bus instance
+
+Use the following command to create a Service Bus namespace:
+
+```azurecli
+az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
+```
+
+Then, use the following commands to create two queues named `lower-case` and `upper-case`:
+
+```azurecli
+az servicebus queue create \
+    --namespace-name ${SERVICE_BUS_NAME_SPACE} \
+    --name lower-case
+az servicebus queue create \
+    --namespace-name ${SERVICE_BUS_NAME_SPACE} \
+    --name upper-case
+```
+
+### 3.6. Connect app instance to Service Bus instance
+
+Now, both the Service Bus and the app in Azure Spring Apps have been created, but the app can't connect to the Service Bus. Use the following steps to enable the app to connect to the Service Bus, and then deploy the app:
+
+1. Get the Service Bus's connection string by using the following command:
+
+   ```azurecli
+   export SERVICE_BUS_CONNECTION_STRING=$( \
+       az servicebus namespace authorization-rule keys list \
+           --namespace-name ${SERVICE_BUS_NAME_SPACE} \
+           --name RootManageSharedAccessKey \
+           --query primaryConnectionString \
+           --output tsv)
+   ```
+
+1. Use the following command to provide the connection string to the app through an environment variable:
+
+   ```azurecli
+   az spring app update \
+       --service ${AZURE_SPRING_APPS_INSTANCE} \
+       --name ${APP_NAME} \
+       --env SPRING_CLOUD_AZURE_SERVICEBUS_CONNECTIONSTRING=${SERVICE_BUS_CONNECTION_STRING} \
+             SPRING_CLOUD_AZURE_KEYVAULT_SECRET_PROPERTYSOURCEENABLED=false
+   ```
+
+## 4. Deploy the app to Azure Spring Apps
+
+Now the cloud environment is ready. Deploy the app by using the following command:
+
+```azurecli
+az spring app deploy \
+    --service ${AZURE_SPRING_APPS_INSTANCE} \
+    --name ${APP_NAME} \
+    --artifact-path target/simple-event-driven-app-0.0.1-SNAPSHOT.jar
+```