Quickstart: Set up Spring Cloud Config Server for Azure Spring Apps

Article
10/25/2024

Note

The Basic, Standard, and Enterprise plans will be deprecated starting from mid-March, 2025, with a 3 year retirement period. We recommend transitioning to Azure Container Apps. For more information, see the Azure Spring Apps retirement announcement.

The Standard consumption and dedicated plan will be deprecated starting September 30, 2024, with a complete shutdown after six months. We recommend transitioning to Azure Container Apps.

Config Server is a centralized configuration service for distributed systems. It uses a pluggable repository layer that currently supports local storage, Git, and Subversion. In this quickstart, you set up the Config Server to get data from a Git repository.

Prerequisites

JDK 17
An Azure subscription. If you don't have a subscription, create a Trial before you begin.
Optionally, Azure CLI version 2.45.0 or higher. Install the Azure Spring Apps extension with the following command: az extension add --upgrade --name spring
Optionally, the Azure Toolkit for IntelliJ.

The following procedure sets up the Config Server using the Azure portal to deploy the PetClinic sample.

Go to the service Overview page and select Config Server.
In the Default repository section, set URI to https://github.com/azure-samples/spring-petclinic-microservices-config.
Select Validate. Validation checks the schema and accessibility of your git repo to make sure it's correct.
When validation is complete, select Apply to save your changes.

Updating the configuration can take a few minutes. You should get a notification when the configuration is complete.

The following procedure uses the Azure CLI to set up Config Server to deploy the Pet Clinic sample.

Run the following command to set the Default repository.

az spring config-server git set \
    --name <service-instance-name> \
    --uri https://github.com/azure-samples/spring-petclinic-microservices-config

Tip

For information on using a private repository for Config Server, see Configure a managed Spring Cloud Config Server in Azure Spring Apps.

Troubleshooting of Azure Spring Apps Config Server

The following procedure explains how to troubleshoot Config Server settings.

In the Azure portal, go to the service Overview page and select Logs.
In the Queries pane under Show the application logs that contain the "error" or "exception" terms, select Run.

The following error in the logs indicates that the Spring Apps service can't locate properties from Config Server: java.lang.illegalStateException
Go to the service Overview page.
Select Diagnose and solve problems.
Under Availability and Performance, select Troubleshoot.

Azure portal displays the Availability and Performance page, which provides various information about Config Server health status.

Clean up resources

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

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

Next steps

Quickstart: Build and deploy apps to Azure Spring Apps

Quickstart: Set up Spring Cloud Config Server for Azure Spring Apps

Prerequisites

Config Server procedures

Additional resources