Create an Azure Spring Apps instance
An Azure Spring Apps cluster can be created by using either the Azure portal or the Azure CLI. In this first module, we'll configure the necessary tools, and create our first cluster.
Important
To avoid unnecessary charges in your Azure subscription, remember to deprovision your Azure resources when you finish this module.
Set up the Azure CLI
If it isn't already installed on your machine, install the Azure CLI. You can check the version of your current Azure CLI installation by running:
az --version
Ensure your Azure CLI is logged into your Azure subscription.
az login # Sign into an azure account
az account show # See the currently signed-in account.
Ensure that your default subscription is the one you intend to use for this lab. If not, set the subscription using:
az account set --subscription <SUBSCRIPTION_ID>
Install the spring extension for Azure CLI, by running:
az extension add -n spring -y
Congratulations, the Azure CLI is now ready to create your first cluster!
Create an Azure Spring Apps instance
In this section, we create our Azure Spring Apps instance using Azure CLI. It's possible to do exactly the same configuration using the Azure portal.
First, you need to come up with a name for your Azure Spring Apps instance.
- The name must be unique among all Azure Spring Apps instances across all of Azure. Consider using your username as part of the name.
- The name can contain only lowercase letters, numbers, and hyphens. The first character must be a letter. The last character must be a letter or number. The value must be between 4 and 32 characters long.
To limit typing, set the variable RESOURCE_GROUP_NAME to the name of the resource group created in the previous section. Set the variable SPRING_CLOUD_NAME to the name of the Azure Spring Apps instance to be created:
Note
Be sure to substitute your own values for RESOURCE_GROUP_NAME and SPRING_CLOUD_NAME as described above. SPRING_CLOUD_NAME must be globally unique.
RESOURCE_GROUP_NAME=spring-cloud-workshop
SPRING_CLOUD_NAME=azure-spring-cloud-workshop
With these variables set, you can now create your resource group. In the following script, the resource group is located in the eastus region (using the -l eastus argument), but you can choose a region closer to you for better performance (use az account list-locations to list all available regions):
az group create \
-g "$RESOURCE_GROUP_NAME" \
-l eastus
And then create the Azure Spring Apps instance:
az spring create \
-g "$RESOURCE_GROUP_NAME" \
-n "$SPRING_CLOUD_NAME" \
--sku standard
This command takes time to complete, you can continue reading while it completes.
For the remainder of this workshop, we'll run Azure CLI commands referencing the same resource group and Azure Spring Apps instance. So let's set them as defaults, so we don't have to specify them again:
az configure --defaults group=${RESOURCE_GROUP_NAME}
az configure --defaults spring=${SPRING_CLOUD_NAME}