Rychlý start: Vytvoření aplikace Java Spring s Azure App Configuration

V tomto rychlém startu začleníte aplikaci Azure App Configuration Java Spring, abyste centralizovali úložiště a správu nastavení aplikace odděleně od kódu.

Požadavky

• Předplatné Azure – vytvořte si ho zdarma.
• Podporovaná sada Java Development Kit (JDK) verze 8.
• Apache Maven verze 3.0 nebo novější.

Vytvoření App Configuration úložiště

1. Pokud chcete vytvořit nové úložiště konfigurace aplikace, přihlaste se k Azure Portal. V levém horním rohu domovské stránky vyberte vytvořit prostředek. Do pole Hledat na Marketplace zadejte Konfigurace aplikace a vyberte ENTER.

   

2. Ve výsledcích hledání vyberte Konfigurace aplikace a pak vyberte vytvořit.

   

3. V podokně vytvořit konfiguraci aplikace zadejte následující nastavení:

   Nastavení	Navrhovaná hodnota	Popis
   Předplatné	Vaše předplatné	Vyberte předplatné Azure, které chcete použít k testování konfigurace aplikace. Pokud má váš účet jenom jedno předplatné, vybere se automaticky a seznam předplatných se nezobrazí.
   Skupina prostředků	AppConfigTestResources	Vyberte nebo vytvořte skupinu prostředků pro prostředek úložiště konfigurace aplikace. Tato skupina je užitečná k organizování více prostředků, které můžete chtít odstranit současně odstraněním skupiny prostředků. Další informace najdete v tématu použití skupin prostředků ke správě prostředků Azure.
   Název prostředku	Globálně jedinečný název	Zadejte jedinečný název prostředku, který se má použít pro prostředek úložiště konfigurace aplikace. Název musí být řetězec o 5 až 50 znaků a obsahovat pouze čísla, písmena a - znak. Název nesmí začínat ani končit - znakem.
   Umístění	USA – střed	Umístění použijte k určení geografického umístění, ve kterém je úložiště konfigurace aplikace hostované. Nejlepšího výkonu dosáhnete vytvořením prostředku ve stejné oblasti jako jiné součásti aplikace.
   Cenová úroveň	Free	Vyberte požadovanou cenovou úroveň. Další informace najdete na stránce s cenami konfigurace aplikací.

4. Vyberte zkontrolovat + vytvořit a ověřte nastavení.

5. Vyberte Vytvořit. Nasazení může trvat několik minut.

6. Po dokončení nasazení přejděte do prostředku konfigurace aplikace. Vyberte Nastavení > Přístupové klíče. Poznamenejte si primární připojovací řetězec klíče jen pro čtení. Pomocí tohoto připojovacího řetězce později nakonfigurujete aplikaci tak, aby komunikovala s úložištěm konfigurace aplikace, které jste vytvořili.

7. Vyberte Průzkumník konfigurace+ > Vytvořit > klíč-hodnota a přidejte následující páry klíč-hodnota:

   Klíč	Hodnota
   /application/config.message	Dobrý den

   Pole Label (Popisek) a Content Type (Typ obsahu) nechte v seznamu prázdné.

8. Vyberte Použít.

Vytvoření Spring Boot aplikace

Pomocí aplikace Spring Initializr vytvořte nový Spring Boot projektu.

1. Přejděte na adresu https://start.spring.io/.

2. Zadejte následující možnosti:

   • Vygenerujte projekt Maven v Javě.
   • Zadejte Spring Boot, která je rovna nebo větší než 2.0.
   • Zadejte názvy skupiny (Group) a artefaktu (Artifact) pro vaši aplikaci.
   • Přidejte závislost Spring Web.

3. Po zadání předchozích možností vyberte Vygenerovat Project. Po zobrazení výzvy stáhněte projekt na místní počítač.

Připojení do App Configuration úložiště

1. Po extrahování souborů v místním systému je Spring Boot aplikace připravená k úpravám. Vyhledejte pom.xml v kořenovém adresáři vaší aplikace.

2. Otevřete soubor pom.xml v textovém editoru a přidejte úvodní Spring Cloud Azure Config do seznamu <dependencies> :

   Spring Boot 2.4

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

   Poznámka

   Pokud potřebujete podporovat starší verzi nástroje , Spring Boot naši starou knihovnu.

3. V adresáři balíčku vaší aplikace vytvořte nový soubor Java s názvem MessageProperties.java. Přidejte následující řádky:

   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. V adresáři balíčku vaší aplikace vytvořte nový soubor Java HelloController.java. Přidejte následující řádky:

   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. Otevřete hlavní soubor Java aplikace a přidáním @EnableConfigurationProperties povolte tuto funkci.

   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. Vytvořte nový soubor s názvem v adresáři resources vaší aplikace a přidejte do souboru bootstrap.properties následující řádky. Nahraďte ukázkové hodnoty odpovídajícími vlastnostmi vašeho App Configuration úložiště.

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

7. Nastavte proměnnou prostředí APP_CONFIGURATION_CONNECTION_STRING a nastavte ji na přístupový klíč k vašemu App Configuration úložiště. Na příkazovém řádku spusťte následující příkaz a restartujte příkazový řádek, aby se změna mohla projeví:

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

   Pokud používáte Windows PowerShell, spusťte následující příkaz:

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

   Pokud používáte macOS nebo Linux, spusťte následující příkaz:

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

Místní sestavení a spuštění aplikace

1. Sestavte Spring Boot aplikaci pomocí Mavenu a spusťte ji, například:

   mvn clean package
   mvn spring-boot:run
   

2. Po spuštění aplikace otestujte pomocí nástroje curl aplikaci, například:

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

   Zobrazí se zpráva, kterou jste zadali v App Configuration Storu.

Vyčištění prostředků

Pokud nechcete dál používat prostředky vytvořené v tomto článku, odstraňte skupinu prostředků, kterou jste tady vytvořili, abyste předešli poplatkům.

1. Přihlaste se k Azure Portala vyberte skupiny prostředků.
2. Do pole filtrovat podle názvu zadejte název vaší skupiny prostředků.
3. V seznamu výsledků vyberte název skupiny prostředků, aby se zobrazil přehled.
4. Vyberte Odstranit skupinu prostředků.
5. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Zadejte název vaší skupiny prostředků, který chcete potvrdit, a vyberte Odstranit.

Po chvíli se odstraní skupina prostředků a všechny její prostředky.

Další kroky

V tomto rychlém startu jste vytvořili nový App Configuration Store a použili ho s aplikací Java Spring. Další informace najdete v tématu Spring v Azure. Informace o tom, jak aplikaci Java Spring povolit dynamicky aktualizovat nastavení konfigurace, najdete v dalším kurzu.