Quickstart: Spring Cloud-configuratieserver instellen voor Azure Spring Apps

Notitie

De Basic-, Standard- en Enterprise-abonnementen worden afgeschaft vanaf medio maart 2025, met een pensioenperiode van 3 jaar. We raden u aan om over te stappen naar Azure Container Apps. Zie de aankondiging over buitengebruikstelling van Azure Spring Apps voor meer informatie.

Het standaardverbruik en het speciale abonnement worden vanaf 30 september 2024 afgeschaft, met een volledige afsluiting na zes maanden. We raden u aan om over te stappen naar Azure Container Apps. Zie Azure Spring Apps Standard-verbruik en toegewezen abonnement migreren naar Azure Container 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 planet-weather-providerophaalt, is 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 in op https://github.com/azure-samples/spring-petclinic-microservices-config.

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 De toepassingslogboeken weergeven 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 Problemen vaststellen en 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.

Resources opschonen

Als u van plan bent om verder te gaan met volgende snelstarts en zelfstudies, kunt u deze resources het beste intact laten. Wanneer u deze niet meer nodig hebt, verwijdert u de resourcegroep, waarmee de resources in de resourcegroep 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