Quickstart: Spring Cloud-configuratieserver instellen voor Azure Spring Apps

Notitie

De Basic, Standarden Enterprise--plannen zijn op 17 maart 2025 buiten gebruik gesteld. Zie de aankondiging over buitengebruikstelling van Azure Spring Apps voor meer informatie.

Dit artikel is van toepassing op:✅ Basic/Standard ❎ Enterprise

Config Server is een gecentraliseerde configuratieservice voor gedistribueerde systemen. Hierin wordt een pluggable opslagplaatslaag gebruikt die momenteel ondersteuning biedt voor lokale opslag, Git en Subversion. In deze quickstart stelt u de configuratieserver in om gegevens op te halen uit een Git-opslagplaats.

Vereisten

• Voltooiing van de vorige quickstart in deze reeks: De Azure Spring Apps-service inrichten.
• Azure Spring Apps Config Server is alleen van toepassing op het Basic- of Standard-abonnement.

Configuratieserverprocedures

Stel uw configuratieserver in met de locatie van de Git-opslagplaats voor het project door de volgende opdracht uit te voeren. Vervang <service-instance-name> door de naam van de service die u eerder hebt gemaakt. De standaardwaarde voor de naam van het service-exemplaar die u in de voorgaande quickstart hebt ingesteld, werkt niet met deze opdracht.

az spring config-server git set \
    --name <service-instance-name> \
    --uri https://github.com/Azure-Samples/azure-spring-apps-samples \
    --search-paths steeltoe-sample/config

Met deze opdracht wordt Config Server geïnformeerd om de configuratiegegevens te vinden in de map steeltoe-sample/config van de opslagplaats van de voorbeeld-app. Omdat de naam van de app die de configuratiegegevens ophaalt planet-weather-provider is, wordt het bestand dat wordt gebruikt planet-weather-provider.yml.

Vereisten

• JDK 17
• Een Azure-abonnement. Als u geen abonnement hebt, maakt u een gratis account voordat u begint.
• Optioneel, Azure CLI versie 2.45.0 of hoger. Installeer de Azure Spring Apps-extensie met de volgende opdracht: az extension add --upgrade --name spring
• Optioneel, de Azure-toolkit voor IntelliJ.

Configuratieserverprocedures

Azure-portal

Met de volgende procedure stelt u de configuratieserver in met behulp van Azure Portal om het PetClinic-voorbeeld te implementeren.

1. Ga naar de pagina Overzicht van de service en selecteer Config Server.

2. Stel in de sectie Standaardopslagplaats de URI

3. Selecteer Valideren. Validatie controleert het schema en de toegankelijkheid van uw Git-opslagplaats om er zeker van te zijn dat deze juist is.

   

4. Wanneer de validatie is voltooid, selecteert u Toepassen om uw wijzigingen op te slaan.

   

Het bijwerken van de configuratie kan enkele minuten duren. U ontvangt een melding wanneer de configuratie is voltooid.

Azure-CLI

In de volgende procedure wordt de Azure CLI gebruikt om de configuratieserver in te stellen voor het implementeren van het pet clinic-voorbeeld.

Voer de volgende opdracht uit om de standaardopslagplaats in te stellen.

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

Tip

Zie Een beheerde Spring Cloud-configuratieserver configureren in Azure Spring Apps voor meer informatie over het gebruik van een privéopslagplaats voor de configuratieserver.

Problemen met azure Spring Apps Config Server oplossen

In de volgende procedure wordt uitgelegd hoe u problemen met de configuratieserverinstellingen oplost.

1. Ga in Azure Portal naar de servicepagina Overzicht en selecteer Logboeken.

2. Selecteer Uitvoeren in het deelvenster Query's onder Toon de toepassingslogboeken die de termen "fout" of "uitzondering" bevatten.

   

   De volgende fout in de logboeken geeft aan dat de Spring Apps-service geen eigenschappen van de configuratieserver kan vinden: java.lang.illegalStateException

3. Ga naar de servicepagina Overzicht.

4. Selecteer Diagnose en problemen oplossen.

5. Selecteer Onder Beschikbaarheid en Prestaties de optie Problemen oplossen.

   

   Azure Portal geeft de pagina Beschikbaarheid en prestaties weer, die verschillende informatie biedt over de status van de configuratieserver.

Hulpmiddelen opschonen

Als u van plan bent om verder te gaan met volgende snelle startgidsen en handleidingen, kunt u deze resources beter laten staan. Wanneer u deze niet meer nodig hebt, verwijdert u de resourcegroep, waarmee ook alle resources in die groep worden verwijderd. Als u de resourcegroep wilt verwijderen, voert u de volgende opdrachten in de Azure CLI in:

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

Volgende stappen

Quickstart: Apps bouwen en implementeren in Azure Spring Apps