Quickstart: Provision an Azure Spring Apps service instance

Note

Azure Spring Apps is the new name for the Azure Spring Cloud service. Although the service has a new name, you'll see the old name in some places for a while as we work to update assets such as screenshots, videos, and diagrams.

This article applies to: ✔️ Basic/Standard tier ❌ Enterprise tier

In this quickstart, you use the Azure CLI to provision an instance of the Azure Spring Apps service.

Prerequisites

• An Azure subscription. If you don't have a subscription, create a free account before you begin.
• .NET Core 3.1 SDK. The Azure Spring Apps service supports .NET Core 3.1 and later versions.
• Azure CLI version 2.0.67 or higher.
• Git.

Install Azure CLI extension

Verify that your Azure CLI version is 2.0.67 or later:

az --version

Install the Azure Spring Apps extension for the Azure CLI using the following command:

az extension add --name spring

Sign in to Azure

1. Sign in to the Azure CLI.

   az login
   

2. If you have more than one subscription, choose the one you want to use for this quickstart.

   az account list -o table
   

   az account set --subscription <Name or ID of a subscription from the last step>
   

Provision an instance of Azure Spring Apps

1. Create a resource group to contain your Azure Spring Apps service. The resource group name can include alphanumeric, underscore, parentheses, hyphen, period (except at end), and Unicode characters.

   az group create --location eastus --name <resource group name>
   

2. Provision an instance of Azure Spring Apps service. The service instance name must be unique, between 4 and 32 characters long, and can contain only lowercase letters, numbers, and hyphens. The first character of the service name must be a letter and the last character must be either a letter or a number.

   az spring create -n <service instance name> -g <resource group name>
   

   This command might take several minutes to complete.

3. Set your default resource group name and service instance name so you don't have to repeatedly specify these values in subsequent commands.

   az config set defaults.group=<resource group name>
   

   az config set defaults.spring-cloud=<service instance name>
   

You can provision an instance of the Azure Spring Apps service using the Azure portal or the Azure CLI. Both methods are explained in the following procedures.

Prerequisites

• JDK 17
• An Azure subscription. If you don't have a subscription, create a free account before you begin.
• (Optional) Azure CLI version 2.44.0 or higher. Install the Azure Spring Apps extension with the following command: az extension add --name spring
• (Optional) the Azure Toolkit for IntelliJ.

Provision an instance of Azure Spring Apps

Portal

The following procedure creates an instance of Azure Spring Apps using the Azure portal.

1. In a new tab, open the Azure portal.

2. From the top search box, search for Azure Spring Apps.

3. Select Azure Spring Apps from the results.

   

4. On the Azure Spring Apps page, select Create.

   

5. Fill out the form on the Azure Spring Apps Create page. Consider the following guidelines:

   • Subscription: Select the subscription you want to be billed for this resource.
   • Resource group: Creating new resource groups for new resources is a best practice. You will use this value in later steps as <resource group name>.
   • Service Details/Name: Specify the <service instance name>. The name must be between 4 and 32 characters long and can contain only lowercase letters, numbers, and hyphens. The first character of the service name must be a letter and the last character must be either a letter or a number.
   • Location: Select the location for your service instance.
   • Select Standard for the Pricing tier option.

   

6. Select Review and create.

I ran into an issue

CLI

The following procedure uses the Azure CLI extension to provision an instance of Azure Spring Apps.

1. Update the Azure CLI with the Azure Spring Apps extension.

   az extension update --name spring
   

2. Sign in to the Azure CLI and choose your active subscription.

   az login
   az account list -o table
   az account set --subscription <Name or ID of subscription, skip if you only have 1 subscription>
   

3. Prepare a name for your Azure Spring Apps service. The name must be between 4 and 32 characters long and can contain only lowercase letters, numbers, and hyphens. The first character of the service name must be a letter and the last character must be either a letter or a number.

4. Create a resource group to contain your Azure Spring Apps service. Create in instance of the Azure Spring Apps service.

   az group create --name <resource group name>
   az spring create -n <service instance name> -g <resource group name>
   

   Learn more about Azure Resource Groups.

5. Set your default resource group name and Spring Cloud service name using the following command:

   az config set defaults.group=<resource group name> defaults.spring-cloud=<service name>
   

Clean up resources

If you plan to continue working with subsequent quickstarts and tutorials, you might want to leave these resources in place. When no longer needed, delete the resource group, which deletes the resources in the resource group. To delete the resource group by using Azure CLI, use the following commands:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Next steps

Quickstart: Set up Azure Spring Apps Config Server