Snabbstart: Skapa en Java Spring-app med Azure App Configuration

I den här snabbstarten införlivar du Azure App Configuration i en Java Spring-app för att centralisera lagring och hantering av programinställningar separat från din kod.

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.

Skapa en App Configuration butik

1. Om du vill skapa ett nytt konfigurations Arkiv för appen loggar du in på Azure Portal. I det övre vänstra hörnet på Start sidan väljer du skapa en resurs. I rutan Sök på Marketplace anger du app-konfiguration och väljer RETUR.

   

2. Välj app-konfiguration från Sök resultaten och välj sedan skapa.

   

3. I fönstret skapa app-konfiguration anger du följande inställningar:

   Inställning	Föreslaget värde	Beskrivning
   Prenumeration	Din prenumeration	Välj den Azure-prenumeration du vill använda för att testa App Configuration. Om ditt konto bara har en prenumeration väljs den automatiskt och ingen prenumerations lista visas.
   Resursgrupp	AppConfigTestResources	Välj eller skapa en resurs grupp för din app Configuration Store-resurs. Den här gruppen är användbar för att organisera flera resurser som du kanske vill ta bort samtidigt genom att ta bort resurs gruppen. Mer information finns i använda resurs grupper för att hantera dina Azure-resurser.
   Resurs namn	Globalt unikt namn	Ange ett unikt resurs namn som ska användas för appens konfigurations Arkiv resurs. Namnet måste vara en sträng mellan 5 och 50 tecken och får bara innehålla siffror, bokstäver och - tecknet. Namnet får inte börja eller sluta med - specialtecknet.
   Plats	USA, centrala	Använd Plats till att ange den geografiska plats där appkonfigurationsarkivets resurs finns. För bästa prestanda skapar du resursen i samma region som andra komponenter i ditt program.
   Prisnivå	Kostnadsfri	Välj önskad pris nivå. Mer information finns på sidan med prissättning för app-konfiguration.

4. Välj Granska + skapa för att validera inställningarna.

5. Välj Skapa. Distributionen kan ta några minuter.

6. När distributionen är klar går du till appen konfigurations resurs. Välj Inställningar > Åtkomstnycklar. Anteckna den primära skrivskyddade nyckel anslutnings strängen. Du kommer att använda den här anslutnings strängen senare för att konfigurera programmet för att kommunicera med det app-konfigurations lager som du har skapat.

7. Välj Configuration Explorer+ > Skapa > nyckelvärde för att lägga till följande nyckel/värde-par:

   Tangent	Värde
   /application/config.message	Hello

   Lämna Etikett och Innehållstyp tomma för tillfället.

8. Välj Använd.

Skapa en Spring Boot-app

Använd Spring Initializr för att skapa ett nytt Spring Boot projekt.

1. Gå till https://start.spring.io/.

2. Ange följande alternativ:

   • Generera ett Maven-projekt med Java.
   • Ange en Spring Boot version som är lika med eller större än 2.0.
   • Ange namnen för Group (Grupp) och Artifact (Artefakt) för ditt program.
   • Lägg till Spring Web-beroendet.

3. När du har angett föregående alternativ väljer du Generera Project. När du uppmanas laddar du ned projektet till en sökväg på den lokala datorn.

Anslut till en App Configuration butik

1. När du har extraherat filerna i det lokala systemet är ditt Spring Boot program redo för redigering. Leta upp filen pom.xml i appens rotkatalog.

2. Öppna filen pom.xml i ett redigeringsprogram och lägg till Spring Cloud Azure Config-starter i listan över <dependencies>:

   Spring Boot 2.4

   <dependency>
       <groupId>com.azure.spring</groupId>
       <artifactId>azure-spring-cloud-appconfiguration-config</artifactId>
       <version>2.0.0</version>
   </dependency>
   

   Anteckning

   Om du behöver stöd för en äldre version av Spring Boot se vårt gamla bibliotek.

3. Skapa en ny Java-fil med namnet MessageProperties.java i appens paketkatalog. Lägg till följande rader:

   package com.example.demo;
   
   import org.springframework.boot.context.properties.ConfigurationProperties;
   
   @ConfigurationProperties(prefix = "config")
   public class MessageProperties {
       private String message;
   
       public String getMessage() {
           return message;
       }
   
       public void setMessage(String message) {
           this.message = message;
       }
   }
   

4. Skapa en ny Java-fil med namnet HelloController.java i appens paketkatalog. Lägg till följande rader:

   package com.example.demo;
   
   import org.springframework.web.bind.annotation.GetMapping;
   import org.springframework.web.bind.annotation.RestController;
   
   @RestController
   public class HelloController {
       private final MessageProperties properties;
   
       public HelloController(MessageProperties properties) {
           this.properties = properties;
       }
   
       @GetMapping
       public String getMessage() {
           return "Message: " + properties.getMessage();
       }
   }
   

5. Öppna huvudprogrammets Java-fil och lägg till @EnableConfigurationProperties för att aktivera den här funktionen.

   import org.springframework.boot.context.properties.EnableConfigurationProperties;
   
   @SpringBootApplication
   @EnableConfigurationProperties(MessageProperties.class)
   public class DemoApplication {
       public static void main(String[] args) {
           SpringApplication.run(DemoApplication.class, args);
       }
   }
   

6. Skapa en ny fil bootstrap.properties med namnet under resurskatalogen i din app och lägg till följande rader i filen. Ersätt exempelvärdena med lämpliga egenskaper för ditt App Configuration store.

   spring.cloud.azure.appconfiguration.stores[0].connection-string= ${APP_CONFIGURATION_CONNECTION_STRING}
   

7. Ange en miljövariabel med APP_CONFIGURATION_CONNECTION_STRING och ställ in den på åtkomstnyckeln till App Configuration store. Kör följande kommando på kommandoraden och starta om kommandotolken så att ändringen börjar gälla:

   setx APP_CONFIGURATION_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
   

   Om du använder Windows PowerShell kör du följande kommando:

   $Env:APP_CONFIGURATION_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
   

   Om du använder macOS eller Linux kör du följande kommando:

   export APP_CONFIGURATION_CONNECTION_STRING='connection-string-of-your-app-configuration-store'
   

Skapa och köra appen lokalt

1. Skapa ditt Spring Boot med Maven och kör det, till exempel:

   mvn clean package
   mvn spring-boot:run
   

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

   curl -X GET http://localhost:8080/
   

   Du ser meddelandet som du angav i App Configuration Store.

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 snabbstarten har du skapat en App Configuration store och använt den med en Java Spring-app. Mer information finns i Spring på Azure. Fortsätt till nästa självstudie om du vill lära dig hur du aktiverar din Java Spring-app för att dynamiskt uppdatera konfigurationsinställningarna.