Skip to content

Latest commit

 

History

History
266 lines (170 loc) · 8.7 KB

deploy-event-driven-app-enterprise-plan.md

File metadata and controls

266 lines (170 loc) · 8.7 KB
authorms.authorms.servicems.customms.topicms.date
karlerickson
v-shilichen
azure-spring-apps
devx-track-azurecli
include
07/19/2023

2. Prepare the Spring project

Azure portal

The Deploy to Azure button in the next section launches an Azure portal experience that downloads a JAR package from the ASA-Samples-Web-Application releases page on GitHub. No local preparation steps are needed.

Azure portal + Maven plugin

Use the following steps to prepare the sample locally:

[!INCLUDE prepare-spring-project-git-event-driven]

Azure CLI

Use the following steps to prepare the sample locally:

[!INCLUDE prepare-spring-project-git-event-driven]

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. The following sections describe how to create these resources.

Azure portal

[!INCLUDE prepare-cloud-environment-on-azure-portal]

Azure portal + Maven plugin

3.1. Sign in to the Azure portal

Go to the Azure portal and enter your credentials to sign in to the portal. The default view is your service dashboard.

3.2. Create a Service Bus instance

[!INCLUDE provision-service-bus]

  1. Select Queues on the navigation menu, then select Queue.

  2. On the Create Queue page, enter lower-case for Name and then select Create.

  3. Create another queue by repeating the previous step using upper-case for Name.

3.3. Create an Azure Spring Apps instance

[!INCLUDE provision-enterprise-azure-spring-apps]

3.4. Connect app instance to Service Bus instance

Use the following steps to connect your service instances:

  1. Go to your Azure Spring Apps instance in the Azure portal.

  2. From the navigation pane, open the Apps pane and then select Create App.

  3. On the Create App page, for the app name, use simple-event-driven-app and leave all the other fields with their default values.

  4. Select Create to finish creating the app and then select the app to view the details.

  5. Select Service Connector from the navigation pane and then select Create to create a new service connection.

  6. Fill out the Basics tab with the following information:

    • Service type: Select Service Bus.
    • Connection name: Populated with an automatically generated name that you can modify.
    • Subscription: Select your subscription.
    • Namespace: Select the namespace you created.
    • Client type: Select SpringBoot.

  7. Configure the Next: Authentication tab with the following information:

    [!INCLUDE security-note]

    • Select the authentication type you'd like to use between your compute service and target service.: Select Connection string.

  8. Select Next: Networking. Use the default option Configure firewall rules to enable access to target service.

  9. Select Next: Review and Create to review your selections, then select Create to create the connection.

Azure CLI

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.

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:

    az login

  2. Use the following command to set the default location:

    az configure --defaults location=${LOCATION}

  3. Use the following command to list all available subscriptions to determine the subscription ID to use:

    az account list --output table

  4. Use the following command to set the default subscription:

    az account set --subscription <subscription-ID>

  5. Use the following command to create a resource group:

    az group create --resource-group ${RESOURCE_GROUP}

  6. Use the following command to set the newly created resource group as the default resource group:

    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:

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:

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:

az spring app create \ --service ${AZURE_SPRING_APPS_INSTANCE} \ --name ${APP_NAME}

3.5. Create a Service Bus instance

Use the following steps to create a Service Bus instance:

  1. Use the following command to create a Service Bus namespace:

    az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}

  2. Use the following commands to create two queues named lower-case and upper-case:

    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

You've now created both the Service Bus and the app in Azure Spring Apps, 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:

    [!INCLUDE security-note]

    export SERVICE_BUS_CONNECTION_STRING=$( \ az servicebus namespace authorization-rule keys list \ --namespace-name ${SERVICE_BUS_NAME_SPACE} \ --name RootManageSharedAccessKey \ --query primaryConnectionString \ --output tsv)

  2. Use the following command to provide the connection string to the app through an environment variable:

    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

Azure portal

The Deploy to Azure button in the previous section launches an Azure portal experience that includes application deployment, so nothing else is needed.

Azure portal + Maven plugin

[!INCLUDE event-driven-spring-apps-maven-plugin]

  1. Use the following command to deploy the app:

    ./mvnw azure-spring-apps:deploy

    The following list describes the command interaction:

    • OAuth2 login: You need to authorize the sign in to Azure based on the OAuth2 protocol.

    After the command is executed, you can see from the following log messages that the deployment was successful:

    [INFO] Starting Spring App after deploying artifacts... [INFO] Deployment Status: Running

Azure CLI

The cloud environment is now ready. Deploy the app by using the following command:

az spring app deploy \ --service ${AZURE_SPRING_APPS_INSTANCE} \ --name ${APP_NAME} \ --artifact-path target/simple-event-driven-app-0.0.2-SNAPSHOT.jar
close