Quickstart: Set up Spring Cloud Config Server for Azure Spring Apps
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
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.
- Completion of the previous quickstart in this series: Provision Azure Spring Apps service.
- Azure Spring Apps Config Server is only applicable to basic or standard tier.
Config Server procedures
Set up your Config Server with the location of the git repository for the project by running the following command. Replace <service instance name> with the name of the service you created earlier. The default value for service instance name that you set in the preceding quickstart doesn't work with this command.
az spring config-server git set -n <service instance name> --uri https://github.com/Azure-Samples/Azure-Spring-Cloud-Samples --search-paths steeltoe-sample/config
This command tells Config Server to find the configuration data in the steeltoe-sample/config folder of the sample app repository. Since the name of the app that will get the configuration data is
planet-weather-provider, the file that will be used is planet-weather-provider.yml.
- JDK 8 or JDK 11
- An Azure subscription. If you don't have a subscription, create a free account before you begin.
- Optionally, Azure CLI version 2.0.67 or higher. Install the Azure Spring Apps extension with the following command:
az extension add --name spring
- Optionally, the Azure Toolkit for IntelliJ.
Config Server procedures
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
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.
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:
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 ..."