Självstudie: Använda dynamisk konfiguration med push-uppdatering i en Java Spring-app

Det App Configuration Java Spring-klientbiblioteket stöder uppdatering av konfigurationen på begäran utan att göra så att ett program startas om. Ett program kan konfigureras för att identifiera ändringar i App Configuration med hjälp av en eller båda av följande två metoder.

• Avsökningsmodell: Det här är standardbeteendet som använder avsökning för att identifiera ändringar i konfigurationen. När det cachelagrade värdet för en inställning upphör att gälla skickar nästa anrop till 's en begäran till servern för att kontrollera om konfigurationen har ändrats och hämtar den uppdaterade konfigurationen om AppConfigurationRefresh refreshConfigurations det behövs.

• Push-modell: Här används App Configuration händelser för att identifiera ändringar i konfigurationen. När App Configuration har ställts in för att skicka ändringshändelser för nyckelvärden med Event Grid, med en webhhook, kan programmet använda dessa händelser för att optimera det totala antalet begäranden som behövs för att hålla konfigurationen uppdaterad.

Den här självstudien visar hur du kan implementera dynamiska konfigurationsuppdateringar i koden med hjälp av push-uppdatering. Den bygger på appen som introducerades i snabbstarterna. Innan du fortsätter slutför du Skapa en Java Spring-app med App Configuration först.

Du kan använda valfri kodredigerare för att göra stegen i den här självstudien. Visual Studio Code är ett utmärkt alternativ som är tillgängligt på Windows, macOS och Linux.

I den här guiden får du lära dig att:

Förutsättningar

• Azure-prenumeration – skapa en kostnadsfritt
• Ett Java Development Kit (JDK) med version 8 som stöds.
• Apache Maven version 3.0 eller senare.
• En befintlig Azure App Configuration Store.

Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.

Konfigurera push-uppdatering

1. Öppna pom.xml och uppdatera filen med följande beroenden.

           <dependency>
               <groupId>com.azure.spring</groupId>
               <artifactId>azure-spring-cloud-appconfiguration-config-web</artifactId>
               <version>2.0.0</version>
           </dependency>
   
           <!-- Adds the Ability to Push Refresh -->
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-starter-actuator</artifactId>
           </dependency>
   

2. Konfigurera Maven App Service Deployment så att programmet kan distribueras till Azure App Service via Maven.

   mvn com.microsoft.azure:azure-webapp-maven-plugin:1.12.0:config
   

3. Öppna bootstrap.properties och konfigurera Azure App Configuration Push Refresh och Azure Service Bus

   # Azure App Configuration Properties
   spring.cloud.azure.appconfiguration.stores[0].connection-string= ${AppConfigurationConnectionString}
   spring.cloud.azure.appconfiguration.stores[0].monitoring.enabled= true
   spring.cloud.azure.appconfiguration.stores[0].monitoring.cacheExpiration= 30d
   spring.cloud.azure.appconfiguration.stores[0].monitoring.triggers[0].key= sentinel
   spring.cloud.azure.appconfiguration.stores[0].monitoring.push-notification.primary-token.name= myToken
   spring.cloud.azure.appconfiguration.stores[0].monitoring.push-notification.primary-token.secret= myTokenSecret
   
   management.endpoints.web.exposure.include= "appconfiguration-refresh"
   

En slumpmässig fördröjning läggs till innan det cachelagrade värdet markeras som grovt för att minska potentiell begränsning. Standardvärdet för maximal fördröjning innan det cachelagrade värdet markeras som dirty är 30 sekunder.

Skapa och köra appen lokalt

Event Grid Web Hooks kräver validering när de skapas. Du kan verifiera genom att följa den här guiden eller genom att starta ditt program med Azure App Configuration Spring Web Library redan konfigurerat, vilket registrerar ditt program åt dig. Om du vill använda en händelseprenumeration följer du stegen i följande två avsnitt.

1. Ange miljövariabeln till App Configuration-instansens anslutningssträng:

   • Windows kommandotolk
   • PowerShell
   • Bash

   setx AppConfigurationConnectionString <connection-string-of-your-app-configuration-store>
   

2. Kör följande kommando för att skapa konsolappen:

    mvn package
   

3. När bygget har slutförts kör du följande kommando för att köra appen lokalt:

   mvn spring-boot:deploy
   

Konfigurera en händelseprenumeration

1. Öppna App Configuration resurs i Azure Portal och klicka sedan + Event Subscription på i Events fönstret.

   

2. Ange ett namn för Event Subscription och System Topic . Som standard anges de Key-Value och Key-Value borttagna händelsetyperna. Detta kan ändras tillsammans med fliken Filter för att välja de exakta orsakerna till att en push-händelse skickas.

   

3. Välj Endpoint Type som Web Hook , välj Select an endpoint .

   

4. Slutpunkten är URI:en för programmet + "/actuator/appconfiguration-refresh? {your-token-name}={your-token-secret}". Till exempel https://my-azure-webapp.azurewebsites.net/actuator/appconfiguration-refresh?myToken=myTokenSecret

5. Klicka på Create för att skapa händelseprenumerationen. När Create väljs skickas en registreringsbegäran för Web Hook till ditt program. Detta tas emot av Azure App Configuration klientbiblioteket, verifieras och returnerar ett giltigt svar.

6. Klicka på Event Subscriptions i fönstret för att verifiera att Events prenumerationen har skapats.

   

Verifiera och testa program

1. När programmet körs använder du curl för att testa programmet, till exempel:

   curl -X GET http://localhost:8080
   

2. Öppna Azure-portalen och gå till din App Configuration som är associerad med ditt program. Välj Configuration Explorer under Åtgärder och uppdatera värdena för följande nycklar:

   Tangent	Värde
   application/config.message	Hello – uppdaterad

3. Uppdatera webbläsarsidan för att se det nya meddelandet.

Rensa resurser

Om du inte vill fortsätta använda resurserna som skapats i den här artikeln tar du bort resurs gruppen som du skapade här för att undvika avgifter.

1. Logga in på Azure Portaloch välj resurs grupper.
2. I rutan Filtrera efter namn anger du namnet på din resurs grupp.
3. I listan resultat väljer du resurs gruppens namn för att se en översikt.
4. Välj Ta bort resursgrupp.
5. Du blir ombedd att bekräfta borttagningen av resursgruppen. Ange namnet på resurs gruppen som ska bekräftas och välj ta bort.

Efter en liten stund tas resurs gruppen och alla dess resurser bort.

Nästa steg

I den här självstudien har du aktiverat din Java-app för att dynamiskt uppdatera konfigurationsinställningarna från App Configuration. Om du vill lära dig hur du använder en hanterad Azure-identitet för att effektivisera åtkomsten App Configuration kan du fortsätta till nästa självstudie.