Skip to content

provision-enterprise-azure-spring-apps-azure-cli.md

Latest commit

 

History

History
296 lines (240 loc) · 8.2 KB

provision-enterprise-azure-spring-apps-azure-cli.md

File metadata and controls

296 lines (240 loc) · 8.2 KB
author karlerickson
ms.author v-shilichen
ms.service azure-spring-apps
ms.custom devx-track-azurecli
ms.topic include
ms.date 08/19/2025
ms.update-cycle 1095-days

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 LOCATION=<location>
export RESOURCE_GROUP=myresourcegroup
export SPRING_APPS=myasa
export APP_FRONTEND=frontend
export APP_CUSTOMERS_SERVICE=customers-service
export APP_VETS_SERVICE=vets-service
export APP_VISITS_SERVICE=visits-service
export GIT_CONFIG_REPO=default

3.2. Sign in to the Azure CLI

Use the following steps to sign in:

  1. Use the following command to sign in to the Azure CLI:

    az login

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

    az account list --output table

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

    az account set --subscription <subscription-ID>

3.3. Create a new resource group

Use the following steps to create a new resource group:

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

    az configure --defaults location=${LOCATION}

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

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

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

    az configure --defaults group=${RESOURCE_GROUP}

3.4. 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.5. Create an Azure Spring Apps instance

Use the following steps to create the service instance:

  1. Use the following command to accept the legal terms and privacy statements for the Enterprise plan:

    [!NOTE] This step is necessary only if your subscription has never been used to create an Enterprise plan instance of Azure Spring Apps.

    az term accept \
    --publisher vmware-inc \
    --product azure-spring-cloud-vmware-tanzu-2 \
    --plan asa-ent-hr-mtr

  2. Use the following command to create an Azure Spring Apps service instance with the necessary Tanzu components:

    az spring create \
    --name ${SPRING_APPS} \
    --sku Enterprise \
    --enable-application-configuration-service \
    --enable-service-registry \
    --enable-gateway \
    --enable-application-live-view

3.6. Configure the Azure Spring Apps instance

Use the following steps to configure the service instance:

  1. Use the following command to configure diagnostic settings for the Azure Spring Apps instance:

    export SPRING_APPS_RESOURCE_ID=$(az spring show \
    --name ${SPRING_APPS} \
    --query id \
    --output tsv)
az monitor diagnostic-settings create \
    --resource ${SPRING_APPS_RESOURCE_ID} \
    --name logs-and-metrics \
    --workspace ${SPRING_APPS} \
    --logs '[
      {
        "category": "ApplicationConsole",
        "enabled": true,
        "retentionPolicy": {
          "enabled": false,
          "days": 0
        }
      },
      {
         "category": "SystemLogs",
         "enabled": true,
         "retentionPolicy": {
           "enabled": false,
           "days": 0
         }
      },
      {
         "category": "IngressLogs",
         "enabled": true,
         "retentionPolicy": {
           "enabled": false,
           "days": 0
          }
      }
    ]' \
    --metrics '[
      {
        "category": "AllMetrics",
        "enabled": true,
        "retentionPolicy": {
          "enabled": false,
          "days": 0
        }
      }
    ]'

  2. Use the following commands to create applications for the Azure Spring Apps instance:

    az spring app create --service ${SPRING_APPS} --name ${APP_FRONTEND}
az spring app create --service ${SPRING_APPS} --name ${APP_CUSTOMERS_SERVICE}
az spring app create --service ${SPRING_APPS} --name ${APP_VETS_SERVICE}
az spring app create --service ${SPRING_APPS} --name ${APP_VISITS_SERVICE}

  3. Use the following commands to bind applications for the Service Registry:

    az spring service-registry bind --service ${SPRING_APPS} --app ${APP_CUSTOMERS_SERVICE}
az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VETS_SERVICE}
az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VISITS_SERVICE}

  4. Use the following command to create a configuration repository for the Application Configuration Service:

    az spring application-configuration-service git repo add \
    --service ${SPRING_APPS} \
    --name ${GIT_CONFIG_REPO} \
    --patterns application,api-gateway,customers-service,vets-service,visits-service \
    --uri https://github.com/Azure-Samples/spring-petclinic-microservices-config.git \
    --label master

  5. Use the following commands to bind applications to the Application Configuration Service:

    az spring application-configuration-service bind \
    --service ${SPRING_APPS} \
    --app ${APP_CUSTOMERS_SERVICE}
az spring application-configuration-service bind \
    --service ${SPRING_APPS} \
    --app ${APP_VETS_SERVICE}
az spring application-configuration-service bind \
    --service ${SPRING_APPS} \
    --app ${APP_VISITS_SERVICE}

  6. Use the following command to assign an endpoint to Spring Cloud Gateway:

    az spring gateway update --service ${SPRING_APPS} --assign-endpoint

  7. Use the following command to set routing for the customers-service application:

    az spring gateway route-config create \
    --service ${SPRING_APPS} \
    --name ${APP_CUSTOMERS_SERVICE} \
    --app-name ${APP_CUSTOMERS_SERVICE} \
    --routes-json '[
      {
        "predicates": [
          "Path=/api/customer/**"
        ],
        "filters": [
          "StripPrefix=2"
        ]
      }
   ]'

  8. Use the following command to set routing for the vets-service application:

    az spring gateway route-config create \
    --service ${SPRING_APPS} \
    --name ${APP_VETS_SERVICE} \
    --app-name ${APP_VETS_SERVICE} \
    --routes-json '[
      {
        "predicates": [
          "Path=/api/vet/**"
        ],
        "filters": [
          "StripPrefix=2"
        ]
      }
    ]'

  9. Use the following command to set routing for the visits-service application:

    az spring gateway route-config create \
    --service ${SPRING_APPS} \
    --name ${APP_VISITS_SERVICE} \
    --app-name ${APP_VISITS_SERVICE} \
    --routes-json '[
      {
        "predicates": [
          "Path=/api/visit/**"
        ],
        "filters": [
          "StripPrefix=2"
        ]
      }
    ]'

  10. Use the following command to set routing for the frontend application:

    az spring gateway route-config create \
    --service ${SPRING_APPS} \
    --name ${APP_FRONTEND} \
    --app-name ${APP_FRONTEND} \
    --routes-json '[
      {
        "predicates": [
          "Path=/**"
        ],
        "filters": [
          "StripPrefix=0"
        ],
        "order": 1000
      }
    ]'

  11. Use the following command to assign an endpoint to Application Live View:

    az spring dev-tool update --service ${SPRING_APPS} --assign-endpoint